Cumasaigh an Mód JSON
Ar an leathanach seo
Nuashonraithe an 3 Samhain 2026: D’iompórtáil na samplaí TypeScript
Mistralmar easpórtáil réamhshocraithe (import Mistral from …) roimhe seo, ach ní thugann an SDK ach easpórtáil ainmnithe:import { Mistral } from "@mistralai/mistralai". Chuir siad ábhar de chineálstring | ContentChunk[]go díreach chuigJSON.parsefreisin, agus chruinnigh siad an eochair API sa chód foinseach. Fíoraithe trí thiomsú le SDK 3.5.0 agus TypeScript 7.0.2. Foinse: Mistral TypeScript SDK.
Conas a Oibríonn an Mód JSON
Is é an Mód JSON an mheicníocht is simplí chun aschur struchtúrtha a fháil ó Mistral. Trí pharaiméadar amháin a chumasú, ráthaíonn tú go mbeidh freagra an mhúnla ina JSON bailí. Níl aon scéma le sainiú, gan aon mhúnla sonraí le scríobh—níl ann ach JSON atá ceart go sintacteach ar gach glao.
É a Chumasú i bPython
Cumasaíonn tú é seo tríd an bparaiméadar response_format sa mhodh client.chat.complete(). Tabhair faoi deara go gcaithfidh an leid féin cur síos a dhéanamh ar an struchtúr atá ag teastáil—mínímid cén fáth nach rogha é seo i gceart go luath.
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)
Beidh an t-aschur ina JSON bailí, réidh le húsáid mar atá sé:
{
"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."
}
]
}
É a Chumasú i dTypeScript
Leanann an SDK TypeScript an loighic chéanna go díreach, le hainmniú camelCase: is é responseFormat an paraiméadar, agus úsáideann an pharsáil JSON.parse(). Baineann réamhchúram amháin breise leis: déanann an SDK cineálú ar content mar string | ContentChunk[], mar sin ní ghlacfaidh JSON.parse leis an luach ach amháin tar éis duit a fhíorú gur teaghrán é go deimhin.
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);
Níl Treoracha Sainráite Roghnach
Seo an pointe a fhágann go leor forbróirí ar lár, agus is é an fáth leis an díomá is mó a bhaineann leis an Mód JSON: níl sé leor an paraiméadar a chumasú. Ráthaíonn an mód an chomhréir, ní an t-ábhar. Caithfidh tú treoir shainráite a thabhairt don mhúnla, laistigh den leid, faoin bhformáid a bhfuil súil agat léi.
Déan comparáid idir an dá ghlao seo a leanas. Sa chéad cheann, ní thugtar aon treoir struchtúrach: táirgeoidh an múnla JSON, ach athróidh na heochracha, a n-ainmneacha, agus a neadú ó ghlao go glao, rud nach bhfágfaidh aon phointí anchair chobhsaí ag do chód síos an sruth.
# Cleachtas dona — gan treoir JSON sa leid
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{"role": "user", "content": "What are the advantages of cloud?"}
],
response_format={"type": "json_object"}
)
# Táirgeoidh an múnla JSON, ach beidh an struchtúr dofheicthe
Sa dara ceann, cuirtear cnámharlach struchtúrach isteach go díreach sa leid. Tá sprioc ag an múnla anois le macasamhlú, rud a fhágann go bhfuil an t-aschur intuartha ar fud glaonna.
# Cleachtas maith — treoir shoiléir sa leid
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"}
)
Cuidíonn sampla struchtúir a chur san leid leat an múnla a threorú i dtreo na formáide atá ag teastáil. Ní ráthaíocht absalóideach é seo mar atá le hAschuir Struchtúrtha Saincheaptha, ach tá sé níos leor do chuid mhór cásanna úsáide.
Treoracha Formáide a Bhogadh chuig an Leid Córais
Nuair a dhéantar an próiseáil chéanna arís agus arís ar na céadta ionchuir, éiríonn sé dodhéanta na treoracha formáide a fhágáil sa teachtaireacht úsáideora: cóipeálann tú iad ar gach glao, agus meascann siad leis an ábhar atá le próiseáil. Bog iad chuig an leid córais ina ionad sin.
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"}
)
Déanann an deighilt seo—treoracha formáide á n-iompar ag an ról system, agus an t-ábhar le próiseáil á iompar ag an ról user—do chód i bhfad níos inchothabhála: tarlaíonn athrú ar an bhformáid in áit amháin amháin.
An Freagra a Pharsáil
Is é an nós deireanach le forbairt ná seo: is teaghrán JSON i gcónaí é freagra an Mhóid JSON laistigh de message.content, ní réad riamh. Is ortsa atá an pharsáil, sa dá theanga.
import json
raw = response.choices[0].message.content
data = json.loads(raw)
# Faigh rochtain ar na sonraí
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}`);
});
Príomhphointí
- Cumasaigh an Mód JSON le
response_format: {"type": "json_object"} - Úsáid
client.chat.complete()(níparse()) - Tabhair treoir i gcónaí don mhúnla sa leid faoin struchtúr JSON atá ag teastáil
- Is teaghrán JSON é an freagra—parsáil é le
json.loads()nóJSON.parse() - Cuir treoracha formáide sa leid córais le haghaidh píblínte athfhillteacha