Opret specialiserede agenter og en router
På denne side
Fra teori til praksis
Den forrige lektion introducerede begrebet handoffs. Nu skal du bygge hele systemet i den korrekte rækkefølge: først specialisterne, derefter routeren, så forbindelsen mellem dem og til sidst den samtale, der sætter det hele i gang. Denne rækkefølge er ikke vilkårlig – routeren kan kun pege på agenter, der allerede eksisterer.
Trin 1: Opret de specialiserede agenter
Hver agent får et præcist ekspertiseområde og intet andet.
from mistralai.client import Mistral
from mistralai.client.models import CompletionArgs, ResponseFormat, JSONSchema
import os
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
# Web search agent
web_agent = client.beta.agents.create(
model="mistral-large-latest",
name="web-search-agent",
description="Agent that searches for information online.",
instructions="Perform precise web searches. Always cite your sources.",
tools=[{"type": "web_search"}]
)
# Finance agent
finance_agent = client.beta.agents.create(
model="mistral-large-latest",
name="finance-agent",
description="Agent specialized in financial questions.",
instructions="""You are a financial expert.
- Use numerical data
- Explain concepts clearly
- Flag risks"""
)
# Calculator agent
calculator_agent = client.beta.agents.create(
model="mistral-large-latest",
name="calculator-agent",
description="Agent for detailed mathematical calculations.",
instructions="Explain each step of the calculation. Use the code interpreter for complex calculations.",
tools=[{"type": "code_interpreter"}]
)
Disse fire felter spiller meget forskellige roller, og ét fortjener særlig opmærksomhed. name i kebab-case er til dig: det vises i dine logs og tests, og et læsbart navn sparer dig for at sammenligne uigennemskuelige ID’er. instructions henvender sig til modellen, når den begynder at arbejde, så de skal være domænespecifikke – „flag risks” betyder noget for en finansagent, mens „be helpful” ikke betyder noget for nogen. tools følger princippet om streng nødvendighed: finansagenten ovenfor har ingen værktøjer, fordi den ræsonnerer uden brug for dem, og at give den værktøjer ville blot invitere til misbrug. Endelig er description ikke dokumentation: det er den tekst, routeren læser for at beslutte, om den skal overføre hertil eller et andet sted.
Trin 2: Opret router-agenten
Routeren har ingen værktøjer. Dens eneste opgave består i at analysere anmodningen og vælge modtageren.
router_agent = client.beta.agents.create(
model="mistral-large-latest",
name="router-agent",
description="Router agent that distributes requests.",
instructions="""You are an orchestrator.
Analyze each request and transfer to the right agent:
- Questions requiring online data → web-search-agent
- Financial questions → finance-agent
- Calculations and numerical analysis → calculator-agent
Never answer directly—always transfer."""
)
Den sidste linje forhindrer systemet i at kollapse. Uden den vil en router baseret på en stor model besvare spørgsmål, der virker lette for den, omgå dine specialister og producere svar uden de værktøjer, de ellers ville have brugt. Du ender med en multi-agent-arkitektur, hvor halvdelen af agenterne aldrig bliver brugt.
Trin 3: Definer handoff-mål
Nu skal du fortælle routeren, hvilke agenter den må overføre til.
router_agent = client.beta.agents.update(
agent_id=router_agent.id,
handoffs=[web_agent.id, finance_agent.id, calculator_agent.id]
)
Parameteren handoffs tager en liste over agent-ID’er, og routeren kan overføre til enhver af dem. Dette er ikke en rettighed forbeholdt routeren: specialister kan også erklære deres egne mål.
# The finance agent can transfer to web search and the calculator
finance_agent = client.beta.agents.update(
agent_id=finance_agent.id,
handoffs=[web_agent.id, calculator_agent.id]
)
En kæde som router → finance → web search → calculator bliver dermed mulig. Når finansagenten står over for et spørgsmål, der kræver en aktuelt kurs, sender den ikke tilbage til routeren: den går direkte til den specialist, den har brug for, ligesom en konsulent ringer til en kollega i stedet for at gå tilbage gennem receptionen.
Trin 4: Start samtalen
response = client.beta.conversations.start(
agent_id=router_agent.id,
inputs="Find the current ECB key interest rate and calculate compound interest over 10 years for €100,000."
)
# Analyze the flow
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ør denne anmodning og observer sporet, før du ser på svaret. Du bør se to handoffs og mindst én værktøjsudførelse; hvis du ikke ser nogen, har routeren svaret alene, og så er det tid til at stramme dens instrukser.
Den vigtigste løftestang: beskrivelsen
Når routing fejler, er beskrivelsen næsten altid skyld i det. Routeren kender ikke dine intentioner; den læser kun denne tekst for hver kandidat-agent.
# Bad — too vague
description="A useful agent."
# Good — the router knows when to transfer
description="Agent that searches for current information on the Internet and cites its sources."
Skriv hver beskrivelse som et svar på spørgsmålet „i hvilket tilfælde skal jeg ringe til denne agent?” snarere end som et sammendrag af, hvad den er. Det andet eksempel nævner situationen – aktuelle oplysninger, på internettet – mens det første lader routeren gætte. Kontroller også, at ingen par af beskrivelser overlapper: to agenter beskrevet i lignende vendinger vil producere ustabil routing fra én kørsel til den næste.
Komplet eksempel
Her er den kondenserede version, hvor handoffs sendes direkte under oprettelsen af routeren, da specialisterne allerede eksisterer på det tidspunkt.
from mistralai.client import Mistral
import os
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
# 1. Specialist agents
research = client.beta.agents.create(
model="mistral-large-latest",
name="research-agent",
description="Online information search with sources.",
tools=[{"type": "web_search"}]
)
analyst = client.beta.agents.create(
model="mistral-large-latest",
name="analyst-agent",
description="Data analysis and calculations with Python.",
tools=[{"type": "code_interpreter"}]
)
writer = client.beta.agents.create(
model="mistral-large-latest",
name="writer-agent",
description="Drafting structured and professional reports.",
instructions="Write clear reports with an introduction, analysis, and recommendations."
)
# 2. Router with handoffs
router = client.beta.agents.create(
model="mistral-large-latest",
name="router",
description="Orchestrates complex requests.",
instructions="Analyze the request and transfer to the appropriate specialist.",
handoffs=[research.id, analyst.id, writer.id]
)
# 3. Launch
response = client.beta.conversations.start(
agent_id=router.id,
inputs="Analyze the European cloud computing market in 2026: size, players, trends."
)
Vigtige pointer
- Opret specialiserede agenter med præcise, opgaveorienterede beskrivelser
- Routeren bruger beskrivelser til at vælge mål-agenten
client.beta.agents.update(handoffs=[...])definerer overførselsmål- Handoffs kan være nestede (agent A → agent B → agent C)
- Hver agents beskrivelse er den primære løftestang for routing-kvaliteten