Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Aktivizēt JSON režīmu

Nodarbība 4 no 12 Atjaunota 2026. gada 3. novembris Programmētājs
Šajā lapā
  1. Kā darbojas JSON režīms
  2. Aktivizēšana Python valodā
  3. Aktivizēšana TypeScript valodā
  4. Skaidras instrukcijas nav izvēles iespēja
  5. Formāta instrukciju pārvietošana uz sistēmas uzdevumu
  6. Atbildes parsēšana
  7. Galvenās atziņas

Atjaunināts 2026. gada 3. novembrī: Iepriekš TypeScript piemēros Mistral tika 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 tipu string | ContentChunk[] tieši funkcijai JSON.parse un 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() (nevis parse())
  • Vienmēr norādi modelim uzdevumā sagaidāmo JSON struktūru
  • Atbilde ir JSON virkne — parsē to ar json.loads() vai JSON.parse()
  • Atkārtojamām darbplūsmām izvieto formāta instrukcijas sistēmas uzdevumā