Αποστολή πρακτόρων ελέγχου

Αυτός ο οδηγός δείχνει πώς να αποστείλετε πράκτορες ελέγχου για να ελέγξουν pull requests.

Από την προβολή του PR

1. Ανοίξτε το PR και μεταβείτε στην καρτέλα Επισκόπηση
2. Ανοίξτε το μενού υπερχείλισης ⋯ και επιλέξτε Ερώτηση AI

Αυτό ξεκινά το ενσωματωμένο pipeline pr_review, που ανοίγει τον χώρο ελέγχου του PR και αποστέλλει τους ελεγκτές για το επίπεδο ανασκόπησης του χώρου εργασίας — τρεις από προεπιλογή (τους ενσωματωμένους πράκτορες qa, architect και engineer) — και μετά βάζει τον επικεφαλής πράκτορα να τα ενοποιήσει. Οι ρόλοι δεν επιλέγονται σε αυτή τη διαδρομή. Για έλεγχο του ποιοι ρόλοι εκτελούνται και ποια αρχεία κοιτάζει ο καθένας, χρησιμοποιήστε το εργαλείο MCP ή ένα βήμα pipeline παρακάτω.

Μέσω του εργαλείου MCP dispatch_reviewers

Καλέστε το μέσα από έναν υπάρχοντα χώρο ελέγχου:

dispatch_reviewers(
  space_id: "...",
  workspace_id: "...",
  reviewers: [
    {role: "reviewer"},
    {role: "security", scope: "src/auth/**"}
  ]
)

Τα space_id, workspace_id και reviewers είναι όλα υποχρεωτικά. Κάθε προδιαγραφή ελεγκτή δέχεται ένα role συν ένα προαιρετικό scope μοτίβου αρχείων και ένα prompt_override που αντικαθιστά το προεπιλεγμένο ενημερωτικό σημείωμα. Ένα προαιρετικό concurrency (1–8) περιορίζει τις παράλληλες αποστολές· όταν παραλείπεται, ισχύει η ρύθμιση review_concurrency του χώρου εργασίας (προεπιλογή 3, ορίζεται στις Ρυθμίσεις → Χώρος εργασίας → Γενικά).

Το εργαλείο επιστρέφει αμέσως τις λίστες dispatched και unmatched. Κάθε ελεγκτής που αποστέλλεται προστίθεται στον χώρο ως συμμετέχων, ανακοινώνεται με μήνυμα συστήματος και αποστέλλεται με το ενημερωτικό σημείωμά του. Τα ευρήματα καταχωρίζονται ως μηνύματα review_node σε αυτόν τον χώρο.

Από ένα βήμα pipeline

Ανοίξτε τις Ρυθμίσεις → Χώρος εργασίας → Πρότυπα pipeline, ανοίξτε ένα πρότυπο και μετά:

1. Προσθέστε έναν κόμβο Reviewer (prompt) από την παλέτα
2. Επιλέξτε τον πράκτορα που θα αποστείλετε και γράψτε την προτροπή του ελεγκτή, χρησιμοποιώντας θέσεις υποκατάστασης {{key}} για τα ανάντη αποτελέσματα (για παράδειγμα {{repo_local_path}}, {{pr_number}})
3. Ορίστε το κλειδί εξόδου (προεπιλογή reviewer_findings) ώστε τα κατάντη βήματα να μπορούν να διαβάσουν τα ευρήματα

Το βήμα αποστέλλει τον πράκτορα και αναστέλλεται μέχρι να ολοκληρωθεί αυτή η εκτέλεση. Ο μηχανισμός μετά συλλέγει το ωφέλιμο φορτίο submit_output της εκτέλεσης στην κατάσταση του pipeline κάτω από το κλειδί εξόδου του κόμβου. (Η περιγραφή στην παλέτα εξακολουθεί να λέει ότι το βήμα περιμένει κλήση complete_task — αυτό το εργαλείο δεν υπάρχει· αγνοήστε τη συμβολοσειρά.)

Κάντε διασπορά συνδέοντας αρκετούς κόμβους ελεγκτών στο ίδιο ανάντη βήμα και μετά ενοποιήστε τα αποτελέσματά τους με έναν κόμβο Consolidate (join).

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

Αυτόματη αποστολή σε νέο PR

Για να εκτελεστεί αυτόματα ένα pipeline ανασκόπησης:

1. Ανοίξτε το πρότυπο στις Ρυθμίσεις → Χώρος εργασίας → Πρότυπα pipeline
2. Σύρετε το Δημοσιεύτηκε PR ή το Άνοιξε εξωτερικό PR από την ενότητα Εναύσματα της βιβλιοθήκης κόμβων στον καμβά (ή επιλέξτε το από το πλακίδιο-φάντασμα Προσθήκη εναύσματος)
3. Επιλέξτε τον νέο κόμβο και ενεργοποιήστε την επιλογή Ενεργοποιημένο στον επιθεωρητή του και μετά ενεργοποιήστε το πρότυπο

