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

Konversazzjonijiet mingħajr Aġent

Lezzjoni 7 / 18 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Modalità Diretta tal-Mudell
  2. Tibda Konversazzjoni ma’ Mudell
  3. Żieda ta’ Għodod fil-Modalità Diretta
  4. Għaddi ta’ Istruzzjonijiet Dinamiċi
  5. Kompli Konversazzjoni fil-Modalità Diretta
  6. Aġent vs Modalità Diretta: Kif Tiddeċiedi
  7. Eżempju: Mistoqsija F’Kuntest Furzat
  8. Punti Ewlenin

Modalità Diretta tal-Mudell

M’għandekx bżonn toħloq oġġett Aġent dejjem biex tuża l-API tal-Konversazzjonijiet. Mistral jħalliek tibda konversazzjoni direttament ma’ mudell, u jagħtike l-persistenza mingħajr is-saff ta’ konfigurazzjoni tal-Aġent. Din il-kapaċità ġejja direttament mill-arkitettura li koprejna qabel: il-konversazzjoni hija indipendenti mill-aġent, allura tista’ teżisti perfettament waħedha.

Diversi xenarji jagħmlu din l-għażla aħjar milli tuża aġent irreġistrat. Jista’ jkun li trid persistenza mingħajr ma tiddefinixxi aġent li jista’ jerġa’ jintuża, pereżempju għax kull thread fl-applikazzjoni tiegħek huwa uniku. Jista’ jkun li qed tittestja malajr l-imġiba b’għodod integrati, u li toħloq u tħassar aġent għal kull prova jbattlek. Il-każ ta’ użu tiegħek jista’ jkun ta’ darba: xejn ma jiġġustifika li ssalva konfigurazzjoni li se tuża darba biss. Jew l-istruzzjonijiet tiegħek jistgħu jkunu dinamiċi, ikkalkulati waqt it-tħaddim ibbażati fuq il-profil tal-utent jew id-dokument attwali—f’liema każ, aġent statiku ma jkunx l-għodda t-tajba.

Tibda Konversazzjoni ma’ Mudell

Minflok tgħaddi agent_id, tgħaddi model direttament:

from mistralai.client import Mistral
import os

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

response = client.beta.conversations.start(
    model="mistral-medium-latest",
    inputs=[
        {"role": "user", "content": "Who is Albert Einstein?"}
    ]
)

print(response.outputs[-1].content)

Kollox jiddependi minn din l-għażla tal-parametru. B’agent_id, is-sejħa tirrita l-konfigurazzjoni rreġistrata tal-aġent: l-istruzzjonijiet, l-għodod u l-guardrails tiegħu. B’model, inti fil-modalità diretta u tikkonfigura kollox fis-sejħa nnifisha—xejn ma jiġi mfakkar lil hinn mis-sejħa.

Żieda ta’ Għodod fil-Modalità Diretta

L-għodod integrati mhumiex riżervati għall-aġenti. Inti tiddikjarahom fis-sejħa, eżattament kif tagħmel waqt il-ħolqien tal-aġent.

response = client.beta.conversations.start(
    model="mistral-large-latest",
    inputs=[
        {"role": "user", "content": "What are the latest Ligue 1 results?"}
    ],
    tools=[{"type": "web_search"}]
)

Dan huwa funzjonalment ekwivalenti għal aġent b’web_search, iżda mingħajr persistenza tal-konfigurazzjoni. Id-differenza tidher fl-għaxar sejħa: ma’ aġent, kont tbiddel it-temperatura darba għal dejjem; hawnhekk, trid tirrepetiha f’kull sejħa, u xejn ma jiggarantixxi li sejħa minsija xi mkien fil-kodiċi tiegħek tuża l-istess settings.

Għaddi ta’ Istruzzjonijiet Dinamiċi

Fil-modalità diretta, il-prompt tas-sistema jieħu l-forma ta’ messaġġ system imqiegħed fil-bidu tal-inputs.

response = client.beta.conversations.start(
    model="mistral-large-latest",
    inputs=[
        {"role": "system", "content": "You are an expert in French cuisine. Answer in 3 sentences maximum."},
        {"role": "user", "content": "How do I make a perfect béarnaise sauce?"}
    ]
)

Dan jagħtike l-istess flessibbiltà bħall-istruzzjonijiet tal-aġent, iżda efimera—u l-aktar importanti, din l-istringa tista’ tinbena waqt it-tħaddim, li istruzzjoni ta’ aġent irreġistrat ma tippermettix.

