Πεδία
{
"id": "draft-reply",
"label": "Draft the reply",
"intent": "Draft a reply to the customer message in _watch_payload using the reply-drafting skill.",
"skills": ["reply-drafting"],
"requires_tools": ["mail_message_send"],
"on_error": { "retry": 1, "fallback": "notify_owner" }
} | Πεδίο | Προεπιλογή | Σημασία |
|---|---|---|
id | υποχρεωτικό | Μοναδικό μέσα στη ροή εργασιών. Χρησιμοποιείται στα connections και στις διαδρομές δεδομένων. |
type | custom | Ένα βήμα υπαλλήλου ή ένα από τα condition, loop, wait, http, command, decide. |
intent | καμία | Τι πρέπει να πετύχει ο υπάλληλος. Ένα βήμα υπαλλήλου χρειάζεται intent ή steps. |
steps | [] | Οδηγίες με σειρά, όταν μία πρόταση δεν αρκεί. |
label | καμία | Όνομα που εμφανίζεται στον κάτοχο. |
skills | [] | Δεξιότητες προς χρήση. Οι δεξιότητες της αγοράς που αναφέρονται εδώ εγκαθίστανται μαζί με τον υπάλληλο. |
tools | [] | Όταν ορίζεται, τα μόνα εργαλεία που μπορεί να χρησιμοποιήσει το βήμα. |
requires_tools | [] | Εργαλεία που πρέπει να πετύχουν για να θεωρηθεί ολοκληρωμένο το βήμα. |
cmds | [] | Εντολές πρόσθετων που ορίζονται για το βήμα. |
mcps | [] | Διακομιστές MCP που ορίζονται για το βήμα. |
model | καμία | Ένα id μοντέλου για αυτό το βήμα. |
params | καμία | Παράμετροι για τις τυποποιημένες δραστηριότητες και maxIterations για τα βήματα του υπαλλήλου. |
min_iterations | καμία | Ελάχιστοι γύροι μοντέλου πριν μπορέσει να ολοκληρωθεί το βήμα. |
token_budget | καμία | {max}. Εκτίμηση. |
on_error | {retry: 1, fallback: notify_owner} | Επαναλήψεις, και μετά η εναλλακτική. Οποιαδήποτε αποτυχία μετά τις επαναλήψεις τερματίζει την εκτέλεση. |
Βήματα υπαλλήλου
Ένα βήμα υπαλλήλου εκτελείται ως γύρος του υπαλλήλου: ισχύουν η περσόνα, η μνήμη και οι συνδέσεις του και μπορεί να χρησιμοποιήσει έως 50 γύρους μοντέλου ή όσους ορίζει το params.maxIterations. Τα αποτελέσματα των προηγούμενων βημάτων περνιούνται ως μπλοκ [Activity 'id' result]. Στο βήμα που τερματίζει μια ροή εργασιών με λίστα emit δίνεται οδηγία να καλέσει το emit_event με εκείνα τα συμβάντα. Το εργαλείο exit είναι πάντα διαθέσιμο για τον τερματισμό της εκτέλεσης.
Το πλαίσιο δεδομένων
Οι τυποποιημένες δραστηριότητες διαβάζουν τιμές με διαδρομή με τελείες από ένα αντικείμενο: το inputs περιέχει τις εισόδους της εκτέλεσης, το nodes.<id> την έξοδο κάθε ολοκληρωμένης δραστηριότητας (αναλυμένη ως JSON όταν είναι JSON) και το item το τρέχον στοιχείο μέσα σε έναν βρόχο. Μια σκέτη διαδρομή αναζητείται στο inputs και μετά στο nodes.
condition
{ "id": "large", "type": "condition", "params": { "expression": "inputs.amount >= 500" } } Το params.expression είναι υποχρεωτικό. Οι εξερχόμενες συνδέσεις του έχουν τις ετικέτες True και False. Το params.mode επιλέγει πώς διαβάζεται:
| Λειτουργία | Έκφραση |
|---|---|
expression | Η προεπιλογή. path op value με ==, !=, >=, <=, > ή <, με σύγκριση ως αριθμών όταν και οι δύο πλευρές είναι αριθμοί· ή μια σκέτη διαδρομή, αληθής όταν η τιμή της αξιολογείται ως αληθής. |
exists | Μια διαδρομή· αληθής όταν καταλήγει σε τιμή που αξιολογείται ως αληθής. |
contains | path contains text, ή σκέτο κείμενο που ελέγχεται έναντι της προηγούμενης εξόδου. |
regex | Ένα μοτίβο που ελέγχεται έναντι της προηγούμενης εξόδου. |
loop
{ "id": "each-invoice", "type": "loop", "params": { "source": "nodes.fetch.invoices", "concurrency": 4 } } Το params.source είναι η διαδρομή μιας λίστας. Η σύνδεση με ετικέτα Each item οδηγεί στο σώμα, που εκτελείται μία φορά ανά στοιχείο με ορισμένο το item· αυτή με ετικέτα Done εκτελείται μετά από όλα τα στοιχεία. Οι επαναλήψεις ξεκινούν ταυτόχρονα, εκτός αν ορίσετε concurrency. Γίνονται επίσης δεκτά τα maxIterations και batchSize.
"connections": [
{ "from": "__trigger__", "to": "fetch" },
{ "from": "fetch", "to": "each-invoice" },
{ "from": "each-invoice", "to": "check", "label": "Each item" },
{ "from": "each-invoice", "to": "report", "label": "Done" }
] wait, http και command
{ "id": "pause", "type": "wait", "params": { "duration": "5m" } }
{ "id": "status", "type": "http", "params": { "url": "https://status.example.com/api", "method": "GET" } }
{ "id": "export", "type": "command", "params": { "command": "date -u" } } | Τύπος | Υποχρεωτικό | Συμπεριφορά |
|---|---|---|
wait | params.duration | Κάνει παύση για ένα διάστημα σε s, m ή h. Δεν υπάρχει αναμονή μέχρι συγκεκριμένη στιγμή· για συνέχιση με ένα συμβάν, ενεργοποιήστε μια δεύτερη ροή εργασιών με αυτό. |
http | params.url | Κάνει το αίτημα. Τα method, headers και body είναι προαιρετικά. |
command | params.command | Εκτελεί μια εντολή shell. Το stdout της είναι η έξοδος της δραστηριότητας. |
decide
Μια δραστηριότητα decide κάνει τυποποιημένες ερωτήσεις για τη δουλειά μέχρι στιγμής και καταγράφει δομημένες απαντήσεις πάνω στις οποίες μπορεί να δρομολογήσει ένα condition.
{
"id": "triage",
"type": "decide",
"params": {
"questions": {
"urgency": { "type": "score", "instructions": "How urgent is this request?", "criteria": ["low", "normal", "high"] },
"refund": { "type": "noul", "instructions": "The customer is asking for money back." }
},
"default": { "urgency": "normal", "refund": false }
}
} | Τύπος ερώτησης | criteria | Απάντηση |
|---|---|---|
choice | Αντικείμενο επιλογής προς περιγραφή, από 2 έως 255 επιλογές. | choice, confidence και probabilities. |
score | Λίστα από 2 έως 10 διαβαθμισμένα επίπεδα. | score από 0 (πρώτο επίπεδο) και πάνω, και confidence. |
noul | Κανένα. | noul, η πιθανότητα να ισχύει η δήλωση. |
Δρομολογήστε με βάση μια απάντηση με ένα condition, όπως nodes.triage.urgency.score >= 1.5. Το params.default δίνει την ασφαλή απάντηση για κάθε ερώτηση όταν δεν μπορεί να ληφθεί απόφαση· μια προεπιλεγμένη απάντηση έχει confidence 0. Μια ερώτηση χωρίς προεπιλογή δεν παίρνει απάντηση, οπότε τα conditions πάνω της ακολουθούν την ακμή False.
Σφάλματα
Το on_error.retry ορίζει πόσες φορές επαναλαμβάνεται μια δραστηριότητα που απέτυχε· η προεπιλογή είναι 1. Μετά την τελευταία επανάληψη η εκτέλεση τερματίζεται, και με το προεπιλεγμένο fallback notify_owner ενημερώνεται ο κάτοχος. Το Nebo ελέγχει τις υποχρεωτικές παραμέτρους κάθε τυποποιημένης δραστηριότητας όταν ξεκινά η εκτέλεση και απορρίπτει μια διακλάδωση που δείχνει σε άγνωστη δραστηριότητα.