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

Δημιουργία εξειδικευμένων πρακτόρων και δρομολογητή

Μάθημα 13 / 18 Ενημερώθηκε 3 Νοεμβρίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Από τη θεωρία στην πράξη
  2. Βήμα 1: Δημιουργία των ειδικών πρακτόρων
  3. Βήμα 2: Δημιουργία του πράκτορα-δρομολογητή
  4. Βήμα 3: Ορισμός στόχων μεταβίβασης
  5. Βήμα 4: Έναρξη της συνομιλίας
  6. Ο κύριος μοχλός: η περιγραφή
  7. Πλήρες παράδειγμα
  8. Βασικά σημεία

Από τη θεωρία στην πράξη

Το προηγούμενο μάθημα εισήγαγε την έννοια των μεταβιβάσεων (handoffs). Τώρα θα κατασκευάσετε το πλήρες σύστημα ακολουθώντας τη σωστή σειρά: πρώτα τους ειδικούς πράκτορες, μετά τον δρομολογητή, έπειτα τη σύνδεση μεταξύ τους και τέλος τη συνομιλία που θέτει τα πάντα σε κίνηση. Αυτή η σειρά δεν είναι τυχαία· ο δρομολογητής μπορεί να δείξει μόνο σε πράκτορες που υπάρχουν ήδη.

Βήμα 1: Δημιουργία των ειδικών πρακτόρων

Κάθε πράκτορας λαμβάνει ένα ακριβές πεδίο εμπειρογνωμοσύνης και τίποτα άλλο.

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
web_agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="web-search-agent",
    description="Πράκτορας που αναζητά πληροφορίες online.",
    instructions="Εκτελέστε ακριβείς αναζητήσεις στο web. Να αναφέρετε πάντα τις πηγές σας.",
    tools=[{"type": "web_search"}]
)

# Οικονομικός πράκτορας
finance_agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="finance-agent",
    description="Πράκτορας εξειδικευμένος σε οικονομικές ερωτήσεις.",
    instructions="""Είστε οικονομικός εμπειρογνώμονας.
- Χρησιμοποιήστε αριθμητικά δεδομένα
- Εξηγήστε τις έννοιες με σαφήνεια
- Επισημάνετε τους κινδύνους"""
)

# Πράκτορας υπολογισμών
calculator_agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="calculator-agent",
    description="Πράκτορας για λεπτομερείς μαθηματικούς υπολογισμούς.",
    instructions="Εξηγήστε κάθε βήμα του υπολογισμού. Χρησιμοποιήστε τον διερμηνέα κώδικα για πολύπλοκους υπολογισμούς.",
    tools=[{"type": "code_interpreter"}]
)

Αυτά τα τέσσερα πεδία παίζουν πολύ διαφορετικούς ρόλους και ένα αξίζει ιδιαίτερη προσοχή. Το name σε μορφή kebab-case προορίζεται για εσάς: εμφανίζεται στα αρχεία καταγραφής (logs) και τις δοκιμές σας, και ένα ευανάγνωστο όνομα σας γλιτώνει από τη σύγκριση ασαφών ID. Οι instructions απευθύνονται στο μοντέλο μόλις αρχίσει να εργάζεται, οπότε πρέπει να είναι ειδικές για τον τομέα—η φράση «επισημάνετε τους κινδύνους» έχει νόημα για έναν οικονομικό πράκτορα, ενώ το «να είστε χρήσιμοι» δεν σημαίνει τίποτα για κανέναν. Τα tools ακολουθούν την αρχή της αυστηρής αναγκαιότητας: ο παραπάνω οικονομικός πράκτορας δεν έχει εργαλεία επειδή συλλογίζεται χωρίς να τα χρειάζεται, και η παροχή εργαλείων θα προσκαλούσε απλώς κατάχρηση. Τέλος, το description δεν είναι τεκμηρίωση: είναι το κείμενο που διαβάζει ο δρομολογητής για να αποφασίσει αν θα μεταφέρει εδώ ή αλλού.

Βήμα 2: Δημιουργία του πράκτορα-δρομολογητή

Ο δρομολογητής δεν έχει εργαλεία. Ολόκληρη η εργασία του συνίσταται στην ανάλυση του αιτήματος και την επιλογή του παραλήπτη.

router_agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="router-agent",
    description="Πράκτορας δρομολογητής που κατανέμει τα αιτήματα.",
    instructions="""Είστε ένας συντονιστής.
Αναλύστε κάθε αίτημα και μεταφέρετέ το στον σωστό πράκτορα:
- Ερωτήσεις που απαιτούν online δεδομένα → web-search-agent
- Οικονομικές ερωτήσεις → finance-agent
- Υπολογισμοί και αριθμητική ανάλυση → calculator-agent

Μην απαντάτε ποτέ απευθείας—μεταφέρετε πάντα."""
)

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

Βήμα 3: Ορισμός στόχων μεταβίβασης

Τώρα πρέπει να πείτε στον δρομολογητή σε ποιους πράκτορες επιτρέπεται να μεταφέρει.

