Konversazzjonijiet mingħajr Aġent
F'din il-paġna
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=minflokagent_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