Edasiandmised: mitme agendi orkestreerimine
Sellel lehel
Edasiandmised: mitme agendi orkestreerimine
Üksik agent ei suuda kõike teha. Mida rohkem valdkondi ühte juhendikomplekti kuhjad, seda rohkem hakkavad reeglid omavahel vastuollu minema ja seda leigemaks muutuvad vastused. Edasiandmised võimaldavad agendil vestluse delegeerida teisele spetsialiseerunud agendile. See on võtmemehhanism mitmeagendiliste süsteemide loomisel, kus iga agent paistab silma just oma valdkonnas.
Edasiandmise kontseptsioon
Edasiandmine on kontrolli ülekanne ühelt agendilt teisele. Kui Agent A annab asja edasi Agendile B, võtab Agent B ohjad enda kätte ja genereerib vastuse. Runner haldab seda üleminekut automaatselt: sa ei pea kirjutama eksplitiitset suunamisloogikat ega kutsuma teist agenti käsitsi. Allpool toodud näites saab triaažiagent kaebuse arve summa kohta, tuvastab valdkonna ja annab teatepulga edasi. Klient näeb seejuures vaid üht katkematut vestlust.
from agents import Agent, Runner
billing_agent = Agent(
name="Billing Agent",
instructions="""You handle billing questions: invoices, payments,
refunds, subscriptions. Respond precisely and professionally.""",
model="gpt-5.6-terra",
)
technical_agent = Agent(
name="Technical Agent",
instructions="""You handle technical support: bugs, configuration,
installation, troubleshooting. Provide step-by-step instructions.""",
model="gpt-5.6-terra",
)
triage_agent = Agent(
name="Triage Agent",
instructions="""You are the first point of contact.
Analyze the customer's request and transfer it to the appropriate agent.
- Billing questions → Billing Agent
- Technical questions → Technical Agent""",
handoffs=[billing_agent, technical_agent],
model="gpt-5.6-terra",
)
result = Runner.run_sync(
triage_agent,
"My latest invoice seems incorrect; the amount is too high."
)
# The triage agent hands off to the billing agent
print(f"Answered by: {result.last_agent.name}")
print(result.final_output)
Edasiandmise kirjelduse kohandamine
Vaikimisi kasutab edasiandmine sihtagendi nime ja juhiseid. See toimib hästi, kui nimed on kirjeldavad, kuid muutub riskantseks, kui kaks agenti on üksteisega sarnased. Sellistel juhtudel saad kirjeldust kohandada, loetledes konkreetsed stsenaariumid, mis peaksid iga ülekande käivitama, et suunamist täpsemaks muuta.
from agents import Handoff
triage_agent = Agent(
name="Triage Agent",
instructions="Transfer the request to the specialized agent.",
handoffs=[
Handoff(
agent=billing_agent,
description="Transfer for payment questions, invoices, refunds, and subscriptions.",
),
Handoff(
agent=technical_agent,
description="Transfer for technical issues, bugs, and configuration help requests.",
),
],
)
Edasiandmised kontekstiga
Ülekanne on kasulik vaid siis, kui üle võttev agent teab, mis toimub. Kui agent teeb edasiandmise, antakse vestluse ajalugu sihtagendile edasi: uuel agendil on juurdepääs kõigele senisele, nii et kliendil ei pea oma probleemi kordama. Sellele lisaks kannab tüübitud kontekst edasi struktureeritud sessiooniandmeid – kliendi ID, tellitud pakett, varasemad pöördumised – ja need jäävad saabuva agendi tööriistadele kättesaadavaks.
from dataclasses import dataclass
from agents import Agent, Runner, RunContextWrapper, function_tool
@dataclass
class CustomerContext:
client_id: str
plan: str
ticket_history: list[str]
@function_tool
def view_invoice(ctx: RunContextWrapper[CustomerContext], month: str) -> str:
"""Views the invoice for a given month for the current customer."""
client_id = ctx.context.client_id
return f"Invoice for {month} for {client_id}: €149.99 (plan {ctx.context.plan})"
billing_agent = Agent(
name="Billing Agent",
instructions="You handle billing. Use the customer context.",
tools=[view_invoice],
model="gpt-5.6-terra",
)
triage_agent = Agent(
name="Triage",
instructions="Transfer to the right agent.",
handoffs=[billing_agent],
model="gpt-5.6-terra",
)
context = CustomerContext(
client_id="cli_456",
plan="Pro",
ticket_history=["Ticket #001: Slow connection"]
)
result = Runner.run_sync(
triage_agent,
"Can you check my invoice for March?",
context=context,
)
Muster: kolmetasemeline triaaž
Edasiandmised ei piirdu horisontaalse suunamisega. Need jäljendavad ka päris tugiteenuse eskaleerimisstruktuuri. Siin on tootmismuster kolme tasemega: L1 tegeleb rutiinsete päringutega, suunab keerukamad konfiguratsiooniprobleemid L2-le ning L2 eskaleerib arhitektuuriteemad L3-le. Pane tähele, et tase 3 tugineb võimekamale mudelile, kuna see näeb vaid juhtumeid, mille on eelnevalt filtreerinud kaks esimest taset.
level3_agent = Agent(
name="L3 Technical Expert",
instructions="""You are a level 3 technical expert.
You handle complex architecture and infrastructure problems.
If you cannot resolve the issue, indicate that human escalation is necessary.""",
model="gpt-5.6-sol", # The most capable model for complex cases
)
level2_agent = Agent(
name="L2 Technical Support",
instructions="""You are a level 2 technician.
You handle advanced configuration problems.
If the problem is too complex, transfer to level 3.""",
handoffs=[level3_agent],
model="gpt-5.6-terra",
)
level1_agent = Agent(
name="L1 Customer Support",
instructions="""You are the first point of contact for customer support.
Handle simple questions (password, account, navigation).
Transfer technical problems to level 2.""",
handoffs=[level2_agent],
model="gpt-5.6-terra",
)
Kahepoolsed edasiandmised
Ahel võib olla ka ringikujuline: kaks agenti saavad kontrolli edasi-tagasi anda. See on tüüpiline olukorras, kus potentsiaalne klient küsib müügivestluse käigus tehnilist küsimust ja pöördub seejärel, kui on rahustatud, tagasi hinnete juurde.
sales_agent = Agent(
name="Sales Agent",
instructions="""You sell products. If the customer asks
for technical support, transfer to the technical agent.""",
)
support_agent = Agent(
name="Support Agent",
instructions="""You provide technical support. If the customer
wants to buy something, transfer to the sales agent.""",
)
# Bidirectional handoffs
sales_agent.handoffs = [support_agent]
support_agent.handoffs = [sales_agent]
Hoia silm peal lõpmatutel tsüklitel: soovitatav on kasutada kaitsepiirangut või max_turns. Ilma selle piiranguta võib ebaselge päring põhjustada vestluse pommitamise ühelt agendilt teisele, kuni sinu kvoot on ammendunud.
Edasiandmiste jälgimine
Lõpuks pead teadma, kes tegelikult vastas – nii suunamise kontrollimiseks kui ka tugistatistika jaoks. RunResult ütleb sulle, milline agent lõpliku vastuse produtseeris.
result = Runner.run_sync(triage_agent, "I have a critical bug")
print(f"Initial agent: triage_agent")
print(f"Final agent: {result.last_agent.name}")
# Prints "Technical Agent" if triage worked correctly
Harjuta selle väärtuse logimist: kui triaažiagent hoiab endale päringuid, mille ta oleks pidanud edasi andma, paljastab last_agent jaotus probleemi ammu enne, kui klientide tagasiside seda teeb.
Peamised punktid
- Edasiandmised võimaldavad vestluse delegeerida spetsialiseerunud agendile
- Vestluse ajalugu antakse sihtagendile edasi
- Kasuta suunamise juhendamiseks
Handoff(agent=..., description=...) - Jagatud kontekst (
RunContextWrapper) on kõigile agentidele kättesaadav result.last_agent.namenäitab, milline agent lõpuks vastas- Kaitske kahepoolseid edasiandmisi
max_turns-iga, et vältida tsükleid