NeboAI
NeboAI
Ξεκινήστε

Δραστηριότητες

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

Πεδία

{
  "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 και στις διαδρομές δεδομένων.
typecustomΈνα βήμα υπαλλήλου ή ένα από τα 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Μια διαδρομή· αληθής όταν καταλήγει σε τιμή που αξιολογείται ως αληθής.
containspath 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" } }
ΤύποςΥποχρεωτικόΣυμπεριφορά
waitparams.durationΚάνει παύση για ένα διάστημα σε s, m ή h. Δεν υπάρχει αναμονή μέχρι συγκεκριμένη στιγμή· για συνέχιση με ένα συμβάν, ενεργοποιήστε μια δεύτερη ροή εργασιών με αυτό.
httpparams.urlΚάνει το αίτημα. Τα method, headers και body είναι προαιρετικά.
commandparams.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 ελέγχει τις υποχρεωτικές παραμέτρους κάθε τυποποιημένης δραστηριότητας όταν ξεκινά η εκτέλεση και απορρίπτει μια διακλάδωση που δείχνει σε άγνωστη δραστηριότητα.