Réasúnaíocht in oibreáin agus i gcomhráite
Ar an leathanach seo
Cúrsa athscríofa an 2 Samhain 2026 do Mistral Small 4 agus Large 4. Deir doiciméadú Mistral go bhfuil
reasoning_effortar fáil ar na pointí deiridh Agents agus Conversations laistigh den réimsecompletion_args. Foinse: Reasoning · Python SDK — Conversations.
Trí bhealach chun samhlacha réasúnaíochta a ghlaofh
D’úsáid na ceachtanna roimhe seo an Chat Completions API: sheol tú an stair iomlán le gach glao, agus chuaigh reasoning_effort go díreach isteach san iarratas. Tairgeann Mistral dhá chomhéadan eile: an Agents API, a shábhálann cumraíocht in-athúsáidte (samhail, treoracha, uirlisí, paraiméadair), agus an Conversations API, a choinníonn an stair ar an bhfreastalaí. Sna dhá API seo, ní shocraíonn tú an réasúnaíocht ag an leibhéal barr; neadaíonn tú í laistigh de completion_args in éineacht le paraiméadair ghiniúna eile.
Oibreán a dhéanann réasúnaíocht
Trí leibhéal na réasúnaíochta a shocrú sa sainmhíniú oibreáin, seachnaíonn tú é a athrá ar gach glao agus cinntíonn tú go n-úsáideann do fhoireann iomlán an socrú céanna:
import os
from mistralai.client import Mistral
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
agent = client.beta.agents.create(
model="mistral-small-2603",
name="Financial Analyst",
instructions=(
"You analyze financial situations for SMEs. "
"End every response with a quantified recommendation and its assumptions."
),
completion_args={"reasoning_effort": "high"},
)
reponse = client.beta.conversations.start(
agent_id=agent.id,
inputs="Our working capital requirement has doubled in a year while revenue grew by 15%. What should we look at first?",
)
Aschuir comhráite a léamh
Ní thugann comhrá choices ar ais; tugann sé liosta iontrálacha (outputs) ar ais. Tá freagra na samhla le fáil in iontrálacha den chineál message.output. Mar atá le Chat Completions, is sreangán nó liosta smutání é an t-ábhar a d’fhéadfadh ThinkChunk a bheith ann. Feidhmíonn an fheidhm separer ó Cheacht 3 díreach mar a rinne sí roimhe:
for entry in reponse.outputs:
if entry.type == "message.output":
reflexion, texte = separer(entry.content)
print(texte)
Déanann iontrálacha eile cur síos ar an méid a tharla le linn an chasaidh, mar shampla feidhmiú uirlise (tool.execution) nó glao feidhme. Déan neamhaird orthu mura bhfuil suim agat ach sa fhreagra deiridh.
Comhrá gan oibreán
Do thascanna aonuaire, glacann an Conversations API le samhail go díreach, gan aon shocrú oibreáin roimh ré. Coinníonn an freastalaí an stair, agus leanann tú an malartú ar aghaidh le conversations.append, ag coigeartú leibhéal na réasúnaíochta do chasadh sonrach más gá:
conv = client.beta.conversations.start(
model="mistral-large-4-0",
inputs="Propose a migration plan for a 2 TB PostgreSQL database with zero downtime.",
completion_args={"reasoning_effort": "high"},
)
suite = client.beta.conversations.append(
conversation_id=conv.conversation_id,
inputs="Summarize this plan in five steps for executive leadership.",
completion_args={"reasoning_effort": "low"}, # a summary doesn't need deep reflection
)
Is buntáiste praiticiúil é seo ar Chat Completions, áit a n-éilíonn an doiciméadú ort teachtaireacht iomlán an chúntóra, an mheabhrú san áireamh, a athsheinm ar gach casadh nua (Ceacht 7). Leis an Conversations API, coinneoidh an freastalaí an stair; ní sheolann tú ar ais í ar gach glao.
Réasúnaíocht agus uirlisí
Is féidir le hoibreán réasúnaíocht agus uirlisí a chomhcheangal: is réimsí neamhspleácha iad tools agus completion_args agus oibreán á chruthú. Mar sin, is féidir le hoibreán anailíse cuardach gréasáin agus réasúnaíocht dhomhain a bheith aige:
agent_veille = client.beta.agents.create(
model="mistral-small-2603",
name="Competitive Intelligence",
instructions="You compare competitor offers using cited public sources.",
tools=[{"type": "web_search"}],
completion_args={"reasoning_effort": "high"},
)
Bí airdeallach ar an gcostas, áfach: cuirtear meabhrú agus glaonna uirlisí le chéile sa bhille do chasadh amháin.
Comparáid idir na trí chur chuige
| Critéar | Chat Completions | Agents | Conversations |
|---|---|---|---|
| Cá háit an réasúnaíocht a shocrú | reasoning_effort san iarratas | completion_args san oibreán | completion_args in start nó append |
| Stair | Athsheol ar gach glao, an mheabhrú san áireamh | Iompraítear ag an gcomhrá | Coinnithe ar an bhfreastalaí |
Uirlisí ionsuite (web_search…) | Níl | Tá | Tá |
| Gnáthúsáid | Glaonna aonuaire, smacht iomlán | Cumraíocht roinnte, in-athúsáidte | Malartuithe il-chasaidh |
Dea-chleachtais chomhtháthaithe
Socraigh an leibhéal réasúnaíochta san oibreán nuair atá an tasc aonfhoirmeach, agus in aghaidh an chasaidh nuair a athraíonn sé: casadh anailíse tosaigh ag high, agus casaidh athfhoirmithe ina dhiaidh sin ag low nó none, ag brath ar an tsamhail. Fíoraigh go n-oiríonn an luach do shamhail an oibreáin: Glacann Small 4 le high agus none; glacann Large 4 le low, medium, agus high. Ar deireadh, déan logáil ar úsáid token in aghaidh an chasaidh; is é sin an t-aon bhealach chun a fháil amach an bhfuil luach sa tsaothar ag baint leis an réasúnaíocht do do chás úsáide.
Príomhphointí
- Sna APIanna Agents agus Conversations, cuir
reasoning_effortisteach icompletion_args - Tagann freagraí in
outputs; tá an téacs in iontrálachamessage.output, an mheabhrú san áireamh - Coinníonn an Conversations API an stair ar an bhfreastalaí: ní gá í a athsheoladh gach casadh
- Is féidir leat an leibhéal a athrú ar gach casadh le
conversations.append - Is féidir le hoibreán uirlisí ionsuite agus réasúnaíocht a chomhcheangal, ach tá costais úsáide carnacha i gceist