Feidhmiú Freastalaí vs. Cliant
Ar an leathanach seo
An ceacht nuashonraithe an 3 Samhain, 2026 bunaithe ar SDK
mistralai3.7.0 agus ar dhoiciméadú Handoffs Mistral: sainíonn iontráilagent.handoffan gníomhaire sprioc trínext_agent_id(seachasto_agent), agus ní ghlacannconversations.appendle paraiméadaragent_id—theipfeadh ar sheanchód. Tarlaíonn atosú an ghníomhaire sprioc anseo trí chomhrá nua, a chuireann tú an comhthéacs ar fáil dó. Foinse: Handoffs · client-python.
Dhá Bhealach chun Aistrithe a Láimhseáil
Nuair a aistríonn gníomhaire smacht chuig gníomhaire eile, tairgeann API Mistral dhá mhód feidhmithe: freastalaí (uathoibríoch) agus cliant (láimhe). Is focal amháin an socruithe, ach is é a chinneann cé a thiomáineann an sruth oibre i ndáiríre. Sa mhód freastalaí, tarmligean tú an cóiréagrafaíocht iomlán do Mistral agus faigheann tú an toradh. Sa mhód cliant, faigheann tú smacht ar ais idir gach céim. Fanann gach rud eile—na gníomhairí, a n-uirlisí, a spriocanna aistrithe—díreach mar an gcéanna.
Mód Freastalaí, an Réamhshocrú
response = client.beta.conversations.start(
agent_id=router_agent.id,
inputs="Analyze and calculate market trends.",
handoff_execution="server" # Réamhshocrú — is féidir é a fhágáil ar lár
)
Bainistítear an sruth go hiomlán: faigheann an ródaí an t-iarratas, cinneann sé aistriú chuig an ngníomhaire taighde, agus déanann Mistral an t-aistriú; déanann an gníomhaire taighde a chuid oibre agus ansin aistríonn sé chuig an áireamhán, agus déanann Mistral é sin freisin; cruthaíonn an t-áireamhán an toradh. Faigheann tú an freagra deiridh, in éineacht le gach aschur idirmheánach—mar sin feiceann tú cad a tharla, ach tar éis na himeachta.
Tá trí cháilíocht ag an mód seo a mhíníonn cén fáth gurb é an réamhshocrú é. Tá sé simplí, ós rud é nach scríobhann tú aon loighic rialaithe ar do thaobh féin. Tá sé tapa, toisc go bhfeidhmíonn an slabhra iomlán ag Mistral gan turais líonra ag gach seachadadh. Tá sé iontaofa, mar láimhseáiltear láimhseáil earráidí agus am-ceisteanna idir gníomhairí duitse.
Is iad a theorainneacha an frithpháirt beacht. Níl aon smacht idirmheánach agat: ní féidir aistriú a bhailíochtú ná a mhodhnú agus é ag tarlú. Tá an costas doiléir, sa chiall go bhfeidhmíonn gach gníomhaire sa slabhra gan go mbeifeá in ann iarratas atá ag dul i dtreo nach gá a stopadh i lár an tsreafa. Agus ní féidir leat aon loighic chustaim a chur isteach idir céimeanna—gan logáil mhionghrádach, gan bailíochtú, gan cinntí gnó.
Mód Cliant, Nuair a Theastaíonn Smacht Uait
response = client.beta.conversations.start(
agent_id=router_agent.id,
inputs="Analyze the cloud market.",
handoff_execution="client"
)
Faigheann an ródaí an t-iarratas agus cinneann sé aistriú, díreach mar a rinne sé roimhe. Ach in ionad an t-aistriú a fheidhmiú, faigheann tú imeacht agent.handoff agus stopann an slabhra ansin. Is ortsa atá sé é a atosú trí ghlaoch ar an ngníomhaire sprioc—rud a fhágann an tsaoirse agat bailíochtú a dhéanamh, logáil, an comhthéacs a shaibhriú, nó diúltú go simplí.
response = client.beta.conversations.start(
agent_id=router_agent.id,
inputs="Search for the latest tech news.",
handoff_execution="client"
)
for entry in response.outputs:
if entry.type == "agent.handoff":
target_agent_id = entry.next_agent_id
print(f"Handoff requested to: {target_agent_id}")
# Bailíochtaigh, ansin aistrigh chuig an ngníomhaire sprioc, le comhthéacs úsáideach
next_response = client.beta.conversations.start(
agent_id=target_agent_id,
inputs="Search for the latest tech news.",
)
# Próiseáil freagra an ghníomhaire sprioc
for next_entry in next_response.outputs:
print(f"{next_entry.type}: {next_entry.content}")
Tá pointe amháin a thuilleann aird: déanann doiciméadú Mistral cur síos ar mhód cliant—filltear an smacht chugat ag am an aistrithe—ach ní sholáthraíonn sé aon mhodh chun an gníomhaire sprioc a bheith ag leanúint ar an gcomhrá céanna, agus ní ghlacann conversations.append le paraiméadar agent_id. Mar sin, tosaíonn an sampla comhrá leis an ngníomhaire sprioc, a chuireann tú ar an eolas go sainráite faoin méid atá uaidh: an t-iarratas bunaidh, agus más infheidhme, achoimre ar an méid atá déanta cheana. Is deis é seo freisin chun ach an méid ba chóir dóibh a fheiceáil a tharchur.
Ní láimhseálann an blúra thuas ach seachadadh amháin. Nascann slabhra fíor roinnt cinn, rud a éilíonn lúb.
def execute_with_control(router_id, query):
"""Feidhmíonn sé sruth oibre il-ghníomhaire le smacht ag gach céim."""
response = client.beta.conversations.start(
agent_id=router_id,
inputs=query,
handoff_execution="client"
)
conversation_id = response.conversation_id
results = []
while True:
handoff_found = False
for entry in response.outputs:
if entry.type == "agent.handoff":
handoff_found = True
target = entry.next_agent_id
print(f"[LOG] Aistriú chuig {target}")
# Anseo is féidir leat a chur leis: bailíochtú, logáil, méadrachtaí
response = client.beta.conversations.start(
agent_id=target,
inputs=query, # an t-iarratas bunaidh, saibhrithe más gá
handoff_execution="client",
)
conversation_id = response.conversation_id
break
elif entry.type == "message.output":
results.append(entry.content)
if not handoff_found:
break
return results
Is é struchtúr an chaidéil é: fad is a fheictear aistriú sna haschuir, próiseálann tú é agus tosaíonn tú arís; chomh luath agus nach bhfaigheann athrá lúibe aon cheann, tá an slabhra críochnaithe agus scoireann tú leis na teachtaireachtaí carntha. Léiríonn an nóta sa lár an suíomh a thugann údar don mhód seo ar fad: is ansin, agus ansin amháin, a chuireann do chód é féin idir dhá ghníomhaire.
Roghnú idir an Dá Cheann
Clúdaíonn an mód freastalaí táirgeadh caighdeánach. Má tá do shruth oibre intuartha, má mhuiníníonn tú na gníomhairí a scríobh tú, nó má tá tú ag déanamh prótatíp agus más mian leat torthaí a fheiceáil go tapa, is é an t-uathoibriú iomlán an rogha cheart—agus bheadh lúb rialaithe a scríobh ina chur amú ama.
Tá údar le mód cliant chomh luath agus a thagann riachtanas seachtrach isteach sa slabhra. Bailíochtú daonna, nuair a chaithfidh oibreoir aistriú chuig gníomhaire a spreagann gníomhaíochtaí íogaire a cheadú. Riachtanas le haghaidh logála agus iniúchta, nuair a éilíonn comhlíonadh gach céim a rianú le d’aitheantais féin agus do stampaí ama féin. Ródaíocht choinníollach, nuair a bhraitheann an cinneadh ar rialacha gnó nach féidir leis an tsamhail a bheith ar an eolas fúthu—stádas custaiméara, am an lae, cuóta. Teorainn, nó teorannú ráta, nuair is mian leat líon na ngníomhairí a fheidhmíodh d’iarratas a theorannú. Straitéis fillte ar deireadh, nuair a chaithfidh teip ar ghníomhaire amháin rud éigin seachas earráid a chur faoi bhráid an úsáideora a spreagadh.
Seo mar a bhreathnaíonn an chéad cheann de na cásanna sin, laghdaithe go dtí a chnámharlach.
def workflow_with_validation(router_id, query):
response = client.beta.conversations.start(
agent_id=router_id,
inputs=query,
handoff_execution="client"
)
for entry in response.outputs:
if entry.type == "agent.handoff":
target = entry.next_agent_id
approval = input(f"Authorize transfer to {target}? (y/n) ")
if approval.lower() == "y":
response = client.beta.conversations.start(
agent_id=target,
inputs=query,
)
else:
print("Transfer refused.")
break
Feidhmíonn input na consóil mar léiriú; in iarratas, cuirfear fógra chuig oibreoir ina ionad agus atosú an tsreafa oibre nuair a thagann an freagra. Fanann an prionsabal mar an gcéanna: ní tharlaíonn an t-aistriú ach amháin má spreagann do chód é.
Is é an cur chuige ceart tosú sa mhód freastalaí agus athrú ach an lá a éilíonn srian sonrach é. Déanann athrú go mód cliant “ar eagla na heagla” íoc láithreach as castacht lúibe agus turais líonra, as smacht nach bhfuil tú ag úsáid fós.
Príomhphointí
- Mód freastalaí = go hiomlán uathoibríoch, simplí agus tapa, gan smacht idirmheánach
- Mód cliant = faigheann tú imeachtaí aistrithe agus cinneann tú cad le déanamh
- Cumasaíonn mód cliant bailíochtú, logáil, ródaíocht choinníollach, agus láimhseáil earráidí
- Don chuid is mó de na cásanna, tá mód freastalaí leordhóthanach—athraigh go mód cliant nuair a theastaíonn smacht uait
- Tacaíonn an dá mhód leis na slabhraí gníomhaire céanna; níl difríocht ach sa smacht