Δύο γεγονότα έχουν σημασία εδώ και δεν είναι εναλλάξιμα:

Γεγονός	Ενεργοποιείται όταν	Κλειδιά ωφέλιμου φορτίου
PullRequestPublished	Ένα PR ανοίγει μέσω του Control Center — από την επιφάνεια σύνταξης, ή από έναν πράκτορα που καλεί pr_lifecycle.publish	pr_id, workspace_id, repo_owner, repo_name
ExternalPrDetected	Η υπηρεσία περιοδικού ελέγχου PR βρίσκει ένα PR που άνοιξε απευθείας στο GitHub	repo_owner, repo_name, pr_number, pr_title, author

Ένα PR που ανοίγει στο github.com δεν ενεργοποιεί ποτέ το PullRequestPublished, οπότε ένα πρότυπο συνδεδεμένο μόνο με αυτό το γεγονός δεν θα το δει. Σημειώστε επίσης ότι το PullRequestPublished δεν μεταφέρει pr_number — ένα βήμα του οποίου το σενάριο ή η προτροπή αναφέρει {{pr_number}} πρέπει να τροφοδοτείται από το ExternalPrDetected, ή από χειροκίνητη εκτέλεση που το παρέχει.

Σημείο ελέγχου: αφού το ενεργοποιήσετε, ανοίξτε το Pipelines και επιβεβαιώστε ότι εμφανίζεται εκτέλεση για το επόμενο PR που ταιριάζει. Ένα πρότυπο που μένει απενεργοποιημένο κάνει το έναυσμά του να μην πυροδοτεί τίποτα — ο μηχανισμός απορρίπτει ένα απενεργοποιημένο πρότυπο και επιστρέφει χωρίς να ξεκινήσει εκτέλεση.

Πώς αντιστοιχίζεται ένας ρόλος σε έναν πράκτορα

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

Αντιστοίχιση	Βαθμολογία
Μια δεξιότητα που περιέχει την ετικέτα ρόλου	+3
Ένας τίτλος που περιέχει την ετικέτα ρόλου	+2
Ένα όνομα πράκτορα που περιέχει την ετικέτα ρόλου	+1

Οι βαθμολογίες αθροίζονται και κερδίζει το υψηλότερο σύνολο (σε ισοπαλία, ο πρώτος υποψήφιος που βρέθηκε). Αν κανένας υποψήφιος δεν βαθμολογηθεί πάνω από το μηδέν, η προδιαγραφή επιστρέφεται στη λίστα unmatched του εργαλείου αντί να αποσταλεί — έτσι ένας ρόλος που δεν ταιριάζει με κανέναν αναφέρεται, αντί να παραλείπεται σιωπηλά.

Ο χώρος ελέγχου

Ένα PR έχει ακριβώς έναν χώρο ελέγχου, όχι έναν ανά ελεγκτή. Δημιουργείται ταυτοδύναμα από το pr.ensureSpace, συνδέεται με το PR μέσω ενός ReviewSpaceAssociation και προετοιμάζεται με βάση το head ref του PR. Κάθε ελεγκτής που αποστέλλεται μπαίνει σε αυτόν τον χώρο και αναρτά εκεί τα ευρήματά του ως review_node, κι αυτό είναι που κάνει τα ευρήματα συγκρίσιμα και επιτρέπει στον επικεφαλής πράκτορα να φτάσει σε συναίνεση μεταξύ τους.

Παρακολουθήστε την αποστολή

Κάθε ελεγκτής που αποστέλλεται αποκτά το δικό του AgentRunLog. Παρακολουθήστε την πρόοδο σε:

• Τον χώρο ελέγχου, όπου τα ευρήματα φτάνουν ζωντανά
• Την καρτέλα Ανασκόπηση του PR, που εμφανίζει τη γραμμή κατάστασης της ανασκόπησης και την ετυμηγορία
• Την Παρατηρησιμότητα → Ζωντανά (/workspaces/:id/observability), τη λίστα πρακτόρων με κατάσταση ανά εκτέλεση, ζωντανό χρόνο που έχει περάσει, συρτάρι μεταγραφής και χειριστήριο τερματισμού. Δεν υπάρχει συντόμευση πληκτρολογίου για αυτήν — φτάστε εκεί από το υποσέλιδο της πλαϊνής στήλης.

Σχετικοί οδηγοί πρακτικής

• Χρήση ελέγχου με AI
• Έλεγχος και συγχώνευση PR
• Ρύθμιση ενεργοποιητών pipeline

Σχετικές έννοιες

• Έλεγχος με AI
• Pipeline και αυτοματισμός