Cruthaigh gníomhairí speisialaithe agus ródaire
Ar an leathanach seo
Ón teoiric go dtí an cleachtas
Thug an cheacht roimhe seo isteach coincheap na n-aistrithe (handoffs). Anois, tógfaidh tú an córas iomlán san ord tógála ceart: ar dtús na speisialaithe, ansin an ródaire, ansin an nascadh eatarthu, agus ar deireadh an comhrá a chuireann gach rud ar siúl. Níl an t-ord seo treallach—ní féidir leis an ródaire ach díriú ar ghníomhairí atá ann cheana féin.
Céim 1: Cruthaigh na gníomhairí speisialaithe
Faigheann gach gníomhaire réimse saineolais cruinn agus aon rud eile seachas sin.
from mistralai.client import Mistral
from mistralai.client.models import CompletionArgs, ResponseFormat, JSONSchema
import os
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
# Gníomhaire cuardaigh gréasáin
web_agent = client.beta.agents.create(
model="mistral-large-latest",
name="web-search-agent",
description="Gníomhaire a dhéanann cuardach ar fhaisnéis ar líne.",
instructions="Déan cuardaigh ghréasáin chruinne. Luaigh do fhoinsí i gcónaí.",
tools=[{"type": "web_search"}]
)
# Gníomhaire airgeadais
finance_agent = client.beta.agents.create(
model="mistral-large-latest",
name="finance-agent",
description="Gníomhaire atá speisialaithe i gceisteanna airgeadais.",
instructions="""Is saineolaí airgeadais tú.
- Úsáid sonraí uimhriúla
- Mínigh coincheapa go soiléir
- Cuir rioscaí in iúl"""
)
# Gníomhaire áireamháin
calculator_agent = client.beta.agents.create(
model="mistral-large-latest",
name="calculator-agent",
description="Gníomhaire le haghaidh ríomhaireachtaí matamaiticiúla mionsonraithe.",
instructions="Mínigh gach céim den ríomhaireacht. Úsáid an t-aisteoir cód le haghaidh ríomhaireachtaí casta.",
tools=[{"type": "code_interpreter"}]
)
Tá róil an-éagsúil ag na ceithre réimse seo, agus tá ceann amháin a thuilleann aird ar leith. Is duitse an name i gcás kebab: feictear é i do logaí agus i do thástálacha, agus sábhálann ainm inléite duit ó bheith ag comparáid IDanna doiléire. Díríonn na instructions ar an tsamhail nuair a thosaíonn sí ag obair, mar sin caithfidh siad a bheith sonrach don réimse—ciallaíonn “cuir rioscaí in iúl” rud éigin do ghníomhaire airgeadais, ach ní chiallaíonn “bí cabhrach” aon rud do dhuine ar bith. Leanann na tools prionsabal na riachtanais doichte: níl aon uirlisí ag an ngníomhaire airgeadais thuas toisc go ndéanann sé réasúnaíocht gan iad a bheith ag teastáil, agus dá dtabharfaí uirlisí dó, ní dhéanfadh sé ach mí-úsáid a mhealladh. Ar deireadh, ní doiciméadú é an description: is é an téacs é a léann an ródaire chun a chinneadh an bhfuil sé le haistriú anseo nó áit eile.
Céim 2: Cruthaigh an gníomhaire ródaire
Níl aon uirlisí ag an ródaire. Is é a obair iomlán ná an t-iarratas a anailísiú agus an faighteoir a roghnú.
router_agent = client.beta.agents.create(
model="mistral-large-latest",
name="router-agent",
description="Gníomhaire ródaire a dháileann iarratais.",
instructions="""Is comhordaitheoir tú.
Déan anailís ar gach iarratas agus aistrigh chuig an ngníomhaire ceart:
- Ceisteanna a éilíonn sonraí ar líne → web-search-agent
- Ceisteanna airgeadais → finance-agent
- Ríomhaireachtaí agus anailís uimhriúil → calculator-agent
Ná freagair go díreach riamh—aistrigh i gcónaí."""
)
Cuireann an líne dheireanach sin cosc ar an gcóras titim as a chéile. Gan í, freagróidh ródaire atá bunaithe ar shamhail mhór ceisteanna a bhfuil cuma éasca orthu dó, seachnóidh sé do shaineolaithe, agus táirgfear freagraí gan na huirlisí a d’úsáidfadh siadsan. Críochnaíonn tú le hailtireacht ilghníomhaire ina mbaintear úsáid as leath na ngníomhairí riamh.
Céim 3: Sainigh spriocanna aistrithe
Anois, ní mór duit a chur in iúl don ródaire cé na gníomhairí ar féidir leis aistriú chuig.
router_agent = client.beta.agents.update(
agent_id=router_agent.id,
handoffs=[web_agent.id, finance_agent.id, calculator_agent.id]
)
Glacann an paraiméadar handoffs le liosta d’IDanna gníomhairí, agus is féidir leis an ródaire aistriú chuig aon cheann acu. Ní pribhléid é seo atá in áirithe don ródaire amháin: is féidir le speisialaithe a spriocanna féin a dhearbhú freisin.
# Is féidir leis an ngníomhaire airgeadais aistriú chuig cuardach gréasáin agus an t-áireamhán
finance_agent = client.beta.agents.update(
agent_id=finance_agent.id,
handoffs=[web_agent.id, calculator_agent.id]
)
Ansin bíonn slabhra cosúil le ródaire → airgeadas → cuardach gréasáin → áireamhán indéanta. Nuair a bhíonn ceist os comhair an ghníomhaire airgeadais a éilíonn ráta reatha, ní dhéanann sé aistriú ar ais chuig an ródaire: téann sé go díreach chuig an speisialaí atá ag teastáil uaidh, díreach mar a ghlaodh comhairleoir ar chomhghleacaí seachas dul ar ais tríd an bhfáilteachas.
Céim 4: Tosaigh an comhrá
response = client.beta.conversations.start(
agent_id=router_agent.id,
inputs="Faigh an príomhráta úis reatha ón BCE agus ríomh úis ilchodach thar 10 bliain do €100,000."
)
# Déan anailís ar an sreabhadh
for entry in response.outputs:
if entry.type == "agent.handoff":
print(f"[HANDOFF] → {entry.next_agent_id}")
elif entry.type == "tool.execution":
print(f"[TOOL] {entry.tool_name}")
elif entry.type == "message.output":
print(f"[RESPONSE] {entry.content[:200]}...")
Rith an t-iarratas seo agus breathnaigh ar an lorg sula bhféachann tú ar an bhfreagra. Ba chóir duit dhá aistriú agus oiread agus uirlis amháin a fheiceáil ar a laghad; mura bhfeiceann tú aon cheann, d’fhreagair do ródaire leis féin, agus tá sé in am a chuid treoracha a dhaingniú.
An luamhán main: an cur síos
Nuair a theipeann ar an ródaireacht, is minic gurb é an cur síos atá le locht. Níl a fhios ag an ródaire cad iad do rúint; ní léann sé ach an téacs seo do gach gníomhaire iarrthach.
# Droch-chur síos — ró-ghinearálta
description="Gníomhaire úsáideach."
# Dea-chur síos — tá a fhios ag an ródaire cathain le haistriú
description="Gníomhaire a dhéanann cuardach ar fhaisnéis reatha ar an Idirlíon agus a luaíonn a fhoinsí."
Scríobh gach cur síos mar fhreagra ar an gceist “cén cás ar chóir dom glaoch ar an ngníomhaire seo?” seachas mar achoimre ar cad é. Ainmníonn an dara sampla an cás—faisnéis reatha, ar an Idirlíon—fágann an chéad cheann an ródaire faoi dhraíocht. Seiceáil freisin nach bhfuil aon lánúin cur síosanna ag forluí: táirfidh dhá ghníomhaire atá curtha síos i dtéarmaí cosúla ródaireacht éagobhsaí ó fhorghníomhú go chéile.
Sampla iomlán
Seo an leagan comhbhrúite, le handoffs a ritear go díreach le linn cruthú an ródaire ós rud é go bhfuil na speisialaithe ann cheana féin ag an bpointe sin.
from mistralai.client import Mistral
import os
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
# 1. Gníomhairí speisialaithe
research = client.beta.agents.create(
model="mistral-large-latest",
name="research-agent",
description="Cuardach faisnéise ar líne le foinsí.",
tools=[{"type": "web_search"}]
)
analyst = client.beta.agents.create(
model="mistral-large-latest",
name="analyst-agent",
description="Anailís sonraí agus ríomhaireachtaí le Python.",
tools=[{"type": "code_interpreter"}]
)
writer = client.beta.agents.create(
model="mistral-large-latest",
name="writer-agent",
description="Dréachtú tuarascálacha struchtúrtha agus gairmiúla.",
instructions="Scríobh tuarascálacha soiléire le réamhrá, anailís, agus moltaí."
)
# 2. Ródaire le haistrithe
router = client.beta.agents.create(
model="mistral-large-latest",
name="router",
description="Comhordaíonn sé iarratais chasta.",
instructions="Déan anailís ar an iarratas agus aistrigh chuig an speisialaí cuí.",
handoffs=[research.id, analyst.id, writer.id]
)
# 3. Seoladh
response = client.beta.conversations.start(
agent_id=router.id,
inputs="Déan anailís ar mhargadh ríomhaireachta scamaill na hEorpa in 2026: méid, imreoirí, treochtaí."
)
Príomhphointí
- Cruthaigh gníomhairí speisialaithe le cur síosanna cruinne atá dírithe ar thascanna
- Úsáideann an ródaire cur síosanna chun an gníomhaire sprioc a roghnú
- Sainíonn
client.beta.agents.update(handoffs=[...])spriocanna aistrithe - Is féidir aistrithe a bheith neadaithe (gníomhaire A → gníomhaire B → gníomhaire C)
- Is é cur síos gach gníomhaire an príomhluamhán do cháilíocht na ródaireachta