Aistrithe: Comhordú Ilghníomhairí
Ar an leathanach seo
Aistrithe: Comhordú Ilghníomhairí
Ní féidir le gníomhaire amháin gach rud a dhéanamh. Dá mhéad fearann a chuireann tú le chéile in aon tacar treoracha amháin, is ea is mó a bheidh na treoirlínte ag cur ina chéile agus is ea is laige a bheidh na freagraí. Ligeann aistrithe do ghníomhaire an comhrá a tharmligean do ghníomhaire speisialaithe eile. Seo an mheicníocht lárnach chun córais ilghníomhairí a thógáil ina mbíonn gach gníomhaire sármhaith ina fhearann féin.
Coincheap an Aistrithe
Is aistriú rialaithe ó ghníomhaire amháin go gníomhaire eile é aistriú. Nuair a dhéanann Gníomhaire A aistriú chuig Gníomhaire B, glacann Gníomhaire B seilbh agus gintear an freagra. Déileálann an Reathaí (Runner) leis an aistriú seo go huathoibríoch: ní gá duit loighic ródúcháin shainráite a scríobh ná an dara gníomhaire a ghlaoidh de láimh. Sa sampla thíos, faigheann an gníomhaire triáiste gearán faoi mhéid sonraisc, aithníonn sé an fearann, agus pasálann sé an bhata. Idir an dá linn, ní fheiceann an custaiméir ach comhrá leanúnach amháin.
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)
Cur síos ar an Aistriú a Shaincheapadh
De réir réamhshocraithe, úsáideann aistriú ainm agus treoracha an ghníomhaire sprioc. Feidhmíonn sé seo go maith fad is atá na hainmneacha cur síosach, ach éiríonn sé rioscach nuair a bhíonn dhá ghníomhaire cosúil le chéile. Sna cásanna sin, is féidir leat an cur síos a shaincheapadh chun an ródúchán a threorú trí na cásanna sonracha a liostú ba chóir gach aistriú a spreagadh.
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.",
),
],
)
Aistrithe le Comhthéacs
Níl aon mhaith in aistriú mura bhfuil a fhios ag an ngníomhaire a ghlacann seilbh cad atá ar siúl. Nuair a dhéanann gníomhaire aistriú, cuirtear stair an chomhrá ar aghaidh chuig an ngníomhaire sprioc: tá rochtain ag an ngníomhaire nua ar gach rud a rádh go dtí seo, mar sin ní gá don chustaiméir a fhadhb a athrá. Ina theannta sin, iompraíonn comhthéacs típithe sonraí seisiún struchtúrtha—ID custaiméara, plean síntiúis, ticéid roimhe seo—agus fanann siad inrochtana d’uirlisí an ghníomhaire istigh.
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,
)
Patrún: Triáiste Trí Leibhéal
Níl aistrithe teoranta do ródúchán cothrománach. Atáirgeann siad struchtúr éalaithe seirbhíse tacaíochta fíor freisin. Seo patrún táirgeachta le trí leibhéal: déileálann L1 le fiosruithe gnáthacha, aistríonn sé fadhbanna cumraíochta casta chuig L2, agus déanann L2 éalú ar ábhair ailtireachta chuig L3. Tabhair faoi deara go mbraitheann leibhéal 3 ar mhúnla níos cumasaí, ós rud é nach bhfeiceann sé ach cásanna a scagadh cheana féin ag an dá shraith roimhe.
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",
)
Aistrithe Déthreoch
Is féidir leis an slabhra a bheith ciorclach freisin: is féidir le dhá ghníomhaire rialú a aistriú ar ais agus ar aghaidh. Is gnách é seo nuair a chuireann ionchas ceist theicniúil le linn comhrá díolacháin, agus ansin filleann sé ar phraghsáil nuair a bhíonn muinín aige.
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]
Bí ar an airdeall maidir le lúba gan teorainn: moltar cosaint (guardrail) nó max_turns. Gan an teorainn seo, is féidir le hiarratas débhríoch an comhrá a chaitheamh ó ghníomhaire amháin go gníomhaire eile go dtí go mbeidh do chuóta ídithe.
Aistrithe a Rianú
Ar deireadh, ní mór duit a fháil amach cé a thug an freagra i ndáiríre—chun do ródúchán a fhíorú agus do staitisticí tacaíochta. Inseoidh an RunResult duit cé an gníomhaire a tháirg an freagra sa deireadh.
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
Déan cleachtas de luach seo a logáil: má choinníonn gníomhaire triáiste seilbh ar iarratais ba chóir dó a aistriú, nochtfaidh dáileadh last_agent an fhadhb i bhfad roimh aiseolas ó chustaiméirí.
Príomhphointí
- Ligeann aistrithe duit an comhrá a tharmligean do ghníomhaire speisialaithe
- Cuirtear stair an chomhrá ar aghaidh chuig an ngníomhaire sprioc
- Úsáid
Handoff(agent=..., description=...)chun an ródúchán a threorú - Tá comhthéacs roinnte (
RunContextWrapper) inrochtana ag gach gníomhaire - Léiríonn
result.last_agent.namecé an gníomhaire a thug an freagra sa deireadh - Cosain aistrithe déthreoch le
max_turnschun lúba a chosc