Εργασία στο Plan Studio

Αυτός ο οδηγός δείχνει πώς να εργάζεστε με σχέδια στο Plan Studio. Για το τι είναι οι ενορχηστρώσεις και τα έγγραφα σχεδίων, δείτε Ενορχήστρωση και Χρήση λειτουργίας σχεδίου.

Άνοιγμα σχεδίου

Ένα σχέδιο ανήκει στη συνομιλία που το παρήγαγε, οπότε συνήθως το βρίσκετε εκεί: η γραμμή του σχεδίου στη συνομιλία έχει ενέργεια Άνοιγμα και το Plan Studio ανοίγει ως καρτέλα επεξεργαστή δίπλα στη συνομιλία.

Δεν υπάρχει στοιχείο «Σχέδια» στην πλαϊνή στήλη

Αυτό είναι σκόπιμο, όχι παράλειψη. Η κεντρική σελίδα στο /workspaces/<workspace-id>/plans είναι μόνο απευθείας σύνδεσμος με δική του διαδρομή, οπότε προσθέστε τη στους σελιδοδείκτες αν θέλετε έναν σταθερό κατάλογο.

Η κεντρική σελίδα παραθέτει τρεις ενότητες:

• Ενεργά σχέδια — ενορχηστρώσεις, πρώτα οι προτεινόμενες, με την κατάσταση, τον αριθμό βημάτων και τον αριθμό αναθεώρησης.
• Έγγραφα σχεδίων — σχέδια που υπέβαλε ένας μεμονωμένος πράκτορας με το submit_plan στη λειτουργία σχεδίου, όσο βρίσκονται σε κατάσταση προτεινόμενη ή εγκεκριμένη.
• Playbooks — αποθηκευμένα, παραμετροποιημένα πρότυπα σχεδίων.

Πατήστε μια κάρτα για να την ανοίξετε στο Plan Studio. Η διαδρομή είναι /workspaces/<workspace-id>/plans/<kind>/<plan-id>, όπου kind είναι orchestration ή document, ώστε να μπορείτε να συνδέεστε απευθείας και σε ένα μεμονωμένο σχέδιο.

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

Επεξεργασία του DAG

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

1. Πατήστε τον καμβά και μετά μετακινήστε την επιλογή με τα πλήκτρα βέλους.
2. Πατήστε n για να προσθέσετε ένα βήμα. Εμφανίζεται επιλεγμένο ως «Νέο βήμα»· μετονομάστε το στον επιθεωρητή στα δεξιά.
3. Πατήστε e στο βήμα που πρέπει να εκτελεστεί πρώτο και μετά πατήστε το εξαρτώμενο βήμα (ή επιλέξτε το και πατήστε Enter) για να συνδέσετε μια εξάρτηση. Πατήστε Esc για να εγκαταλείψετε μια εκκρεμή σύνδεση.
4. Πατήστε x για να κόψετε τη νεότερη εξάρτηση του επιλεγμένου βήματος ή να εναλλάξετε ακριβείς εξαρτήσεις στον επεξεργαστή εξαρτήσεων του επιθεωρητή.
5. Πατήστε Delete για να αφαιρέσετε το επιλεγμένο βήμα· οι αναφορές σε αυτό αφαιρούνται από τις εξαρτήσεις των υπόλοιπων βημάτων.

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

Μόνο τα βήματα εργασίας είναι επεξεργάσιμα. Οι δομικοί κόμβοι — έρευνα, συζήτηση και σύνθεση — είναι μόνο για ανάγνωση, όπως και κάθε βήμα του οποίου η εργασία έχει ήδη εκτελεστεί (επισημαίνεται ως «έχει ήδη εκτελεστεί», επειδή η επεξεργασία του θα διακλάδωνε το σχέδιο).

