Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Aktiviraj način JSON

Lekcija 4 od 12 Posodobljeno 3. november 2026 Razvijalec
Na tej strani
  1. Kako deluje način JSON
  2. Aktivacija v Pythonu
  3. Aktivacija v TypeScriptu
  4. Izrecna navodila niso opcijska
  5. Premik navodil za obliko v sistemski poziv
  6. Razčlenjevanje odgovora
  7. Ključne ugotovitve

Posodobljeno 3. novembra 2026: Primeri TypeScript so prej uvažali Mistral kot privzeti izvoz (import Mistral from …), vendar SDK ponuja le imenovani izvoz: import { Mistral } from "@mistralai/mistralai". Prav tako so neposredno posredovali vsebino tipa string | ContentChunk[] funkciji JSON.parse in trdo kodirali ključ API v izvorno kodo. Preverjeno s kompilacijo z SDK 3.5.0 in TypeScript 7.0.2. Vir: Mistral TypeScript SDK.

Kako deluje način JSON

Način JSON je najpreprostejši mehanizem za pridobivanje strukturiranih izhodov od Mistrala. Z aktivacijo enega samega parametra zagotoviš, da bo odgovor modela veljaven JSON. Ni treba definirati sheme ali pisati podatkovnega modela – ob vsakem klicu dobiš le sintaktično pravilen JSON.

Aktivacija v Pythonu

To omogočiš s parametrom response_format v metodi client.chat.complete(). Upoštevaj, da mora sam poziv (prompt) opisati pričakovano strukturo – zakaj to ni opcijsko, bomo razložili kmalu.

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)

Izhod bo veljaven JSON, pripravljen za takojšnjo uporabo:

{
  "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."
    }
  ]
}

Aktivacija v TypeScriptu

SDK za TypeScript sledi popolnoma isti logiki, le poimenovanja so v camelCase: parameter se imenuje responseFormat, za razčlenjevanje pa uporabiš JSON.parse(). Velja en dodaten previdnostni ukrep: SDK tipizira content kot string | ContentChunk[], zato bo JSON.parse sprejel vrednost šele, ko preveriš, da je dejansko niz.

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);

Izrecna navodila niso opcijska

Tu je točka, ki jo mnogi razvijalci spregledajo in ki je vzrok za večino razočaranj nad načinom JSON: aktivacija parametra ni dovolj. Način zagotavlja sintakso, ne vsebine. Modelu moraš izrecno ukazati znotraj poziva (prompt), kakšno obliko pričakuješ.

Primerjaj naslednja dva klica. Pri prvem ni podanih nobenih strukturnih napotkov: model bo sicer ustvaril JSON, vendar se bodo ključi, njihova imena in gnezdenje spreminjali od klica do klica, kar tvoji nadaljnji kodi ne pušča stabilnih sidrišč.

# Slaba praksa — v pozivu ni navodil za JSON
response = client.chat.complete(
    model="mistral-large-latest",
    messages=[
        {"role": "user", "content": "What are the advantages of cloud?"}
    ],
    response_format={"type": "json_object"}
)
# Model bo ustvaril JSON, vendar bo struktura nepredvidljiva

Pri drugem primeru je strukturni okvir vstavljen neposredno v poziv. Model ima zdaj cilj, ki ga mora posnemati, kar naredi izhod predvidljiv med različnimi klici.

# Dobra praksa — jasno navodilo v pozivu
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"}
)

Vključitev primera strukture v tvoj poziv usmeri model k želeni obliki. To ni absolutno zagotovilo, kot ga nudijo prilagojeni strukturirani izhodi (Custom Structured Outputs), vendar je za večino primerov uporabe več kot dovolj.

Premik navodil za obliko v sistemski poziv

Ko se isto obdelovanje ponavlja čez na stotine vhodov, postane puščanje navodil za obliko v uporabniškem sporočilu neobvladljivo: kopiraš jih ob vsakem klicu in mešajo se z vsebino, ki jo je treba obdelati. Namesto tega jih premakni v sistemski poziv.

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"}
)

Ta ločitev – navodila za obliko nosi vloga system, vsebino za obdelavo pa vloga user – tvojo kodo bistveno olajša vzdrževanje: sprememba oblike se zgodi le na enem mestu.

Razčlenjevanje odgovora

Zadnja navada, ki si jo moraš pridobiti: odgovor v načinu JSON je vedno niz JSON znotraj message.content, nikoli objekt. Razčlenjevanje je tvoja odgovornost v obeh jezikih.

import json

raw = response.choices[0].message.content
data = json.loads(raw)

# Dostop do podatkov
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 ugotovitve

  • Aktiviraj način JSON z response_format: {"type": "json_object"}
  • Uporabi client.chat.complete() (ne parse())
  • Modelu vedno navodi v pozivu pričakovano strukturo JSON
  • Odgovor je niz JSON – razčleni ga z json.loads() ali JSON.parse()
  • Navodila za obliko za ponavljajoče se cevovode postavi v sistemski poziv