Aktiviraj način JSON
Na tej strani
Posodobljeno 3. novembra 2026: Primeri TypeScript so prej uvažali
Mistralkot privzeti izvoz (import Mistral from …), vendar SDK ponuja le imenovani izvoz:import { Mistral } from "@mistralai/mistralai". Prav tako so neposredno posredovali vsebino tipastring | ContentChunk[]funkcijiJSON.parsein trdo kodirali ključ API v izvorno kodo. Preverjeno s kompilacijo z SDK 3.5.0 in TypeScript 7.0.2. Vir: Mistral TypeScript SDK.
Kako deluje način JSON
Način JSON je najpreprostejši mehanizem za pridobivanje strukturiranih izhodov od Mistrala. Z aktivacijo enega samega parametra zagotoviš, da bo odgovor modela veljaven JSON. Ni treba definirati sheme ali pisati podatkovnega modela – ob vsakem klicu dobiš le sintaktično pravilen JSON.
Aktivacija v Pythonu
To omogočiš s parametrom response_format v metodi client.chat.complete(). Upoštevaj, da mora sam poziv (prompt) opisati pričakovano strukturo – zakaj to ni opcijsko, bomo razložili kmalu.
from mistralai.client import Mistral
client = Mistral(api_key="your-api-key")
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{
"role": "user",
"content": "Describe the 3 main advantages of cloud computing. Return the result as JSON with a key 'advantages' containing a list of objects with 'title' and 'description'."
}
],
response_format={"type": "json_object"}
)
print(response.choices[0].message.content)
Izhod bo veljaven JSON, pripravljen za takojšnjo uporabo:
{
"advantages": [
{
"title": "Scalability",
"description": "Dynamic adjustment of resources based on demand."
},
{
"title": "Cost Reduction",
"description": "No investment in physical infrastructure required."
},
{
"title": "Accessibility",
"description": "Access services from anywhere."
}
]
}
Aktivacija v TypeScriptu
SDK za TypeScript sledi popolnoma isti logiki, le poimenovanja so v camelCase: parameter se imenuje responseFormat, za razčlenjevanje pa uporabiš JSON.parse(). Velja en dodaten previdnostni ukrep: SDK tipizira content kot string | ContentChunk[], zato bo JSON.parse sprejel vrednost šele, ko preveriš, da je dejansko niz.
import { Mistral } from "@mistralai/mistralai";
const client = new Mistral({ apiKey: process.env.MISTRAL_API_KEY });
const response = await client.chat.complete({
model: "mistral-large-latest",
messages: [
{
role: "user",
content: "List 3 popular JavaScript frameworks in JSON with 'name' and 'useCase'."
}
],
responseFormat: { type: "json_object" },
});
const contenu = response.choices[0]?.message?.content;
if (typeof contenu !== "string") {
throw new Error("Response does not contain JSON text.");
}
const data = JSON.parse(contenu);
console.log(data);
Izrecna navodila niso opcijska
Tu je točka, ki jo mnogi razvijalci spregledajo in ki je vzrok za večino razočaranj nad načinom JSON: aktivacija parametra ni dovolj. Način zagotavlja sintakso, ne vsebine. Modelu moraš izrecno ukazati znotraj poziva (prompt), kakšno obliko pričakuješ.
Primerjaj naslednja dva klica. Pri prvem ni podanih nobenih strukturnih napotkov: model bo sicer ustvaril JSON, vendar se bodo ključi, njihova imena in gnezdenje spreminjali od klica do klica, kar tvoji nadaljnji kodi ne pušča stabilnih sidrišč.
# Slaba praksa — v pozivu ni navodil za JSON
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{"role": "user", "content": "What are the advantages of cloud?"}
],
response_format={"type": "json_object"}
)
# Model bo ustvaril JSON, vendar bo struktura nepredvidljiva
Pri drugem primeru je strukturni okvir vstavljen neposredno v poziv. Model ima zdaj cilj, ki ga mora posnemati, kar naredi izhod predvidljiv med različnimi klici.
# Dobra praksa — jasno navodilo v pozivu
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{
"role": "user",
"content": """What are the advantages of cloud computing?
Return your answer in JSON with the following structure:
{
"topic": "string",
"advantages": [
{"title": "string", "description": "string"}
]
}"""
}
],
response_format={"type": "json_object"}
)
Vključitev primera strukture v tvoj poziv usmeri model k želeni obliki. To ni absolutno zagotovilo, kot ga nudijo prilagojeni strukturirani izhodi (Custom Structured Outputs), vendar je za večino primerov uporabe več kot dovolj.
Premik navodil za obliko v sistemski poziv
Ko se isto obdelovanje ponavlja čez na stotine vhodov, postane puščanje navodil za obliko v uporabniškem sporočilu neobvladljivo: kopiraš jih ob vsakem klicu in mešajo se z vsebino, ki jo je treba obdelati. Namesto tega jih premakni v sistemski poziv.
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{
"role": "system",
"content": "You are a data extraction assistant. You ALWAYS return your responses in JSON with the keys 'entities', 'confidence', and 'source'."
},
{
"role": "user",
"content": "Extract information from this text: 'Acme Corp, founded in 2019 in Lyon, employs 250 people.'"
}
],
response_format={"type": "json_object"}
)
Ta ločitev – navodila za obliko nosi vloga system, vsebino za obdelavo pa vloga user – tvojo kodo bistveno olajša vzdrževanje: sprememba oblike se zgodi le na enem mestu.
Razčlenjevanje odgovora
Zadnja navada, ki si jo moraš pridobiti: odgovor v načinu JSON je vedno niz JSON znotraj message.content, nikoli objekt. Razčlenjevanje je tvoja odgovornost v obeh jezikih.
import json
raw = response.choices[0].message.content
data = json.loads(raw)
# Dostop do podatkov
for advantage in data["advantages"]:
print(f"- {advantage['title']}: {advantage['description']}")
const contenu = response.choices[0]?.message?.content;
if (typeof contenu !== "string") {
throw new Error("Response does not contain JSON text.");
}
const data = JSON.parse(contenu);
data.advantages.forEach((adv: any) => {
console.log(`- ${adv.title}: ${adv.description}`);
});
Ključne ugotovitve
- Aktiviraj način JSON z
response_format: {"type": "json_object"} - Uporabi
client.chat.complete()(neparse()) - Modelu vedno navodi v pozivu pričakovano strukturo JSON
- Odgovor je niz JSON – razčleni ga z
json.loads()aliJSON.parse() - Navodila za obliko za ponavljajoče se cevovode postavi v sistemski poziv