router_agent = client.beta.agents.update(
    agent_id=router_agent.id,
    handoffs=[web_agent.id, finance_agent.id, calculator_agent.id]
)

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

# Ο οικονομικός πράκτορας μπορεί να μεταφέρει στην αναζήτηση web και στον υπολογιστή
finance_agent = client.beta.agents.update(
    agent_id=finance_agent.id,
    handoffs=[web_agent.id, calculator_agent.id]
)

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

Βήμα 4: Έναρξη της συνομιλίας

response = client.beta.conversations.start(
    agent_id=router_agent.id,
    inputs="Βρείτε το τρέχον βασικό επιτόκιο της ΕΚΤ και υπολογίστε τον ανατοκισμό για 10 χρόνια για 100.000€."
)

# Ανάλυση της ροής
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]}...")

Εκτελέστε αυτό το αίτημα και παρατηρήστε το ίχνος (trace) πριν δείτε την απάντηση. Θα πρέπει να δείτε δύο μεταβιβάσεις και τουλάχιστον μία εκτέλεση εργαλείου· αν δεν δείτε καμία, ο δρομολογητής απάντησε μόνος του και είναι ώρα να αυστηροποιήσετε τις οδηγίες του.

Ο κύριος μοχλός: η περιγραφή

Όταν η δρομολόγηση αποτυγχάνει, σχεδόν πάντα φταίει η περιγραφή. Ο δρομολογητής δεν γνωρίζει τις προθέσεις σας· διαβάζει μόνο αυτό το κείμενο για κάθε υποψήφιο πράκτορα.

# Κακή — πολύ ασαφής
description="Ένας χρήσιμος πράκτορας."

# Καλή — ο δρομολογητής γνωρίζει πότε να μεταφέρει
description="Πράκτορας που αναζητά τρέχουσες πληροφορίες στο Διαδίκτυο και αναφέρει τις πηγές του."

Γράψτε κάθε περιγραφή ως απάντηση στην ερώτηση «σε ποια περίπτωση πρέπει να καλέσω αυτόν τον πράκτορα;» και όχι ως σύνοψη του τι είναι. Το δεύτερο παράδειγμα ονομάζει την κατάσταση—τρέχουσες πληροφορίες, στο Διαδίκτυο—ενώ το πρώτο αφήνει τον δρομολογητή να μαντεύει. Επίσης, επαληθεύστε ότι κανένα ζεύγος περιγραφών δεν επικαλύπτεται: δύο πράκτορες που περιγράφονται με παρόμοιους όρους θα παράγουν ασταθή δρομολόγηση από την μία εκτέλεση στην επόμενη.

Πλήρες παράδειγμα

Εδώ είναι η συνοπτική έκδοση, με τα handoffs να περνιούνται απευθείας κατά τη δημιουργία του δρομολογητή, καθώς οι ειδικοί υπάρχουν ήδη εκείνο το σημείο.

from mistralai.client import Mistral
import os

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

# 1. Ειδικοί πράκτορες
research = client.beta.agents.create(
    model="mistral-large-latest",
    name="research-agent",
    description="Αναζήτηση online πληροφοριών με πηγές.",
    tools=[{"type": "web_search"}]
)

analyst = client.beta.agents.create(
    model="mistral-large-latest",
    name="analyst-agent",
    description="Ανάλυση δεδομένων και υπολογισμοί με Python.",
    tools=[{"type": "code_interpreter"}]
)

writer = client.beta.agents.create(
    model="mistral-large-latest",
    name="writer-agent",
    description="Σύνταξη δομημένων και επαγγελματικών αναφορών.",
    instructions="Γράψτε καθαρές αναφορές με εισαγωγή, ανάλυση και συστάσεις."
)

# 2. Δρομολογητής με μεταβιβάσεις
router = client.beta.agents.create(
    model="mistral-large-latest",
    name="router",
    description="Συντονίζει σύνθετα αιτήματα.",
    instructions="Αναλύστε το αίτημα και μεταφέρετέ το στον κατάλληλο ειδικό.",
    handoffs=[research.id, analyst.id, writer.id]
)

# 3. Εκκίνηση
response = client.beta.conversations.start(
    agent_id=router.id,
    inputs="Αναλύστε την ευρωπαϊκή αγορά cloud computing το 2026: μέγεθος, παίκτες, τάσεις."
)

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

  • Δημιουργήστε ειδικούς πράκτορες με ακριβείς περιγραφές προσανατολισμένες στην εργασία
  • Ο δρομολογητής χρησιμοποιεί τις περιγραφές για να επιλέξει τον πράκτορα-στόχο
  • Το client.beta.agents.update(handoffs=[...]) ορίζει τους στόχους μεταφοράς
  • Οι μεταβιβάσεις μπορούν να είναι εμφωλευμένες (πράκτορας Α → πράκτορας Β → πράκτορας Γ)
  • Η περιγραφή κάθε πράκτορα είναι ο κύριος μοχλός για την ποιότητα της δρομολόγησης