Attiva l-Modalità JSON
F'din il-paġna
Aġġornat fit-3 ta’ Novembru, 2026: L-eżempji TypeScript qabel kienu jimportaw
Mistralbħ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ħalastring | ContentChunk[]direttament lilJSON.parseu 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()(mhuxparse()) - Dejjem istruwixxi lill-mudell fil-prompt dwar l-istruttura JSON mistennija
- Ir-risposta hija stringa JSON—ipparshaha b’
json.loads()jewJSON.parse() - Poġġi l-istruzzjonijiet tal-format fil-prompt tas-sistema għal pipelines ripetittivi