Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Attiva l-Modalità JSON

Lezzjoni 4 / 12 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Kif Taħdem il-Modalità JSON
  2. Kif Tattivaha f’Python
  3. Kif Tattivaha f’TypeScript
  4. Istruzzjonijiet Espliċiti Mhumiex Għażla
  5. Spostar tal-Istruzzjonijiet tal-Format fil-Prompt tas-Sistema
  6. Parsing tar-Risposta
  7. Punti Ewlenin

Aġġornat fit-3 ta’ Novembru, 2026: L-eżempji TypeScript qabel kienu jimportaw Mistral bħala esportazzjoni default (import Mistral from …), iżda l-SDK jipprovdi biss esportazzjoni msemmija: import { Mistral } from "@mistralai/mistralai". Huma wkoll għaddew kontenut ittipjat bħala string | ContentChunk[] direttament lil JSON.parse u hardkodjaw iċ-ċavetta tal-API fil-kodiċi sors. Verifikat permezz ta’ kompilazzjoni mal-SDK 3.5.0 u TypeScript 7.0.2. Sors: Mistral TypeScript SDK.

Kif Taħdem il-Modalità JSON

Il-Modalità JSON hija l-aktar mekkaniżmu sempliċi biex tikseb output strutturat mingħand Mistral. Billi tattiva parametru wieħed, tiggarantixxi li r-risposta tal-mudell tkun JSON validu. L-ebda skema biex tiddefinixxi, l-ebda mudell tad-data biex tikteb—biss JSON sintattikament korrett f’kull sejħa.

Kif Tattivaha f’Python

Tattiva dan permezz tal-parametru response_format fil-metodu client.chat.complete(). Innota li l-prompt innifsu għandu jiddeskrivi l-istruttura mistennija—se nispjegaw għaliex dan mhuwiex għażlija ftit wara.

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)

L-output ikun JSON validu, lest biex tużah hekk kif inhu:

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

Kif Tattivaha f’TypeScript

L-SDK TypeScript isegwi l-istess loġika eżatta, b’semijiet f’camelCase: il-parametru huwa responseFormat, u l-parsing juża JSON.parse(). Tapplika prekawzjoni waħda addizzjonali: l-SDK jittipja content bħala string | ContentChunk[], allura JSON.parse se jaċċetta l-valur biss wara li tivverifika li huwa tassew stringa.

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

Istruzzjonijiet Espliċiti Mhumiex Għażla

Hawnhekk hemm il-punt li ħafna żviluppatori jitilfu, u r-raġuni għall-biċċa l-kbira tad-diżappunt mal-Modalità JSON: l-attivazzjoni tal-parametru mhix biżżejjed. Il-modalità tiggarantixxi s-sintassi, mhux il-kontenut. Trid tistruwixxi espliċitament lill-mudell, fil-prompt, dwar il-format li tistenna.

Qabbel iż-żewġ sejħiet li ġejjin. Fl-ewwel waħda, ma tingħata l-ebda gwida strutturali: il-mudell se jipproduċi JSON, iżda ċ-ċwievet, l-ismijiet tagħhom, u n-nesting tagħhom se jvarjaw minn sejħa għal oħra, u jħallu l-kodiċi downstream tiegħek mingħajr l-ebda punt ta’ ankraġġ stabbli.

# Prattika ħażina — l-ebda istruzzjoni JSON fil-prompt
response = client.chat.complete(
    model="mistral-large-latest",
    messages=[
        {"role": "user", "content": "What are the advantages of cloud?"}
    ],
    response_format={"type": "json_object"}
)
# Il-mudell se jipproduċi JSON, iżda l-istruttura tkun imprevedibbli

Fit-tieni waħda, qafas strutturali jiġi inserit direttament fil-prompt. Il-mudell issa għandu mira biex jimita, u jagħmel l-output prevedibbli bejn is-sejħiet.

# Prattika tajba — istruzzjoni ċara fil-prompt
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"}
)

Li tinkludi eżempju ta’ struttura fil-prompt tiegħek jiggwida lill-mudell lejn il-format mixtieq. Din mhix garanzija assoluta bħall-Outputs Strutturati Personalizzati (Custom Structured Outputs), iżda hija aktar minn biżżejjed għall-biċċa l-kbira tal-każijiet ta’ użu.

Spostar tal-Istruzzjonijiet tal-Format fil-Prompt tas-Sistema

Ladarba l-istess ipproċessar jirrepeti ruħu fuq mijiet ta’ inputs, li tħalli l-istruzzjonijiet tal-format fil-messaġġ tal-utent isir impossibbli li timmaniġġjah: tkopjahom f’kull sejħa, u jitħalltu mal-kontenut li għandu jiġi pproċessat. Minflok, ixprunahom lejn il-prompt tas-sistema.

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

Din is-separazzjoni—istruzzjonijiet tal-format miġbura mir-rwol system, u kontenut li għandu jiġi pproċessat miġbur mir-rwol user—tagħmel il-kodiċi tiegħek ferm aktar faċli biex tinżamm: il-bidla tal-format iseħħ f’post wieħed biss.

Parsing tar-Risposta

Abitudni finali waħda li għandek tibni: ir-risposta tal-Modalità JSON hija dejjem stringa JSON ġewwa message.content, qatt mhux oġġett. Il-parsing hija r-responsabbiltà tiegħek, fiż-żewġ lingwi.

import json

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

# Aċċessa d-data
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}`);
});

Punti Ewlenin

  • Attiva l-Modalità JSON b’response_format: {"type": "json_object"}
  • Uża client.chat.complete() (mhux parse())
  • Dejjem istruwixxi lill-mudell fil-prompt dwar l-istruttura JSON mistennija
  • Ir-risposta hija stringa JSON—ipparshaha b’json.loads() jew JSON.parse()
  • Poġġi l-istruzzjonijiet tal-format fil-prompt tas-sistema għal pipelines ripetittivi