Raġunar fl-aġenti u fil-konversazzjonijiet
F'din il-paġna
Lezzjon miktuba mill-ġdid fit-2 ta’ Novembru 2026 għal Mistral Small 4 u Large 4. Id-dokumentazzjoni ta’ Mistral tiddikjara li
reasoning_efforthuwa disponibbli fuq l-endpoints tal-Aġenti u l-Konversazzjonijiet fil-qasamcompletion_args. Sorsi: Raġunar · Python SDK — Konversazzjonijiet.
Tliet modi biex tsejjaħ mudell tar-raġunar
Il-lezzjonijiet preċedenti użaw l-API tal-Chat Completions: kont tibgħat l-istorja sħiħa ma’ kull sejħa, u reasoning_effort kien jidħol direttament fir-rikjesta. Mistral toffri żewġ interfaċċi oħra: l-API tal-Aġenti, li ssalva konfigurazzjoni li tista’ terġa’ tużaha (mudell, struzzjonijiet, għodod, parametri), u l-API tal-Konversazzjonijiet, li żżomm l-istorja fuq is-server. F’dawn iż-żewġ API, ma tistabbilixxix ir-raġunar fil-livell ogħla; timmanuvrah ġewwa completion_args flimkien ma’ parametri oħra tal-ġenerazzjoni.
Aġent li jirraġuna
Li tistabbilixxi l-livell tar-raġunar fid-definizzjoni tal-aġent jevita li tirrepetih fuq kull sejħa u jiżgura li t-tim kollu tiegħek juża l-istess setting:
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?",
)
Qari tal-outputs tal-konversazzjoni
Konversazzjoni ma tirritornax choices; tirritorna lista ta’ entrati (outputs). Ir-risposta tal-mudell tinsab f’entrati tat-tip message.output. Bħal fil-Chat Completions, il-kontenut huwa jew korda jew lista ta’ biċċiet li jistgħu jinkludu ThinkChunk. Il-funzjoni separer mil-Lezzjoni 3 taħdem eżattament bħal qabel:
for entry in reponse.outputs:
if entry.type == "message.output":
reflexion, texte = separer(entry.content)
print(texte)
Entrati oħra jiddeskrivu x’ġara matul id-dawra, bħall-eżekuzzjoni ta’ għodda (tool.execution) jew sejħa ta’ funzjoni. Injorahom jekk tinteressak biss it-tweġiba finali.
Konversazzjoni mingħajr aġent
Għal kompiti ta’ darba, l-API tal-Konversazzjonijiet taċċetta mudell direttament, mingħajr setup ta’ aġent minn qabel. Is-server iżomm l-istorja, u tkompli l-iskambju b’conversations.append, u taġġusta l-livell tar-raġunar għal dawra speċifika jekk ikun meħtieġ:
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
)
Dan huwa vantaġġ konkret fuq il-Chat Completions, fejn id-dokumentazzjoni teħtieġ li terġa’ tibgħat il-messaġġ sħiħ tal-assistent, inkluża r-riflessjoni, fuq kull dawra ġdida (Lezzjoni 7). Bl-API tal-Konversazzjonijiet, is-server iżomm l-istorja; ma terġax tibgħatha fuq kull sejħa.
Raġunar u għodod
Aġent jista’ jgħaqqad ir-raġunar u l-għodod: tools u completion_args huma oqsma indipendenti meta toħloq aġent. Għalhekk, aġent tal-analiżi jista’ jkollu tfittxija fuq il-web u raġunar fond:
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"},
)
Madankollu, żomm għajnejk fuq l-ispiża: ir-riflessjoni u s-sejħiet tal-għodod jiżdiedu fil-kont għal dawra waħda.
Tqabbil tat-tliet approċċi
| Kriterju | Chat Completions | Aġenti | Konversazzjonijiet |
|---|---|---|---|
| Fejn tistabbilixxi r-raġunar | reasoning_effort fir-rikjesta | completion_args fl-aġent | completion_args f’start jew append |
| Storja | Erġa’ ibgħat fuq kull sejħa, riflessjoni inkluża | Imġarrba mill-konversazzjoni | Miżmuma fuq is-server |
Għodod integrati (web_search…) | Le | Iva | Iva |
| Użu tipiku | Sejħiet ta’ darba, kontroll sħiħ | Konfigurazzjoni kondiviża u li tista’ terġa’ tużaha | Skambji b’diversi dawriet |
L-aħjar prattiki ta’ integrazzjoni
Istabbilixxi l-livell tar-raġunar fl-aġent meta l-kompitu huwa uniformi, u għal kull dawra meta jvarja: dawra ta’ analiżi inizjali f’high, segwita minn dawriet ta’ riformulazzjoni f’low jew none, skont il-mudell. Ivverifika li l-valur jixraq għall-mudell tal-aġent: Small 4 jaċċetta high u none; Large 4 jaċċetta low, medium, u high. Fl-aħħar, irreġistra l-użu tat-tokens għal kull dawra; din hija l-unika biex tkun taf jekk ir-raġunar jagħmilx sens għall-każ ta’ użu tiegħek.
Punti Ewlenin
- Fl-APIs tal-Aġenti u l-Konversazzjonijiet, għaddi
reasoning_effortġewwacompletion_args - Ir-risposti jaslu f’
outputs; it-test jinsab f’entratimessage.output, riflessjoni inkluża - L-API tal-Konversazzjonijiet iżomm l-istorja fuq is-server: m’hemmx bżonn li terġa’ tibgħatha kull dawra
- Tista’ tbiddel il-livell fuq kull dawra b’
conversations.append - Aġent jista’ jgħaqqad għodod integrati u raġunar, bl-ispiża ta’ użu kumulattiv