JSON-režiimi lubamine
Sellel lehel
Uuendatud 3. novembril 2026: Varasemad TypeScripti näited importisid
Mistrali vaikimisi ekspordina (import Mistral from …), kuid SDK pakub ainult nimelist eksporti:import { Mistral } from "@mistralai/mistralai". Samuti antistring | ContentChunk[]tüübiga sisu otse funktsioonileJSON.parseja API võti oli lähtekoodis kodeeritud. Kontrollitud kompilatsiooniga, kasutades SDK versiooni 3.5.0 ja TypeScripti versiooni 7.0.2. Allikas: Mistral TypeScript SDK.
Kuidas JSON-režiim töötab
JSON-režiim on lihtsaim viis Mistralilt struktureeritud väljundi saamiseks. Ühe parameetri lubamisega tagad, et mudeli vastus on kehtiv JSON. Pole vaja skeemi defineerida ega andmemudelit kirjutada – iga päringu tulemuseks on süntaktiliselt korrektne JSON.
Lubamine Pythonis
Selle lubamiseks kasuta parameetrit response_format meetodis client.chat.complete(). Pane tähele, et viip ise peab kirjeldama oodatavat struktuuri – selgitame varsti, miks see pole valikuline.
from mistralai.client import Mistral
client = Mistral(api_key="your-api-key")
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{
"role": "user",
"content": "Kirjelda pilvandmetöötluse 3 peamist eelist. Tagasta tulemus JSON-formaadis võtmega 'advantages', mis sisaldab objektide loendit võtmetega 'title' ja 'description'."
}
],
response_format={"type": "json_object"}
)
print(response.choices[0].message.content)
Väljund on kehtiv JSON, mida saab kohe kasutada:
{
"advantages": [
{
"title": "Skaleeritavus",
"description": "Ressursside dünaamiline kohandamine vastavalt nõudlusele."
},
{
"title": "Kulude vähendamine",
"description": "Füüsilisse taristusse investeerimine pole vajalik."
},
{
"title": "Ligipääsetavus",
"description": "Teenustele ligipääs ükskõik kust."
}
]
}
Lubamine TypeScriptis
TypeScripti SDK järgib täpselt sama loogikat, kasutades camelCase’i: parameeter on responseFormat ja parsimiseks kasutatakse JSON.parse(). Kehtib üks lisiettevaatusabinõu: SDK tüübib content kui string | ContentChunk[], seega aktsepteerib JSON.parse väärtust alles pärast seda, kui oled veendunud, et tegemist on tõepoolest stringiga.
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: "Loetle 3 populaarset JavaScripti raamistikku JSON-formaadis võtmetega 'name' ja '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);
Sõnaselged juhised pole valikulised
Siin on punkt, mille paljud arendajad mööda lasevad ja mis on peamine põhjus JSON-režiimi pettumuseks: ainult parameetri lubamisest ei piisa. Režiim garanteerib süntaksi, mitte sisu. Sa pead mudelit viiba sees sõnaselgelt juhendama, millist formaati ootad.
Võrdle kahte järgmist päringut. Esimeses puudub struktuurne juhend: mudel toodab küll JSON-i, kuid võtmed, nende nimed ja pesastatus varieeruvad päringuti, jättes sinu järgnevale koodile stabiilsed ankrupunktideta.
# Halb tava – viibas puudub JSON-i juhend
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{"role": "user", "content": "Millised on pilvandmetöötluse eelised?"}
],
response_format={"type": "json_object"}
)
# Mudel toodab JSON-i, kuid struktuur on ettearvamatu
Teises lisatakse struktuurne skeem otse viiba. Mudelil on nüüd sihtmärk, mida jäljendada, muutes väljundi päringute lõikes ennustatavaks.
# Hea tava – selge juhend viibas
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{
"role": "user",
"content": """Millised on pilvandmetöötluse eelised?
Tagasta vastus JSON-formaadis järgmise struktuuriga:
{
"topic": "string",
"advantages": [
{"title": "string", "description": "string"}
]
}"""
}
],
response_format={"type": "json_object"}
)
Struktuuri näite lisamine viiba suunab mudeli soovitud formaadi poole. See pole absoluutne garantii nagu kohandatud struktureeritud väljundite puhul, kuid enamiku kasutusjuhtude jaoks on see enam kui piisav.
Formaadi juhiste viimine süsteemiviiba
Kui sama töötlemine kordub sadade sisendite lõikes, muutub formaadi juhiste jätmine kasutaja sõnumisse hallamatuks: kopeerid need iga päringu jaoks ja need segunevad töödeldava sisuga. Viia need selle asemel süsteemiviiba.
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{
"role": "system",
"content": "Oled andmete ekstraheerimise assistent. Sa TAGASTAD alati oma vastused JSON-formaadis võtmetega 'entities', 'confidence' ja 'source'."
},
{
"role": "user",
"content": "Ekstraheeri teave sellest tekstist: 'Acme Corp, asutatud 2019. aastal Lyonis, töötab 250 inimest.'"
}
],
response_format={"type": "json_object"}
)
See eraldatus – formaadi juhised kannab roll system ja töödeldav sisu roll user – muudab sinu koodi oluliselt hooldatavamaks: formaadi muutmine toimub ainult ühes kohas.
Vastuse parsimine
Viimane harjumus, mida kujundada: JSON-režiimi vastus on alati JSON-string väljal message.content, mitte kunagi objekt. Parsimine on sinu vastutada mõlemas keeles.
import json
raw = response.choices[0].message.content
data = json.loads(raw)
# Andmete kasutamine
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}`);
});
Peamised punktid
- Luba JSON-režiim parameetriga
response_format: {"type": "json_object"} - Kasuta
client.chat.complete()(mitteparse()) - Alati juhenda mudelit viibas oodatava JSON-struktuuri osas
- Vastus on JSON-string – parsi see
json.loads()võiJSON.parse()abil - Paiguta formaadi juhised süsteemiviiba korduvate töövoogude jaoks