Aktiviraj JSON način rada
Na ovoj stranici
Ažurirano 3. studenog 2026.: TypeScript primjeri su prethodno uvozili
Mistralkao zadani izvoz (import Mistral from …), no SDK nudi samo imenovani izvoz:import { Mistral } from "@mistralai/mistralai". Također su prosljeđivali sadržaj tipastring | ContentChunk[]izravno uJSON.parsei hardkodirali API ključ u izvornom kodu. Provjereno kompajliranjem s SDK 3.5.0 i TypeScript 7.0.2. Izvor: Mistral TypeScript SDK.
Kako funkcionira JSON način rada
JSON način rada najjednostavniji je mehanizam za dobivanje strukturiranog izlaza od Mistrala. Aktiviranjem jednog parametra jamčiš da će odgovor modela biti valjani JSON. Nema sheme za definiranje, nema podatkovnog modela za pisanje – samo sintaksno ispravan JSON pri svakom pozivu.
Aktiviranje u Pythonu
Ovo omogućuješ putem parametra response_format u metodi client.chat.complete(). Imaj na umu da sam upit (prompt) mora opisati očekivanu strukturu – uskoro ćemo objasniti zašto to nije opcionalno.
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)
Izlaz će biti valjani JSON, spreman za korištenje kakav jest:
{
"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."
}
]
}
Aktiviranje u TypeScriptu
TypeScript SDK slijedi potpuno istu logiku, s imenovanjem u camelCase stilu: parametar je responseFormat, a parsiranje koristi JSON.parse(). Vrijedi jedna dodatna mjera opreza: SDK tipizira content kao string | ContentChunk[], stoga će JSON.parse prihvatiti vrijednost tek nakon što provjeriš je li doista niz znakova (string).
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);
Eksplicitne upute nisu opcionalne
Evo točke koju mnogi programeri promaše, a koja je uzrok većini razočaranja JSON načinom rada: aktiviranje parametra nije dovoljno. Način rada jamči sintaksu, a ne sadržaj. Modelu moraš eksplicitno narediti, unutar upita (prompta), koji format očekuješ.
Usporedi sljedeća dva poziva. U prvom nema strukturnih smjernica: model će proizvesti JSON, ali će se ključevi, njihova imena i njihovo ugnježđivanje mijenjati od poziva do poziva, ostavljajući tvoj downstream kod bez stabilnih sidrišta.
# Loša praksa — nema JSON upute u promptu
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{"role": "user", "content": "What are the advantages of cloud?"}
],
response_format={"type": "json_object"}
)
# Model će proizvesti JSON, ali struktura će biti nepredvidiva
U drugom slučaju, strukturni kostur umetnut je izravno u upit. Model sada ima cilj koji treba oponašati, čineći izlaz predvidivim kroz različite pozive.
# Dobra praksa — jasna uputa u promptu
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"}
)
Uključivanje primjera strukture u tvoj upit usmjerava model prema željenom formatu. To nije apsolutno jamstvo kao kod prilagođenih strukturiranih izlaza (Custom Structured Outputs), ali je više nego dovoljno za većinu slučajeva uporabe.
Premještanje uputa o formatu u sistemski upit
Kada se ista obrada ponavlja kroz stotine ulaza, ostavljanje uputa o formatu u korisničkoj poruci postaje neupravljivo: kopiraš ih pri svakom pozivu i miješaju se sa sadržajem koji treba obraditi. Umjesto toga, premjesti ih u sistemski upit.
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"}
)
Ovo odvajanje – upute o formatu koje nosi uloga system, a sadržaj za obradu uloga user – čini tvoj kod znatno održivijim: promjena formata događa se samo na jednom mjestu.
Parsiranje odgovora
Još jedna navika koju trebaš usvojiti: odgovor JSON načina rada uvijek je JSON niz znakova (string) unutar message.content, nikada objekt. Parsiranje je tvoja odgovornost, u oba jezika.
import json
raw = response.choices[0].message.content
data = json.loads(raw)
# Pristup podacima
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 točke
- Aktiviraj JSON način rada s
response_format: {"type": "json_object"} - Koristi
client.chat.complete()(neparse()) - Uvijek uputi model u promptu o očekivanoj JSON strukturi
- Odgovor je JSON niz znakova – parsiraj ga s
json.loads()iliJSON.parse() - Za ponavljajuće pipeline-e stavi upute o formatu u sistemski upit