Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Μεταβιβάσεις: Συντονισμός Πολλαπλών Πρακτόρων

Μάθημα 12 / 25 Ενημερώθηκε 29 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Μεταβιβάσεις: Συντονισμός Πολλαπλών Πρακτόρων
  2. Η Έννοια της Μεταβίβασης
  3. Προσαρμογή της Περιγραφής Μεταβίβασης
  4. Μεταβιβάσεις με Συμφραζόμενα
  5. Πρότυπο: Διαλογή Τριών Επιπέδων
  6. Αμφίδρομες Μεταβιβάσεις
  7. Παρακολούθηση Μεταβιβάσεων
  8. Βασικά σημεία

Μεταβιβάσεις: Συντονισμός Πολλαπλών Πρακτόρων

Ένας μοναδικός πράκτορας δεν μπορεί να κάνει τα πάντα. Όσο περισσότερους τομείς συσσωρεύετε σε ένα σύνολο οδηγιών, τόσο περισσότερο οι κατευθυντήριες γραμμές έρχονται σε αντίθεση μεταξύ τους και οι απαντήσεις γίνονται χλιαρές. Οι Μεταβιβάσεις (Handoffs) επιτρέπουν σε έναν πράκτορα να αναθέτει τη συνομιλία σε έναν άλλον εξειδικευμένο πράκτορα. Αυτός είναι ο βασικός μηχανισμός για τη δημιουργία συστημάτων πολλαπλών πρακτόρων, όπου κάθε πράκτορας διαπρέπει στον δικό του τομέα.

Η Έννοια της Μεταβίβασης

Μια μεταβίβαση αποτελεί τη μεταφορά του ελέγχου από έναν πράκτορα σε έναν άλλον. Όταν ο Πράκτορας Α κάνει μεταβίβαση στον Πράκτορα Β, ο Πράκτορας Β αναλαμβάνει και παράγει την απάντηση. Ο Runner διαχειρίζεται αυτή τη μετάβαση αυτόματα: δεν γράφετε ρητή λογική δρομολόγησης ούτε καλείτε χειροκίνητα τον δεύτερο πράκτορα. Στο παρακάτω παράδειγμα, ο πράκτορας διαλογής (triage) λαμβάνει ένα παράπονο σχετικά με το ποσό ενός τιμολογίου, αναγνωρίζει τον τομέα και περνά τη σκυτάλη. Ο πελάτης, εν τω μεταξύ, βλέπει μόνο μία συνεχόμενη συνομιλία.

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)

Προσαρμογή της Περιγραφής Μεταβίβασης

Εξ ορισμού, μια μεταβίβαση χρησιμοποιεί το όνομα και τις οδηγίες του πράκτορα-στόχου. Αυτό λειτουργεί καλά εφόσον τα ονόματα είναι περιγραφικά, αλλά γίνεται επικίνδυνο όταν δύο πράκτορες μοιάζουν μεταξύ τους. Σε αυτές τις περιπτώσεις, μπορείτε να προσαρμόσετε την περιγραφή για να καθοδηγήσετε τη δρομολόγηση, παραθέτοντας τα συγκεκριμένα σενάρια που θα πρέπει να ενεργοποιούν κάθε μεταφορά.

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.",
        ),
    ],
)

Μεταβιβάσεις με Συμφραζόμενα

Μια μεταφορά είναι χρήσιμη μόνο εάν ο πράκτορας που αναλαμβάνει γνωρίζει τι συμβαίνει. Όταν ένας πράκτορας εκτελεί μια μεταβίβαση, το ιστορικό της συνομιλίας περνά στον πράκτορα-στόχο: ο νέος πράκτορας έχει πρόσβαση σε όλα όσα έχουν ειπωθεί μέχρι στιγμής, ώστε ο πελάτης να μην χρειάζεται να επαναλάβει το πρόβλημά του. Επιπλέον, τα τυποποιημένα συμφραζόμενα (typed context) μεταφέρουν δομημένα δεδομένα συνεδρίας—ID πελάτη, συνδρομητικό πλάνο, προηγούμενα tickets—και παραμένουν προσβάσιμα στα εργαλεία του εισερχόμενου πράκτορα.

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,
)

Πρότυπο: Διαλογή Τριών Επιπέδων

Οι μεταβιβάσεις δεν περιορίζονται στην οριζόντια δρομολόγηση. Αναπαράγουν επίσης τη δομή κλιμάκωσης μιας πραγματικής υπηρεσίας υποστήριξης. Ακολουθεί ένα πρότυπο παραγωγής με τρία επίπεδα: το L1 διαχειρίζεται συνήθη ερωτήματα, μεταφέρει θέματα προηγμένης διαμόρφωσης στο L2, και το L2 κλιμακώνει θέματα αρχιτεκτονικής στο L3. Σημειώστε ότι το επίπεδο 3 βασίζεται σε ένα πιο ικανό μοντέλο, καθώς βλέπει μόνο περιπτώσεις που έχουν ήδη φιλτραριστεί από τα δύο προηγούμενα επίπεδα.

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",
)

Αμφίδρομες Μεταβιβάσεις

Η αλυσίδα μπορεί επίσης να είναι κυκλική: δύο πράκτορες μπορούν να μεταφέρουν τον έλεγχο μπρος-πίσω. Αυτό είναι τυπικό όταν ένας υποψήφιος πελάτης θέτει μια τεχνική ερώτηση κατά τη διάρκεια μιας συνομιλίας πωλήσεων και στη συνέχεια επιστρέφει στις τιμές μόλις καθησυχαστεί.

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]

Προσοχή στους ατέρμονους βρόχους: συνιστάται η χρήση ενός μηχανισμού προστασίας (guardrail) ή του max_turns. Χωρίς αυτό το όριο, ένα ασαφές αίτημα μπορεί να αναπηδά τη συνομιλία από τον έναν πράκτορα στον άλλον μέχρι να εξαντληθεί η ποσόστωσή σας.

Παρακολούθηση Μεταβιβάσεων

Τέλος, πρέπει να γνωρίζετε ποιος απάντησε πραγματικά—τόσο για να επαληθεύσετε τη δρομολόγησή σας όσο και για τα στατιστικά στοιχεία υποστήριξής σας. Το RunResult σας λέει ποιος πράκτορας παρήγαγε τελικά την απάντηση.

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

Κάντε συνήθεια να καταγράφετε αυτή την τιμή: εάν ένας πράκτορας διαλογής διατηρεί τον έλεγχο αιτημάτων που θα έπρεπε να είχε μεταβιβάσει, η κατανομή του last_agent θα αποκαλύψει το ζήτημα πολύ πριν από τα σχόλια των πελατών.

Βασικά σημεία

  • Οι μεταβιβάσεις σάς επιτρέπουν να αναθέτετε τη συνομιλία σε έναν εξειδικευμένο πράκτορα
  • Το ιστορικό της συνομιλίας περνά στον πράκτορα-στόχο
  • Χρησιμοποιήστε Handoff(agent=..., description=...) για να καθοδηγήσετε τη δρομολόγηση
  • Τα κοινά συμφραζόμενα (RunContextWrapper) είναι προσβάσιμα σε όλους τους πράκτορες
  • Το result.last_agent.name υποδεικνύει ποιος πράκτορας απάντησε τελικά
  • Προστατεύστε τις αμφίδρομες μεταβιβάσεις με max_turns για την αποφυγή βρόχων