Aktivizēt JSON režīmu
Šajā lapā
Atjaunināts 2026. gada 3. novembrī: Iepriekš TypeScript piemēros
Mistraltika importēts kā noklusējuma eksports (import Mistral from …), taču SDK piedāvā tikai nosauktu eksportu:import { Mistral } from "@mistralai/mistralai". Tie arī nodeva saturu ar tipustring | ContentChunk[]tieši funkcijaiJSON.parseun iekodēja API atslēgu avota kodā. Pārbaudīts, kompilējot ar SDK 3.5.0 un TypeScript 7.0.2. Avots: Mistral TypeScript SDK.
Kā darbojas JSON režīms
JSON režīms ir vienkāršākais mehānisms strukturētas izvades iegūšanai no Mistral. Aktivizējot vienu parametru, tu garantē, ka modeļa atbilde būs derīgs JSON. Nav jādefinē shēma, nav jāraksta datu modelis — katrā izsaukumā tiek ģenerēts tikai sintaktiski korekts JSON.
Aktivizēšana Python valodā
Tu to aktivizē, izmantojot parametru response_format metodē client.chat.complete(). Ņem vērā, ka pašam uzdevumam (prompt) ir jāapraksta sagaidāmā struktūra — drīz paskaidrosim, kāpēc tas nav izvēles iespēja.
from mistralai.client import Mistral
client = Mistral(api_key="your-api-key")
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{
"role": "user",
"content": "Apraksti 3 galvenās mākoņskaitļošanas priekšrocības. Atgriez rezultātu kā JSON ar atslēgu 'advantages', kas satur objektu sarakstu ar 'title' un 'description'."
}
],
response_format={"type": "json_object"}
)
print(response.choices[0].message.content)
Izvade būs derīgs JSON, ko vari izmantot tieši tādu, kāds tas ir:
{
"advantages": [
{
"title": "Mērogojamība",
"description": "Resursu dinamiska pielāgošana atkarībā no pieprasījuma."
},
{
"title": "Izmaksu samazināšana",
"description": "Nav nepieciešami ieguldījumi fiziskajā infrastruktūrā."
},
{
"title": "Pieejamība",
"description": "Pieeja pakalpojumiem no jebkuras vietas."
}
]
}
Aktivizēšana TypeScript valodā
TypeScript SDK seko tieši tai pašai loģikai, izmantojot camelCase nosaukumus: parametrs ir responseFormat, un parsēšanai tiek izmantota JSON.parse(). Ir jāievēro viens papildu piesardzības pasākums: SDK definē content tipu kā string | ContentChunk[], tāpēc JSON.parse pieņems vērtību tikai tad, ja esi pārliecinājies, ka tā patiešām ir virkne.
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: "Uzskaiti 3 populārus JavaScript ietvarus JSON formātā ar 'name' un '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);
Skaidras instrukcijas nav izvēles iespēja
Šeit ir punkts, ko daudzi izstrādātāji palaiž garām, un tas ir galvenais vilšanās iemesls, strādājot ar JSON režīmu: parametra aktivizēšana nav pietiekama. Režīms garantē sintaksi, nevis saturu. Tev ir skaidri jānorāda modelim uzdevumā (prompt), kādu formātu tu sagaidi.
Salīdzini šos divus izsaukumus. Pirmajā netiek sniegta nekāda strukturāla vadlīnija: modelis ģenerēs JSON, taču atslēgas, to nosaukumi un ligzdojums katrā izsaukumā būs atšķirīgi, atstājot tavu turpmāko kodu bez stabilām atskaites punktiem.
# Slikta prakse — nav JSON instrukcijas uzdevumā
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{"role": "user", "content": "Kādas ir mākoņskaitļošanas priekšrocības?"}
],
response_format={"type": "json_object"}
)
# Modelis ģenerēs JSON, bet struktūra būs neparedzama
Otrajā gadījumā strukturāls skelets tiek ievietots tieši uzdevumā. Tagad modelim ir mērķis, kam sekot, padarot izvadi paredzamu visos izsaukumos.
# Laba prakse — skaidra instrukcija uzdevumā
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{
"role": "user",
"content": """Kādas ir mākoņskaitļošanas priekšrocības?
Atgriez savu atbildi JSON formātā ar šādu struktūru:
{
"topic": "string",
"advantages": [
{"title": "string", "description": "string"}
]
}"""
}
],
response_format={"type": "json_object"}
)
Struktūras piemēra iekļaušana uzdevumā virza modeli uz vēlamo formātu. Tas nav absolūts garantijas mehānisms, kā pielāgotas strukturētas izvades (Custom Structured Outputs), taču vairumam lietojumu gadījumu tas ir vairāk nekā pietiekami.
Formāta instrukciju pārvietošana uz sistēmas uzdevumu
Kad viena un tā pati apstrāde tiek atkārtota simtiem reižu dažādām ievadēm, formāta instrukciju atstāšana lietotāja ziņojumā kļūst nepārvaldāma: tu tās kopē katrā izsaukumā, un tās sajaucas ar apstrādājamo saturu. Tā vietā pārvieto tās uz sistēmas uzdevumu (system prompt).
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{
"role": "system",
"content": "Tu esi datu ieguves asistents. Tu VIENMĒR atgriez savas atbildes JSON formātā ar atslēgām 'entities', 'confidence' un 'source'."
},
{
"role": "user",
"content": "Iegūsti informāciju no šī teksta: 'Acme Corp, dibināta 2019. gadā Lionā, nodarbina 250 darbiniekus.'"
}
],
response_format={"type": "json_object"}
)
Šī nodalīšana — kur formāta instrukcijas nes system loma, bet apstrādājamo saturu nes user loma — padara tavu kodu ievērojami vieglāk uzturamu: formāta maiņa notiek tikai vienā vietā.
Atbildes parsēšana
Viens pēdējais ieradums, ko izveidot: JSON režīma atbilde vienmēr ir JSON virkne laukā message.content, nevis objekts. Parsēšana ir tava atbildība abās valodās.
import json
raw = response.choices[0].message.content
data = json.loads(raw)
# Pieeja datiem
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}`);
});
Galvenās atziņas
- Aktivizē JSON režīmu ar
response_format: {"type": "json_object"} - Izmanto
client.chat.complete()(nevisparse()) - Vienmēr norādi modelim uzdevumā sagaidāmo JSON struktūru
- Atbilde ir JSON virkne — parsē to ar
json.loads()vaiJSON.parse() - Atkārtojamām darbplūsmām izvieto formāta instrukcijas sistēmas uzdevumā