Αποστείλετε τον πρώτο σας πράκτορα

Τι θα φτιάξετε

Μέχρι το τέλος αυτού του οδηγού θα έχετε:

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

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

Βήμα 1: Δημιουργήστε έναν πράκτορα

1. Μεταβείτε στις Ρυθμίσεις → Χώρος εργασίας → Πράκτορες
2. Κάντε κλικ στο Νέος πράκτορας. Ένας πράκτορας με το όνομα «Ανώνυμος πράκτορας» δημιουργείται αμέσως και επιλέγεται στον κατάλογο — δεν υπάρχει παράθυρο διαλόγου δημιουργίας ούτε τίποτα προς επιβεβαίωση. Τον ρυθμίζετε επιτόπου.
3. Στην καρτέλα Ρυθμίσεις, συμπληρώστε:
   • Όνομα: κάτι σύντομο και αξιομνημόνευτο, όπως alice. Αυτό πληκτρολογείτε μετά το @.
   • Τίτλος: τι κάνει, π.χ. «Μηχανικός backend»
   • Προσαρμογέας: Control Center (built-in). Επιλέξτε τον σκόπιμα — μόνο το ενσωματωμένο harness μπορεί να καθοδηγηθεί στη μέση μιας εκτέλεσης και να τεθεί σε παύση σε όριο στροφής, και δεν χρειάζεται CLI εγκατεστημένο στο μηχάνημα που φιλοξενεί τον διακομιστή.
   • Μοντέλο: επιλέξτε από τη λίστα που σερβίρει ο συνδεδεμένος πάροχος
   • Δεξιότητες: επισυνάψτε όποιες ταιριάζουν, π.χ. testing ή architecture
4. Πατήστε Αποθήκευση αλλαγών

Ένας πράκτορας χωρίς προσαρμογέα εκτελείται στον ενσωματωμένο βρόχο

Όταν το πεδίο Προσαρμογέας δεν έχει οριστεί, η αποστολή καταλήγει στο Control Center (built-in) — τον βρόχο πράκτορα μέσα στον διακομιστή, οπότε δεν υπάρχει τίποτα να εγκατασταθεί στο μηχάνημα. Χρειάζεται ωστόσο μοντέλο: χωρίς ορισμένο μοντέλο ζητά από την Anthropic την προεπιλογή της, κάτι που λειτουργεί αν έχετε συνδέσει λογαριασμό Anthropic και σε αντίθετη περίπτωση αποτυγχάνει με No credential for provider "anthropic". Ορίστε και τα δύο ρητά, αλλιώς θα εκτελείστε σε ένα μοντέλο που δεν επιλέξατε.

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

Βήμα 2: Ξεκινήστε έναν χώρο

1. Στην πλαϊνή στήλη, βρείτε την ενότητα Χώροι και κάντε κλικ στο κουμπί +
2. Δώστε στον χώρο ένα όνομα
3. Στο Προσθήκη πρακτόρων, επιλέξτε τον πράκτορα που μόλις δημιουργήσατε
4. Αν ο χώρος εργασίας έχει αποθετήρια, επιλέξτε σε ποια θα πρέπει να εργάζεται αυτός ο χώρος
5. Κάντε κλικ στο Δημιουργία

Ο χώρος ανοίγει. Στο παρασκήνιο, το Control Center προετοιμάζει ένα worktree copy-on-write των επιλεγμένων αποθετηρίων για αυτή τη συνομιλία, σε δικό του κλάδο. Το checkout του πηγαίου σας κώδικα δεν μεταβάλλεται ποτέ.

Βήμα 3: Στείλτε μια εργασία

Πληκτρολογήστε μία συγκεκριμένη, μικρή εργασία πάνω στο αποθετήριο που καταχωρίσατε. Κάτι με ελέγξιμο αποτέλεσμα λειτουργεί καλύτερα — προσθέστε ένα τεστ, διορθώστε ένα πρόβλημα lint, μετονομάστε ένα σύμβολο.

Πατήστε Enter. Δεν χρειάζεται να κάνετε @-αναφορά σε κανέναν: με έναν μόνο πράκτορα στον χώρο, ένα απλό μήνυμα τον ξυπνά. Σε έναν χώρο με πολλούς πράκτορες, το @name επιλέγει έναν.

