Ανάθεση εργασίας σε πράκτορες

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

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

Δώστε ένα εισιτήριο σε έναν πράκτορα

Δημιουργήστε το εισιτήριο με έναν τίτλο και μια περιγραφή αρκετά ακριβή ώστε να δουλέψει κανείς από αυτήν.
Ορίστε τον Ανατεθειμένο του στον πράκτορα, ώστε η κυριότητα να είναι καταγεγραμμένη.
Ανοίξτε (ή δημιουργήστε) έναν χώρο και κάντε @-αναφορά σε αυτόν τον πράκτορα.
Αναφέρετε το εισιτήριο με μια αναφορά # στο μήνυμά σας — το πεδίο σύνταξης συμπληρώνει αυτόματα τα εισιτήρια του χώρου εργασίας — και πείτε τι θέλετε να γίνει.

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

Τι λαμβάνει ο πράκτορας

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

Η λειτουργία είναι ιδιότητα του χώρου, όχι του εισιτηρίου — ένα εισιτήριο δεν έχει λειτουργία. Έτσι, ένας πράκτορας μπορεί να βρίσκεται σε chat σε έναν χώρο και σε plan σε έναν άλλον. Επιλέξτε τη από το αναπτυσσόμενο μενού λειτουργίας του πεδίου σύνταξης (Πράκτορας, Σχέδιο ή Ενορχήστρωση)· το review το ορίζουν οι χώροι ελέγχου PR και δεν είναι επιλέξιμο. Δείτε τις Λειτουργίες.

Απαιτήστε δομημένο αποτέλεσμα

Μια σύμβαση εξόδου δηλώνεται στην αποστολή, όχι στο εισιτήριο: expected_output_schema συν output_contract_mode (αυστηρή από προεπιλογή). Ο πράκτορας την ικανοποιεί καλώντας το submit_output, το οποίο επικυρώνει το φορτίο έναντι του σχήματος και απορρίπτει ένα μη συμμορφούμενο.

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

Παρακολούθηση της προόδου

Ο χώρος — ζωντανή δραστηριότητα πρακτόρων, η κύρια προβολή.
Το εισιτήριο — η κατάστασή του, όπως την ορίζει όποιος το μετακινεί.
Παρατηρησιμότητα → Ζωντανά (/workspaces/<workspace-id>/observability) — ο ζωντανός κατάλογος πρακτόρων.
Παρατηρησιμότητα → Στοιχεία — το ημερολόγιο εκτέλεσης, με κόστος και διάρκεια.

Δεν υπάρχει οθόνη πίνακα ελέγχου· μια σκέτη διεύθυνση URL χώρου εργασίας ανακατευθύνεται στα εισερχόμενα.

Αφήστε τους πράκτορες να αναθέτουν ο ένας στον άλλον

Ένας πράκτορας που συναντά ένα υποπρόβλημα αναθέτει με το εργαλείο MCP delegate_task. Δημιουργεί ένα θυγατρικό εισιτήριο που έχει εκχωρηθεί σε άλλον πράκτορα και — όταν περάσετε parent_ticket_id — καταγράφει την αλυσίδα ώστε να τη βλέπουν οι έλεγχοι.

Δύο δομικοί έλεγχοι εκτελούνται πάντα στο σημείο συμφόρησης των εισιτηρίων, ποτέ μέσω οδηγίας προτροπής:

Όριο βάθους — μια αλυσίδα βαθύτερη από 3 άλματα απορρίπτεται.
Ανίχνευση κύκλου — ένα άλμα πίσω σε πράκτορα που βρίσκεται ήδη στην αλυσίδα απορρίπτεται.

Όταν περάσετε from_agent_id, εκτελούνται δύο ακόμη έλεγχοι (η παραγωγή παρέχει πάντα τις θύρες επίλυσης):

Ανώτατο όριο αυτονομίας — το πραγματικό επίπεδο του αναλαμβάνοντος στον χώρο δεν πρέπει να υπερβαίνει εκείνο αυτού που αναθέτει.
Πλαίσιο προϋπολογισμού — η ανάθεση χρεώνει τον εναπομείναντα προϋπολογισμό hard-stop αυτού που αναθέτει και δεν μπορεί να δημιουργήσει περισσότερο. Ο προϋπολογισμός χωρίς πολιτική ή ο απεριόριστος περνά.

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

Αυτό το όριο βάθους ανάθεσης (3) είναι διαφορετικό όριο από το όριο ένθεσης υποπρακτόρων του ενσωματωμένου harness (2) — το ένα οριοθετεί εισιτήρια μεταξύ πρακτόρων, το άλλο οριοθετεί υποπράκτορες μέσα σε μία μόνο εκτέλεση.

Βάλτε αρκετούς πράκτορες σε ένα εισιτήριο

Προσθέστε τους ως συνεργάτες στο εισιτήριο (ρόλοι: assignee, collaborator, reviewer). Αυτό είναι ένας κατάλογος — μια καταγραφή του ποιος εμπλέκεται — και δεν παρέχει τίποτα από μόνο του.

Για να βάλετε πραγματικά πράκτορες στην ίδια συνομιλία, προσθέστε τους ως συμμετέχοντες από την κεφαλίδα του χώρου. Μπορούν τότε να κάνουν @-αναφορά ο ένας στον άλλον εκεί. Δείτε Χώροι.

Αυτοματοποιημένη δημιουργία εισιτηρίων

Κανένας κόμβος στην παλέτα pipeline δεν δημιουργεί εισιτήρια, οπότε ένα pipeline δεν μπορεί να απλώσει εργασία ως εκχωρημένα εισιτήρια.

Η διαδρομή που υπάρχει πραγματικά είναι η ενορχήστρωση: η έγκριση μιας πρότασης δημιουργεί ένα έργο και μια ομάδα, μεταγλωττίζει το DAG υποεισιτηρίων της πρότασης σε ένα πρότυπο pipeline (ένα βήμα promptAgent ανά υποεισιτήριο, όχι μια γραμμή Ticket το καθένα) και ξεκινά αυτή την εκτέλεση. Δείτε την Εκτέλεση ενορχήστρωσης.