Kompli Konversazzjoni fil-Modalità Diretta

Il-mekkaniżmu ta’ persistenza jaħdem eżattament kif jagħmel ma’ aġent: l-ewwel sejħa tirritorna conversation_id, is-sejħiet sussegwenti jinhakku miegħu, u kull append jirritorna identifikatur ġdid min-naħa tiegħu.

# L-ewwel skambju
response1 = client.beta.conversations.start(
    model="mistral-large-latest",
    inputs=[{"role": "user", "content": "Tell me about the French Revolution."}]
)

# It-tieni skambju — il-kuntest jinżamm
response2 = client.beta.conversations.append(
    conversation_id=response1.conversation_id,
    inputs="Who were the main figures?"
)

# Il-mudell jaf li qed nitkellmu dwar ir-Rivoluzzjoni Franċiża

It-tieni mistoqsija ma ssemmix is-suġġett tagħha u m’għandhiex bżonn: il-persistenza ma tiddependix mill-eżistenza ta’ aġent, iżda biss mill-konversazzjoni.

Aġent vs Modalità Diretta: Kif Tiddeċiedi

Oħloq aġent hekk kif l-istess konfigurazzjoni sservi konversazzjonijiet multipli, għax imbagħad tikseb punt wieħed ta’ modifika: li tikkoreġi istruzzjoni taġġorna l-threads futuri kollha. Din hija wkoll l-unika triq jekk l-istruzzjonijiet tiegħek huma stabbli minn sessjoni għall-oħra, jekk qed tippjana handoffs bejn aġenti multipli—li l-lezzjoni ddedikata għas-suġġett se tiddettalja—jew jekk l-organizzazzjoni tiegħek teħtieġ konfigurazzjoni ċentralizzata u awditabbli fejn tista’ twieġeb il-mistoqsija, “B’liema istruzzjonijiet ġie eżegwit dan l-assistent?”

Ibqa’ fil-modalità diretta għall-każijiet simetriċi: prototip jew użu ta’ darba, istruzzjonijiet li jinbidlu ma’ kull konversazzjoni, l-ebda ħtieġa għal handoffs, jew ix-xewqa li tnaqqas is-sejħiet tal-API billi telimina l-ħolqien u t-tħassir tal-aġent. Fl-iżvilupp, dan l-aħħar raġuni spiss tkun biżżejjed waħedha.

Eżempju: Mistoqsija F’Kuntest Furzat

Il-funzjoni hawn taħt turi l-modalità diretta perfettament. Il-kuntest huwa argument, allura jkun differenti ma’ kull sejħa, u l-prompt tas-sistema jinbena madwaru biex jipprevjeni lill-mudell milli jiġbed għarfien barra. L-ebda aġent irreġistrat ma jista’ jġorr dan il-vinċolu, peress li jinbidel ma’ kull invokazzjoni.

def ask_question(context: str, question: str):
    """Ask a question within a given context, without creating an agent."""
    response = client.beta.conversations.start(
        model="mistral-large-latest",
        inputs=[
            {"role": "system", "content": f"Context: {context}. Answer using only this context."},
            {"role": "user", "content": question}
        ]
    )
    return response.outputs[-1].content

# Użu
answer = ask_question(
    context="Corsen AI is a French startup specializing in sovereign AI, founded in 2025.",
    question="When was Corsen AI founded?"
)

Uża mill-ġdid dan il-mudell għall-ħtiġijiet tiegħek billi tibdel il-kuntest hardcoded bit-test attwalment rilevanti—il-folja tal-prodott meqjusa, l-estratt tad-dokument magħżul—u tikseb blocca tal-bini ta’ Mistoqsija u Tweġiba f’qafas mingħajr l-ebda konfigurazzjoni biex tamministra.

Punti Ewlenin

  • Il-konversazzjonijiet jistgħu jinbdew b’model= minflok agent_id=
  • Il-modalità diretta toffri persistenza mingħajr is-saff ta’ konfigurazzjoni tal-Aġent
  • Tista’ tgħaddi għodod u istruzzjonijiet direttament fis-sejħa
  • Il-modalità diretta hija ideali għall-prototipar u l-użu ta’ darba
  • Għal handoffs u konfigurazzjonijiet li jistgħu jerġgħu jintużaw, ippreferi li toħloq aġent