Loo spetsialiseerunud agente ja ruuterit
Sellel lehel
Teooriast praktikani
Eelmine tund tutvustas edastamise (handoff) kontseptsiooni. Nüüd ehidad kogu süsteemi üles tegelikus loomisjärjekorras: esmalt spetsialistid, seejärel ruuter, siis nende vaheline ühendus ja lõpuks vestlus, mis paneb kõik liikuma. See järjekord pole juhuslik – ruuter saab osutada ainult juba olemas olevatele agentidele.
1. samm: Loo spetsialiseerunud agendid
Iga agent saab täpse eksperdivaldkonna ja mitte midagi muud.
from mistralai.client import Mistral
from mistralai.client.models import CompletionArgs, ResponseFormat, JSONSchema
import os
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
# Veebiotsingu agent
web_agent = client.beta.agents.create(
model="mistral-large-latest",
name="web-search-agent",
description="Agent, mis otsib teavet internetist.",
instructions="Teosta täpseid veebiotsinguid. Tsiteeri alati oma allikaid.",
tools=[{"type": "web_search"}]
)
# Finantsagent
finance_agent = client.beta.agents.create(
model="mistral-large-latest",
name="finance-agent",
description="Finantsküsimustele spetsialiseerunud agent.",
instructions="""Oled finantsekspert.
- Kasuta numbrilisi andmeid
- Selgita mõisteid selgelt
- Märgista riskid"""
)
# Kalkulaatori agent
calculator_agent = client.beta.agents.create(
model="mistral-large-latest",
name="calculator-agent",
description="Agent üksikasjalikeks matemaatilisteks arvutusteks.",
instructions="Selgita iga arvutussammu. Kasuta keerukate arvutuste jaoks koodi interpretaatorit.",
tools=[{"type": "code_interpreter"}]
)
Need neli välja mängivad väga erinevaid rolle ja üks neist väärib erilist tähelepanu. Kebab-case’is name on sinu jaoks: see ilmub sinu logidesse ja testidesse ning loetav nimi säästab sind opaaksete ID-de võrdlemisest. instructions pöörduvad mudeli poole, kui see tööle hakkab, seega peavad need olema valdkonnaspetsiifilised – „märgista riskid“ tähendab finantsagendile midagi, samas kui „ole abivalmis“ ei tähenda kellelegi midagi. tools järgivad range vajalikkuse printsiipi: ülaloleval finantsagendil pole tööriistu, sest ta arutleb ilma nendeta ja tööriistade andmine kutsuks esile ainult väärkasutust. Lõpuks, description ei ole dokumentatsioon: see on tekst, mida ruuter loeb, et otsustada, kas edastada päring siia või mujale.
2. samm: Loo ruuteragent
Ruuteril pole tööriistu. Kogu tema töö seisneb päringu analüüsimises ja vastuvõtja valimises.
router_agent = client.beta.agents.create(
model="mistral-large-latest",
name="router-agent",
description="Ruuteragent, mis jaotab päringuid.",
instructions="""Oled orkestraator.
Analüüsi iga päringut ja edasta see õigele agendile:
- Küsimused, mis nõuavad võrguandmeid → web-search-agent
- Finantsküsimused → finance-agent
- Arvutused ja numbriline analüüs → calculator-agent
Ära vasta kunagi otse – edasta alati."""
)
Viimane rida hoiab ära süsteemi kokkuvarisemise. Ilma selleta vastab suurel mudelil põhinev ruuter küsimustele, mis talle lihtsad tunduvad, möödub sinu spetsialistidest ja toodab vastuseid ilma tööriistadeta, mida nad oleksid kasutanud. Tulemuseks on mitme agendi arhitektuur, kus pool agente jääb kasutamata.
3. samm: Määratle edastamise sihtmärgid
Nüüd pead ütlema ruuterile, millistele agentidele tal on lubatud edastada.
router_agent = client.beta.agents.update(
agent_id=router_agent.id,
handoffs=[web_agent.id, finance_agent.id, calculator_agent.id]
)
Parameeter handoffs võtab vastu agentide ID-de loendi ja ruuter saab edastada päringu ükskõik millisele neist. See ei ole eesõigus, mis on reserveeritud ainult ruuterile: ka spetsialistid saavad deklareerida oma sihtmärke.
# Finantsagent saab edastada veebiotsingule ja kalkulaatorile
finance_agent = client.beta.agents.update(
agent_id=finance_agent.id,
handoffs=[web_agent.id, calculator_agent.id]
)
Seejärel on võimalik ahel nagu ruuter → finants → veebiotsing → kalkulaator. Kui finantsagent seisab silmitsi küsimusega, mis nõuab jooksvat kurssi, ei edasta ta tagasi ruuterile: ta läheb otse vajalikule spetsialistile, täpselt nagu konsultant, kes helistab kolleegile, selle asemel et minna tagasi vastuvõtu kaudu.
4. samm: Alusta vestlust
response = client.beta.conversations.start(
agent_id=router_agent.id,
inputs="Leia EKP praegune baasintressimäär ja arvuta liitintress 10 aasta jooksul 100 000 euro pealt."
)
# Analüüsi voogu
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]}...")
Käivita see päring ja jälgi jälitust enne vastuse vaatamist. Peaksid nägema kahte edastamist ja vähemalt ühte tööriista käivitamist; kui sa ei näe ühtegi, vastas su ruuter ise ja on aeg tema juhiseid täpsustada.
Peamine hoob: kirjeldus
Kui ruuterimine ebaõnnestub, on süüdlaseks peaaegu alati kirjeldus. Ruuter ei tea sinu kavatsusi; ta loeb iga kandidaat-agendi kohta ainult seda teksti.
# Halb — liiga üldine
description="Kasulik agent."
# Hea — ruuter teab, millal edastada
description="Agent, mis otsib internetist jooksvat teavet ja tsiteerib oma allikaid."
Kirjuta iga kirjeldus vastusena küsimusele „millisel juhul peaksin ma seda agenti kutsuma?“, mitte kokkuvõttena sellest, mis ta on. Teine näide nimetab olukorda – jooksev teave, internetis –, samas kui esimene jätab ruuteri arvata. Samuti veendu, et ükski kirjelduste paar ei kattuks: sarnaste tingimustega kirjeldatud kaks agenti tekitavad ühest käivitusest teise ebastabiilset ruuterimist.
Täielik näide
Siin on kondenseeritud versioon, kus handoffs antakse edasi otse ruuteri loomisel, kuna spetsialistid on selleks hetkeks juba olemas.
from mistralai.client import Mistral
import os
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
# 1. Spetsialiseerunud agendid
research = client.beta.agents.create(
model="mistral-large-latest",
name="research-agent",
description="Veebipõhine teabeotsing allikatega.",
tools=[{"type": "web_search"}]
)
analyst = client.beta.agents.create(
model="mistral-large-latest",
name="analyst-agent",
description="Andmeanalüüs ja arvutused Pythoniga.",
tools=[{"type": "code_interpreter"}]
)
writer = client.beta.agents.create(
model="mistral-large-latest",
name="writer-agent",
description="Struktureeritud ja professionaalsete aruannete koostamine.",
instructions="Kirjuta selgeid aruandeid, mis sisaldavad sissejuhatust, analüüsi ja soovitusi."
)
# 2. Ruuter edastamistega
router = client.beta.agents.create(
model="mistral-large-latest",
name="router",
description="Orkestreerib keerukaid päringuid.",
instructions="Analüüsi päringut ja edasta see sobivale spetsialistile.",
handoffs=[research.id, analyst.id, writer.id]
)
# 3. Käivita
response = client.beta.conversations.start(
agent_id=router.id,
inputs="Analüüsi Euroopa pilvandmetöötluse turgu 2026. aastal: suurus, mängijad, trendid."
)
Peamised punktid
- Loo spetsialiseerunud agendid täpsete, ülesandele orienteeritud kirjeldustega
- Ruuter kasutab siht-agendi valimiseks kirjeldusi
client.beta.agents.update(handoffs=[...])määratleb edastamise sihtmärgid- Edastamised võivad olla pesastatud (agent A → agent B → agent C)
- Iga agendi kirjeldus on ruuterimise kvaliteedi peamine hoob