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

Εκτέλεση σε Διακομιστή έναντι Πελάτη

Μάθημα 14 / 18 Ενημερώθηκε 3 Νοεμβρίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Δύο Τρόποι Διαχείρισης των Μεταβιβάσεων
  2. Λειτουργία Server, η Προεπιλογή
  3. Λειτουργία Client, Όταν Θέλετε Έλεγχο
  4. Επιλογή Μεταξύ των Δύο
  5. Βασικά σημεία

Μάθημα ενημερώθηκε στις 3 Νοεμβρίου 2026 με βάση το SDK mistralai 3.7.0 και την τεκμηρίωση Handoffs της Mistral: μια καταχώριση agent.handoff αναγνωρίζει τον πράκτορα-στόχο μέσω του next_agent_id (όχι to_agent), και το conversations.append δεν δέχεται παράμετρο agent_id—ο παλαιότερος κώδικας θα απέτυχε. Η επανέναρξη του πράκτορα-στόχου εδώ γίνεται μέσω μιας νέας συνομιλίας, στην οποία περνάτε το πλαίσιο. Πηγές: Handoffs · client-python.

Δύο Τρόποι Διαχείρισης των Μεταβιβάσεων

Όταν ένας πράκτορας μεταβιβάζει τον έλεγχο σε έναν άλλον, το API της Mistral προσφέρει δύο λειτουργίες εκτέλεσης: server (αυτόματη) και client (χειροκίνητη). Η ρύθμιση αποτελείται από μία μόνο λέξη, αλλά καθορίζει ποιος οδηγεί πραγματικά τη ροή εργασίας. Στη λειτουργία server, αναθέτετε ολόκληρη τη χορογραφία στη Mistral και λαμβάνετε το αποτέλεσμα. Στη λειτουργία client, ανακτάτε τον έλεγχο μεταξύ κάθε βήματος. Όλα τα υπόλοιπα—οι πράκτορες, τα εργαλεία τους, οι στόχοι μεταβίβασης—παραμένουν ακριβώς τα ίδια.

Λειτουργία Server, η Προεπιλογή

response = client.beta.conversations.start(
    agent_id=router_agent.id,
    inputs="Analyze and calculate market trends.",
    handoff_execution="server"  # Default — can be omitted
)

Η ροή διαχειρίζεται πλήρως: ο δρομολογητής λαμβάνει το αίτημα, αποφασίζει τη μεταβίβαση στον πράκτορα έρευνας και η Mistral εκτελεί τη μεταβίβαση· ο πράκτορας έρευνας κάνει τη δουλειά του και στη συνέχεια μεταβιβάζει στον υπολογιστή, και η Mistral εκτελεί και αυτό· ο υπολογιστής παράγει το αποτέλεσμα. Εσείς λαμβάνετε την τελική απάντηση, συνοδευόμενη από όλες τις ενδιάμεσες εξόδους—ώστε να βλέπετε τι συνέβη, αλλά εκ των υστέρων.

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

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

Λειτουργία Client, Όταν Θέλετε Έλεγχο

response = client.beta.conversations.start(
    agent_id=router_agent.id,
    inputs="Analyze the cloud market.",
    handoff_execution="client"
)

Ο δρομολογητής λαμβάνει το αίτημα και αποφασίζει τη μεταβίβαση, ακριβώς όπως πριν. Αλλά αντί να εκτελεστεί η μεταβίβαση, εσείς λαμβάνετε ένα συμβάν agent.handoff και η αλυσίδα σταματά εκεί. Εναπόκειται σε εσάς να την επανεκκινήσετε καλώντας τον πράκτορα-στόχο—κάτι που σας αφήνει την ευχέρεια να επικυρώσετε, να καταγράψετε, να εμπλουτίσετε το πλαίσιο ή απλά να αρνηθείτε.

response = client.beta.conversations.start(
    agent_id=router_agent.id,
    inputs="Search for the latest tech news.",
    handoff_execution="client"
)

for entry in response.outputs:
    if entry.type == "agent.handoff":
        target_agent_id = entry.next_agent_id
        print(f"Handoff requested to: {target_agent_id}")

        # Validate, then hand over to the target agent, with useful context
        next_response = client.beta.conversations.start(
            agent_id=target_agent_id,
            inputs="Search for the latest tech news.",
        )

        # Process the target agent's response
        for next_entry in next_response.outputs:
            print(f"{next_entry.type}: {next_entry.content}")

Ένα σημείο αξίζει προσοχής: η τεκμηρίωση της Mistral περιγράφει τη λειτουργία client—ο έλεγχος επιστρέφει σε εσάς κατά τη στιγμή της μεταβίβασης—αλλά δεν παρέχει μέθοδο για να κάνει τον πράκτορα-στόχο να επαναλάβει την ίδια συνομιλία, και το conversations.append δεν δέχεται παράμετρο agent_id. Το παράδειγμα επομένως ξεκινά μια συνομιλία με τον πράκτορα-στόχο, στον οποίο μεταδίδετε ρητά ό,τι χρειάζεται: το αρχικό αίτημα και, αν ισχύει, μια σύνοψη του τι έχει ήδη γίνει. Αυτή είναι επίσης μια ευκαιρία να μεταδώσετε μόνο ό,τι πρέπει να δουν.

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

