Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Cumasaigh an Mód JSON

Ceacht 4 as 12 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Conas a Oibríonn an Mód JSON
  2. É a Chumasú i bPython
  3. É a Chumasú i dTypeScript
  4. Níl Treoracha Sainráite Roghnach
  5. Treoracha Formáide a Bhogadh chuig an Leid Córais
  6. An Freagra a Pharsáil
  7. Príomhphointí

Nuashonraithe an 3 Samhain 2026: D’iompórtáil na samplaí TypeScript Mistral mar 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ál string | ContentChunk[] go díreach chuig JSON.parse freisin, 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