Το Control Center συναρμολογεί την προτροπή από τις οδηγίες, την περσόνα και τις δεξιότητες του πράκτορα και από το πλαίσιο του χώρου και μετά αποστέλλει την εκτέλεση.

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

Βήμα 4: Δείτε το να εργάζεται

Η συνομιλία αποδίδει την εκτέλεση καθώς συμβαίνει:

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

Αν ο πράκτορας ρωτήσει κάτι, απαντήστε στη συνομιλία και συνεχίζει.

Για τα μετρικά μιας εκτέλεσης και τα στοιχεία ελέγχου παύσης, συνέχισης και διακοπής της, βρείτε τον πράκτορα που εκτελείται στην ενότητα Πράκτορες του πίνακα Γενικά του χώρου και επιλέξτε Άνοιγμα δραστηριότητας.

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

Τι περιορίζει την εκτέλεση: το δικό της worktree copy-on-write, τα διαπιστευτήρια που μεσιτεύονται για αυτήν κατά την εκκίνηση και ανακαλούνται στον τερματισμό, ένα απολυμασμένο περιβάλλον, η επιφάνεια εργαλείων που επιτρέπει η λειτουργία της και οι περιορισμοί ενεργειών. Ενέργειες όπως το push ενός κλάδου ή το άνοιγμα ενός pull request φυλάσσονται χωριστά — δείτε Περιορισμοί.

Βήμα 5: Ελέγξτε το αποτέλεσμα

1. Ανοίξτε τις Ρυθμίσεις → Χώρος εργασίας → Πράκτορες και επιλέξτε τον πράκτορά σας
2. Ανοίξτε την καρτέλα Αρχεία καταγραφής

Σημείο ελέγχου. Μία γραμμή εκτέλεσης, που δείχνει την κατάσταση, τη διάρκεια, τις ώρες έναρξης και λήξης και τον προσαρμογέα στον οποίο εκτελέστηκε.

Οι αλλαγές του πράκτορα δεσμεύονται στον κλάδο της συνομιλίας, μέσα στο worktree της. Τα commits έχουν ως συγγραφέα τον πράκτορα, με εσάς να αναφέρεστε σε trailer Co-Authored-By:.

Απόκτηση pull request

Τίποτα δεν ανοίγει ένα pull request από μόνο του. Αν θέλετε ένα, ζητήστε το στην ίδια συνομιλία:

Κάντε push σε αυτόν τον κλάδο και ανοίξτε ένα pull request προς τον προεπιλεγμένο κλάδο.

Το push (gitPush) και η δημιουργία PR (prCreate) ζητούν από προεπιλογή την έγκρισή σας, οπότε περιμένετε μια επιβεβαίωση πριν από καθένα. Αν δεν είναι συνδεδεμένος κανένας εγκρίνων όταν ενεργοποιηθεί το αίτημα, η ενέργεια απορρίπτεται αντί να επιτρέπεται — οι περιορισμοί αποτυγχάνουν με ασφάλεια.

Το PR ανοίγει με την ταυτότητα GitHub της οποίας το token χρησιμοποίησε η εκτέλεση — τη δική σας, αν έχετε αποθηκεύσει προσωπικό token — και όχι με το όνομα του πράκτορα. Η πατρότητα του πράκτορα φαίνεται στα commits.

Μπορείτε επίσης να το ανοίξετε μόνοι σας: ο πίνακας Έλεγχος εκδόσεων του χώρου έχει ένα κουμπί Δημιουργία pull request που μεταφέρει τον κλάδο της συνομιλίας στην οθόνη σύνταξης, ενώ το Pull requests → Νέο PR ανοίγει την ίδια οθόνη κενή. Από εκεί συνεχίζει ο επόμενος οδηγός.

Σύνοψη

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

Επόμενο: Ελέγξτε το πρώτο σας pull request για να μάθετε τη ροή εργασίας ελέγχου.

Για περισσότερα σχετικά με τους πράκτορες: Το μοντέλο πρακτόρων. Για λεπτομέρειες της αποστολής: Κύκλος ζωής αποστολής πράκτορα.