Η αποθήκευση είναι αισιόδοξα ταυτόχρονη πάνω στην αναθεώρηση από την οποία ξεκινήσατε. Αν ο ενορχηστρωτής επανασχεδιάσει κάτω από τα πόδια σας, η αποθήκευσή σας απορρίπτεται με «the plan moved on» αντί να συγχωνευτεί ή να πατηθεί σιωπηλά· ξαναδιαβάστε την τρέχουσα αναθεώρηση και επαναλάβετε την επεξεργασία σας. Οι επανασχεδιασμοί που ξεκινά πράκτορας είναι οι ίδιοι περιορισμένοι σε έναν κάθε δύο λεπτά, οπότε αυτό παραμένει σπάνιο.

Σημείωση

Ο καμβάς δεν έχει μετακίνηση με σύρσιμο: η διάταξη υπολογίζεται από τη δομή των εξαρτήσεων, οπότε η «μετακίνηση» ενός βήματος σημαίνει επανασύνδεση των εξαρτήσεών του.

Διαβάστε τις εκτιμήσεις κόστους, χρόνου και κινδύνου

Πατήστε Εκτίμηση στη γραμμή έγκρισης.

• Κάθε βήμα στον καμβά παίρνει ένα σήμα με εύρος κόστους και το μέγεθος δείγματος πίσω του ή «Δεν υπάρχει ακόμη ιστορικό» όταν ο ρόλος του βήματος δεν έχει εκτελεστεί ποτέ. Επιλέξτε ένα βήμα για την πλήρη λεπτομέρεια στον επιθεωρητή: εύρος κόστους με μέγεθος δείγματος, εύρος διάρκειας και ακτίνα επίδρασης (αρχεία και σύμβολα) που προέρχεται από την προέλευση του βήματος — ή «άγνωστο» όταν το βήμα δεν φέρει προέλευση.
• Η γραμμή έγκρισης δείχνει το σύνολο του σχεδίου: ένα συνολικό εύρος κόστους, ένα εύρος διάρκειας για την κρίσιμη διαδρομή (οι παράλληλοι κλάδοι επικαλύπτονται, οπότε αυτό δεν είναι το άθροισμα) και το όριο προϋπολογισμού όταν το σχέδιο ορίζει ένα.
• Αν μόνο μερικά βήματα έχουν ιστορικό, το σύνολο επισημαίνεται ως μερική και καλύπτει μόνο τα βήματα που μπορούν να εκτιμηθούν. Αν το πάνω άκρο της εκτίμησης υπερβαίνει το όριο προϋπολογισμού, το σύνολο γίνεται κόκκινο με προειδοποίηση υπέρβασης προϋπολογισμού.

Οι εκτιμήσεις είναι ειλικρινείς ή απούσες: ένα βήμα του οποίου ο ρόλος δεν έχει ιστορικό ολοκληρωμένων εκτελέσεων αναφέρει μέγεθος δείγματος μηδέν χωρίς καθόλου εύρη και εμφανίζεται ως άγνωστο αντί να μαντευτεί. Αντιμετωπίστε το «Δεν υπάρχει ακόμη ιστορικό» ως «κανείς δεν ξέρει», όχι ως «φθηνό».

Το όριο προϋπολογισμού είναι μια σύγκριση προβολής με αυτή την εκτίμηση. Τίποτα δεν το επιβάλλει μόλις το σχέδιο εκτελείται — δείτε Διαχείριση κόστους για ελέγχους που σταματούν πραγματικά τις δαπάνες.

Σύγκριση αναθεώρησης με παλαιότερη πρόταση

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

1. Πατήστε μια αναθεώρηση για να τη συγκρίνετε με την τρέχουσα πρόταση. Χωρίς επιλογή, ο πίνακας συγκρίνει την προηγούμενη αναθεώρηση με την τρέχουσα.
2. Διαβάστε το diff στο κάτω μισό του πίνακα: βήματα που προστέθηκαν, αφαιρέθηκαν ή άλλαξαν μεταξύ των δύο αναθεωρήσεων.
3. Αν το σχέδιο είναι ακόμη proposed, πατήστε το εικονίδιο επαναφοράς σε μια αναθεώρηση για να επιστρέψετε σε αυτήν. Η επαναφορά αποθηκεύει αυτή την πρόταση ως νέα αναθεώρηση — τίποτα δεν χάνεται.

