Aktivácia režimu JSON
Na tejto strane
Aktualizované 3. novembra 2026: Príklady v TypeScripte predtým importovali
Mistralako predvolený export (import Mistral from …), ale SDK poskytuje iba pomenovaný export:import { Mistral } from "@mistralai/mistralai". Tiež odovzdávali obsah s typomstring | ContentChunk[]priamo doJSON.parsea natvrdo kódovali API kľúč v zdrojovom kóde. Overené kompiláciou s SDK 3.5.0 a TypeScript 7.0.2. Zdroj: Mistral TypeScript SDK.
Ako funguje režim JSON
Režim JSON je najjednoduchší mechanizmus na získanie štruktúrovaného výstupu od Mistralu. Aktiváciou jediného parametra zaručíš, že odpoveď modelu bude platný JSON. Žiadna schéma na definovanie, žiadny dátový model na napísanie – pri každom volaní dostaneš syntakticky správny JSON.
Aktivácia v Pythone
Tento režim aktivuješ pomocou parametra response_format v metóde client.chat.complete(). Všimni si, že samotný prompt musí opisovať očakávanú štruktúru – čoskoro vysvetlíme, prečo to nie je voliteľné.
from mistralai.client import Mistral
client = Mistral(api_key="your-api-key")
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{
"role": "user",
"content": "Opíš 3 hlavné výhody cloud computingu. Vrát výsledok ako JSON s kľúčom 'advantages' obsahujúcim zoznam objektov s 'title' a 'description'."
}
],
response_format={"type": "json_object"}
)
print(response.choices[0].message.content)
Výstup bude platný JSON, pripravený na okamžité použitie:
{
"advantages": [
{
"title": "Škálovateľnosť",
"description": "Dynamické prispôsobenie zdrojov podľa dopytu."
},
{
"title": "Zníženie nákladov",
"description": "Nie je potrebná investícia do fyzickej infraštruktúry."
},
{
"title": "Prístupnosť",
"description": "Prístup k službám odkiaľkoľvek."
}
]
}
Aktivácia v TypeScripte
TypeScript SDK postupuje presne podľa rovnakej logiky, s pomenovaním v camelCase: parameter sa volá responseFormat a parsovanie prebieha cez JSON.parse(). Platí jedno dodatočné opatrenie: SDK typuje content ako string | ContentChunk[], takže JSON.parse prijme hodnotu až po overení, že ide skutočne o reťazec.
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: "Vymenuj 3 populárne JavaScript frameworky v JSON s 'name' a '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);
Explicitné inštrukcie nie sú voliteľné
Tu je bod, ktorý mnohí vývojári prehliadnu a ktorý je príčinou väčšiny sklamaní z režimu JSON: aktivácia parametra nestačí. Režim zaručuje syntax, nie obsah. Musíš modelu explicitne zadať v prompte formát, ktorý očakávaš.
Porovnaj nasledujúce dve volania. V prvom nie je poskytnuté žiadne štrukturálne vedenie: model vygeneruje JSON, ale kľúče, ich názvy a vnorenie sa budú líšiť od volania k volaniu, čo tvojmu následnému kódu neposkytne žiadne stabilné ukotvenie.
# Zlá prax – žiadna inštrukcia pre JSON v prompte
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{"role": "user", "content": "Aké sú výhody cloudu?"}
],
response_format={"type": "json_object"}
)
# Model vygeneruje JSON, ale štruktúra bude nepredvídateľná
V druhom prípade je do promptu vložená štrukturálna kostra. Model teraz má cieľ, ktorý má napodobniť, čo robí výstup predvídateľným naprieč volaniami.
# Dobrá prax – jasná inštrukcia v prompte
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{
"role": "user",
"content": """Aké sú výhody cloud computingu?
Vráť svoju odpoveď v JSON s nasledujúcou štruktúrou:
{
"topic": "string",
"advantages": [
{"title": "string", "description": "string"}
]
}"""
}
],
response_format={"type": "json_object"}
)
Zahrnutie príkladu štruktúry do promptu nasmeruje model k požadovanému formátu. Nie je to absolútna záruka ako pri vlastných štruktúrovaných výstupoch (Custom Structured Outputs), ale pre väčšinu prípadov použitia je to viac než dostatočné.
Presun inštrukcií pre formát do systémového promptu
Akonáhle sa rovnaké spracovanie opakuje stovkykrát pri rôznych vstupoch, ponechanie inštrukcií pre formát v správe používateľa sa stáva neudržateľným: kopíruješ ich pri každom volaní a miešajú sa so spracovávaným obsahom. Namiesto toho ich presuň do systémového promptu.
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{
"role": "system",
"content": "Si asistent na extrakciu dát. Svoje odpovede VŽDY vraciaš v JSON s kľúčmi 'entities', 'confidence' a 'source'."
},
{
"role": "user",
"content": "Extrahuj informácie z tohto textu: 'Acme Corp, založená v roku 2019 v Lyone, zamestnáva 250 ľudí.'"
}
],
response_format={"type": "json_object"}
)
Toto oddelenie – inštrukcie pre formát nesie rola system a obsah na spracovanie rola user – výrazne zjednodušuje údržbu tvojho kódu: zmena formátu sa deje iba na jednom mieste.
Parsovanie odpovede
Posledný zvyk, ktorý si musíš osvojiť: odpoveď v režime JSON je vždy reťazec JSON vo vnútri message.content, nikdy nie objekt. Parsovanie je tvojou zodpovednosťou v oboch jazykoch.
import json
raw = response.choices[0].message.content
data = json.loads(raw)
# Prístup k dátam
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}`);
});
Kľúčové poznatky
- Aktivuj režim JSON pomocou
response_format: {"type": "json_object"} - Použi
client.chat.complete()(nieparse()) - Vždy inštruuj model v prompte ohľadom očakávanej štruktúry JSON
- Odpoveď je reťazec JSON – parsuj ho pomocou
json.loads()aleboJSON.parse() - Pre opakujúce sa pipeline umiestni inštrukcie pre formát do systémového promptu