Izveido specializētus aģentus un maršrutētāju
Šajā lapā
No teorijas uz praksi
Iepriekšējā nodarbībā tika iepazīstināts ar nodošanas (handoff) jēdzienu. Tagad tu izveidosi pilnu sistēmu faktiskajā izveides secībā: vispirms speciālistus, tad maršrutētāju, pēc tam savienojumus starp tiem un visbeidzot sarunu, kas visu iedarbina. Šī secība nav patvaļīga — maršrutētājs var norādīt tikai uz jau eksistējošiem aģentiem.
1. solis: Izveido specializētos aģentus
Katrs aģents saņem precīzu ekspertīzes jomu un neko citu.
from mistralai.client import Mistral
from mistralai.client.models import CompletionArgs, ResponseFormat, JSONSchema
import os
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
# Tīmekļa meklēšanas aģents
web_agent = client.beta.agents.create(
model="mistral-large-latest",
name="web-search-agent",
description="Aģents, kas meklē informāciju tiešsaistē.",
instructions="Veic precīzas tīmekļa meklēšanas. Vienmēr norādi avotus.",
tools=[{"type": "web_search"}]
)
# Finanšu aģents
finance_agent = client.beta.agents.create(
model="mistral-large-latest",
name="finance-agent",
description="Aģents, kas specializējies finanšu jautājumos.",
instructions="""Tu esi finanšu eksperts.
- Izmanto skaitliskus datus
- Skaidro jēdzienus saprotami
- Atzīmē riskus"""
)
# Kalkulatora aģents
calculator_agent = client.beta.agents.create(
model="mistral-large-latest",
name="calculator-agent",
description="Aģents detalizētiem matemātiskiem aprēķiniem.",
instructions="Paskaidro katru aprēķina soli. Sarežģītiem aprēķiniem izmanto koda interpretatoru.",
tools=[{"type": "code_interpreter"}]
)
Šiem četriem laukiem ir ļoti atšķirīgas lomas, un viens ir pelnījis īpašu uzmanību. Lauks name kebab-case formātā ir domāts tev: tas parādās žurnālos un testos, un lasāms nosaukums pasargā tevi no neskaidru ID salīdzināšanas. Lauks instructions ir adresēts modelim, kad tas sāk darbu, tāpēc tiem ir jābūt specifiskiem konkrētajai jomai — „atzīmē riskus” kaut ko nozīmē finanšu aģentam, savukārt „esi noderīgs” nenozīmē neko nevienam. Rīki (tools) ievēro stingras nepieciešamības principu: iepriekš minētajam finanšu aģentam nav rīku, jo tas spriež, tos neizmantojot, un rīku piešķiršana tikai veicinātu to nepareizu izmantošanu. Visbeidzot, description nav dokumentācija: tas ir teksts, ko maršrutētājs lasa, lai izlemtu, vai nodot uzdevumu šeit vai citur.
2. solis: Izveido maršrutētāja aģentu
Maršrutētājam nav rīku. Tā vienīgais uzdevums ir analizēt pieprasījumu un izvēlēties saņēmēju.
router_agent = client.beta.agents.create(
model="mistral-large-latest",
name="router-agent",
description="Maršrutētāja aģents, kas sadala pieprasījumus.",
instructions="""Tu esi orķestrētājs.
Analizē katru pieprasījumu un nodod to pareizajam aģentam:
- Jautājumi, kas prasa tiešsaistes datus → web-search-agent
- Finanšu jautājumi → finance-agent
- Aprēķini un skaitliskā analīze → calculator-agent
Nekad neatbildi tieši — vienmēr nodod tālāk."""
)
Šī pēdējā rinda novērš sistēmas sabrukumu. Bez tās maršrutētājs, kas balstīts uz lielu modeli, atbildēs uz jautājumiem, kas tam šķiet viegli, apejot tavus speciālistus, un radīs atbildes bez rīkiem, kurus tie būtu izmantojuši. Rezultātā iegūsi daudzu aģentu arhitektūru, kurā puse aģentu nekad netiek izmantoti.
3. solis: Definē nodošanas mērķus
Tagad tev jānorāda maršrutētājam, uz kuriem aģentiem tam ir atļauts nodot uzdevumus.
router_agent = client.beta.agents.update(
agent_id=router_agent.id,
handoffs=[web_agent.id, finance_agent.id, calculator_agent.id]
)
Parametrs handoffs pieņem aģentu ID sarakstu, un maršrutētājs var nodot uzdevumu jebkuram no tiem. Tās nav privilēģijas, kas rezervētas tikai maršrutētājam: arī speciālisti var deklarēt savus mērķus.
# Finanšu aģents var nodot uzdevumus tīmekļa meklēšanai un kalkulatoram
finance_agent = client.beta.agents.update(
agent_id=finance_agent.id,
handoffs=[web_agent.id, calculator_agent.id]
)
Tādējādi kļūst iespējama ķēde: maršrutētājs → finanšu aģents → tīmekļa meklēšana → kalkulators. Kad finanšu aģents saskaras ar jautājumu, kam nepieciešama aktuāla likme, tas neatgriežas pie maršrutētāja: tas dodas tieši pie vajadzīgā speciālista, tāpat kā konsultants, kas zvana kolēģim, nevis iet atpakaļ caur reģistratūru.
4. solis: Uzsāk sarunu
response = client.beta.conversations.start(
agent_id=router_agent.id,
inputs="Atrodi pašreizējo ECB galveno procentu likmi un aprēķini saliktos procentus 10 gadu periodā par 100 000 €."
)
# Analizē plūsmu
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]}...")
Palaid šo pieprasījumu un novēro izsekojamību, pirms aplūko atbildi. Tev vajadzētu redzēt divas nodošanas un vismaz vienu rīka izpildi; ja neredzi nevienu, tavs maršrutētājs ir atbildējis pats, un ir laiks precizēt tā instrukcijas.
Galvenais svira: apraksts
Ja maršrutēšana neizdodas, gandrīz vienmēr pie vainas ir apraksts. Maršrutētājs nezina tavus nodomus; tas lasa tikai šo tekstu par katru kandidātaģentu.
# Slikti — pārāk vispārīgi
description="Noderīgs aģents."
# Labi — maršrutētājs zina, kad nodot
description="Aģents, kas meklē aktuālu informāciju internetā un norāda savus avotus."
Raksti katru aprakstu kā atbildi uz jautājumu „kādos gadījumos man vajadzētu izsaukt šo aģentu?”, nevis kā kopsavilkumu par to, kas tas ir. Otrajā piemērā ir nosaukta situācija — aktuāla informācija, internetā —, savukārt pirmais liek maršrutētājam minēt. Pārliecinies arī, ka neviena aprakstu pāra saturā nav pārklāšanās: divi aģenti, kas aprakstīti līdzīgiem vārdiem, radīs nestabilu maršrutēšanu no vienas izpildes reizes uz nākamo.
Pilns piemērs
Lūk, saīsināta versija, kurā handoffs tiek padoti tieši maršrutētāja izveides brīdī, jo speciālisti līdz tam brīdim jau eksistē.
from mistralai.client import Mistral
import os
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
# 1. Specializētie aģenti
research = client.beta.agents.create(
model="mistral-large-latest",
name="research-agent",
description="Tiešsaistes informācijas meklēšana ar avotiem.",
tools=[{"type": "web_search"}]
)
analyst = client.beta.agents.create(
model="mistral-large-latest",
name="analyst-agent",
description="Datu analīze un aprēķini, izmantojot Python.",
tools=[{"type": "code_interpreter"}]
)
writer = client.beta.agents.create(
model="mistral-large-latest",
name="writer-agent",
description="Strukturētu un profesionālu ziņojumu sagatavošana.",
instructions="Raksti skaidrus ziņojumus ar ievadu, analīzi un ieteikumiem."
)
# 2. Maršrutētājs ar nodošanām
router = client.beta.agents.create(
model="mistral-large-latest",
name="router",
description="Orķestrē sarežģītus pieprasījumus.",
instructions="Analizē pieprasījumu un nodod to atbilstošajam speciālistam.",
handoffs=[research.id, analyst.id, writer.id]
)
# 3. Palaišana
response = client.beta.conversations.start(
agent_id=router.id,
inputs="Analizē Eiropas mākoņskaitļošanas tirgu 2026. gadā: apjoms, dalībnieki, tendences."
)
Galvenās atziņas
- Izveido specializētus aģentus ar precīziem, uz uzdevumiem vērstiem aprakstiem
- Maršrutētājs izmanto aprakstus, lai izvēlētos mērķa aģentu
client.beta.agents.update(handoffs=[...])definē nodošanas mērķus- Nodošanas var būt ligzdotas (aģents A → aģents B → aģents C)
- Katra aģenta apraksts ir galvenais svira maršrutēšanas kvalitātei