Το propose_orchestration και ο επεξεργαστής απορρίπτουν και οι δύο αλλαγές μόλις το σχέδιο δεν είναι πλέον proposed, ώστε μια εκτέλεση σε εξέλιξη να μην υιοθετεί έναν επανασχεδιασμό στη μέση της εκτέλεσης.

Έγκριση, απόρριψη ή διεύρυνση σχεδίου

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

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

Μόλις μια ενορχήστρωση εκτελείται, η γραμμή αλλάζει:

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

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

Οι μερικές εγκρίσεις δεν μπορούν να προέλθουν από την εφαρμογή

Μια μερική έγκριση υπάρχει μόνο όταν κάτι κάλεσε το orchestration.approve μέσω RPC με ρητή λίστα approved_node_keys. Η Έγκριση σχεδίου στην εφαρμογή εγκρίνει πάντα κάθε βήμα. Τα έγγραφα σχεδίων εγκρίνονται στο σύνολό τους σε κάθε περίπτωση, οπότε ένα έγγραφο σε εκτέλεση προσφέρει μόνο Ακύρωση εκτέλεσης.

Εκτέλεση playbook με παραμέτρους

Ένα playbook είναι ένα αποθηκευμένο πρότυπο σχεδίου με τυποποιημένα σύμβολα θέσης {{param}} στον στόχο, τους τίτλους βημάτων, τις περιγραφές και τις προτροπές του. Η αντικατάσταση είναι κυριολεκτική — δεν υπάρχει γλώσσα εκφράσεων· αν χρειάζεστε λογική, χρησιμοποιήστε ένα pipeline αντ’ αυτού.

1. Στην ενότητα Playbooks της κεντρικής σελίδας, πατήστε Εκτέλεση στο playbook (ή ανοίξτε την παλέτα ⌘K και επιλέξτε εκεί το playbook).
2. Συμπληρώστε τις παραμέτρους. Οι παράμετροι απαρίθμησης αποδίδονται ως αναπτυσσόμενα μενού· οι παράμετροι αποθετηρίου και πράκτορα δέχονται αναφορά αποθετηρίου ή πράκτορα· οι προαιρετικές παράμετροι επιστρέφουν στην προεπιλεγμένη τιμή τους.
3. Επιλέξτε το εισιτήριο άγκυρας σε σχέση με το οποίο προτείνεται το σχέδιο και μετά επιβεβαιώστε.

Η εκτέλεση ενός playbook μόνο προτείνει ένα σχέδιο — η ενορχήστρωση που δημιουργείται ανοίγει στο Plan Studio ως proposed και τίποτα δεν εκτελείται μέχρι να το εγκρίνετε εκεί. Για να αφαιρέσετε ένα playbook, πατήστε το εικονίδιο κάδου στην κάρτα του.

Οι πράκτορες δημιουργούν και εκτελούν playbooks με τα εργαλεία MCP create_playbook και run_playbook· δείτε την αναφορά εργαλείων MCP.

Σχετικοί οδηγοί

• Χρήση λειτουργίας σχεδίου: πώς ένας πράκτορας παράγει ένα έγγραφο σχεδίου με το submit_plan
• Εκτέλεση ενορχήστρωσης: ο κύκλος ζωής μίας έγκρισης από την πλευρά της συνομιλίας
• Δημιουργία προτύπου pipeline: όταν χρειάζεστε λογική που ένα playbook δεν μπορεί να εκφράσει
• Παρακολούθηση εκτελέσεων pipeline: η προβολή του μηχανισμού για ένα εγκεκριμένο σχέδιο

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

• Ενορχήστρωση