def execute_with_control(router_id, query):
    """Executes a multi-agent workflow with control at each step."""
    response = client.beta.conversations.start(
        agent_id=router_id,
        inputs=query,
        handoff_execution="client"
    )

    conversation_id = response.conversation_id
    results = []

    while True:
        handoff_found = False

        for entry in response.outputs:
            if entry.type == "agent.handoff":
                handoff_found = True
                target = entry.next_agent_id
                print(f"[LOG] Handoff to {target}")

                # Here you can add: validation, logging, metrics
                response = client.beta.conversations.start(
                    agent_id=target,
                    inputs=query,  # the original request, enriched if needed
                    handoff_execution="client",
                )
                conversation_id = response.conversation_id
                break

            elif entry.type == "message.output":
                results.append(entry.content)

        if not handoff_found:
            break

    return results

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

Επιλογή Μεταξύ των Δύο

Η λειτουργία server καλύπτει την τυπική παραγωγή. Εάν η ροή εργασίας σας είναι προβλέψιμη, εάν εμπιστεύεστε τους πράκτορες που έχετε γράψει, ή εάν δημιουργείτε πρωτότυπα και θέλετε να δείτε αποτελέσματα γρήγορα, η πλήρης αυτοματοποίηση είναι η σωστή επιλογή—και η συγγραφή ενός βρόχου ελέγχου θα ήταν χαμένος κόπος.

Η λειτουργία client δικαιολογείται μόλις εισέλθει στην αλυσίδα μια εξωτερική απαίτηση. Επικύρωση από άνθρωπο, όταν ένας χειριστής πρέπει να εγκρίνει μια μεταβίβαση σε έναν πράκτορα που ενεργοποιεί ευαίσθητες ενέργειες. Ανάγκη για καταγραφή και έλεγχο, όταν η συμμόρφωση απαιτεί την ιχνηλάτηση κάθε βήματος με τα δικά σας αναγνωριστικά και τις δικές σας χρονοσημάνσεις. Υπο condiitional δρομολόγηση, όταν η απόφαση εξαρτάται από επιχειρηματικούς κανόνες που το μοντέλο δεν μπορεί να γνωρίζει—κατάσταση πελάτη, ώρα της ημέρας, ένα όριο. Ένα ανώτατο όριο, ή περιορισμός ρυθμού, όταν θέλετε να οριοθετήσετε τον αριθμό των πρακτόρων που εκτελούνται για ένα αίτημα. Μια στρατηγική εφεδρείας, τέλος, όταν η αποτυχία ενός πράκτορα πρέπει να ενεργοποιήσει κάτι άλλο εκτός από ένα σφάλμα που εμφανίζεται στον χρήστη.

Να πώς φαίνεται η πρώτη από αυτές τις καταστάσεις, μειωμένη στον σκελετό της.

def workflow_with_validation(router_id, query):
    response = client.beta.conversations.start(
        agent_id=router_id,
        inputs=query,
        handoff_execution="client"
    )

    for entry in response.outputs:
        if entry.type == "agent.handoff":
            target = entry.next_agent_id
            approval = input(f"Authorize transfer to {target}? (y/n) ")

            if approval.lower() == "y":
                response = client.beta.conversations.start(
                    agent_id=target,
                    inputs=query,
                )
            else:
                print("Transfer refused.")
                break

Η input της κονσόλας serves ως επίδειξη· σε μια εφαρμογή, θα αντικατασταθεί από μια ειδοποίηση προς έναν χειριστή και από την επανέναρξη της ροής εργασίας όταν φτάσει η απάντηση. Η αρχή παραμένει η ίδια: η μεταβίβαση συμβαίνει μόνο αν ο κώδικάς σας την ενεργοποιήσει.

Η σωστή προσέγγιση είναι να ξεκινήσετε σε λειτουργία server και να αλλάξετε μόνο την ημέρα που μια συγκεκριμένη απαίτηση το απαιτεί. Η μετάβαση στη λειτουργία client «για κάθε περίπτωση» σας κάνει να πληρώσετε άμεσα για την πολυπλοκότητα ενός βρόχου και τα δικτυακά ταξίδια μετ’ επιστροφής, για έναν έλεγχο που δεν χρησιμοποιείτε ακόμη.

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

  • Λειτουργία Server = πλήρως αυτόματη, απλή και γρήγορη, χωρίς ενδιάμεσο έλεγχο
  • Λειτουργία Client = λαμβάνετε συμβάντα μεταβίβασης και αποφασίζετε τι να κάνετε
  • Η λειτουργία client επιτρέπει επικύρωση, καταγραφή, υπο conditional δρομολόγηση και χειρισμό σφαλμάτων
  • Για τις περισσότερες περιπτώσεις, η λειτουργία server είναι επαρκής—μεταβείτε στη λειτουργία client όταν χρειάζεστε έλεγχο
  • Και οι δύο λειτουργίες υποστηρίζουν τις ίδιες αλυσίδες πρακτόρων· μόνο ο έλεγχος διαφέρει