Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Raġunar fl-aġenti u fil-konversazzjonijiet

Lezzjoni 4 / 12 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Tliet modi biex tsejjaħ mudell tar-raġunar
  2. Aġent li jirraġuna
  3. Qari tal-outputs tal-konversazzjoni
  4. Konversazzjoni mingħajr aġent
  5. Raġunar u għodod
  6. Tqabbil tat-tliet approċċi
  7. L-aħjar prattiki ta’ integrazzjoni
  8. Punti Ewlenin

Lezzjon miktuba mill-ġdid fit-2 ta’ Novembru 2026 għal Mistral Small 4 u Large 4. Id-dokumentazzjoni ta’ Mistral tiddikjara li reasoning_effort huwa disponibbli fuq l-endpoints tal-Aġenti u l-Konversazzjonijiet fil-qasam completion_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

KriterjuChat CompletionsAġentiKonversazzjonijiet
Fejn tistabbilixxi r-raġunarreasoning_effort fir-rikjestacompletion_args fl-aġentcompletion_args f’start jew append
StorjaErġa’ ibgħat fuq kull sejħa, riflessjoni inklużaImġarrba mill-konversazzjoniMiżmuma fuq is-server
Għodod integrati (web_search…)LeIvaIva
Użu tipikuSejħiet ta’ darba, kontroll sħiħKonfigurazzjoni kondiviża u li tista’ terġa’ tużahaSkambji 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 ġewwa completion_args
  • Ir-risposti jaslu f’outputs; it-test jinsab f’entrati message.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