NeboAI
NeboAI
Ξεκινήστε

Ροές εργασίας

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

Μια πρώτη ροή εργασιών

Προσθέστε μια αντιστοίχιση workflows στο agent.json. Κάθε κλειδί ονομάζει μια ροή εργασιών· κάθε τιμή έχει έναν ενεργοποιητή και δραστηριότητες.

{
  "workflows": {
    "morning-summary": {
      "trigger": { "type": "schedule", "cron": "0 8 * * 1-5" },
      "description": "Summarize yesterday's open conversations every weekday morning.",
      "activities": [
        { "id": "summarize", "intent": "Summarize yesterday's open customer conversations and what each one is waiting on." }
      ]
    }
  }
}

Αυτή η ροή εργασιών εκτελείται στις 08:00 τις καθημερινές, στην τοπική ώρα του bot. Ο υπάλληλος εκτελεί τη δραστηριότητα με τη δική του περσόνα, τις δεξιότητες και τις συνδέσεις του.

Πεδία ροής εργασιών

ΠεδίοΣημασία
triggerΥποχρεωτικό. Πότε εκτελείται η ροή εργασιών. Δείτε την ενότητα Ενεργοποιητές.
descriptionΟ σκοπός της ροής εργασιών.
activitiesΤα βήματα. Δείτε την ενότητα Δραστηριότητες.
connectionsΑκμές {from, to, label} που κάνουν τις δραστηριότητες γράφο. Το __trigger__ είναι η αρχή και το __emit__ το τέλος.
emitΣυμβάντα που ανακοινώνει αυτή η ροή εργασιών όταν ολοκληρώνεται: μια λίστα ή μία συμβολοσειρά με διαχωρισμό με κόμματα. Δείτε την ενότητα Συμβάντα.
inputsΤιμές που περνιούνται σε κάθε εκτέλεση.
budget{total_per_run, cost_estimate}. Σε εκτέλεση γράφου, το total_per_run θέτει όριο στα tokens εξόδου· διαφορετικά και τα δύο είναι εκτιμήσεις.
caseΚάνει τη ροή εργασιών μία υπόθεση μακράς διάρκειας ανά άτομο ή αντικείμενο. Δείτε την ενότητα Υποθέσεις.

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

Πώς εκτελείται μια ροή

Χωρίς connections, οι δραστηριότητες εκτελούνται με τη σειρά και ο υπάλληλος εκτελεί την καθεμία. Το αποτέλεσμα κάθε δραστηριότητας περνά στην επόμενη. Μια δραστηριότητα χωρίς έξοδο τερματίζει την εκτέλεση.

Με connections, οι δραστηριότητες σχηματίζουν γράφο. Οι διακλαδώσεις εκτελούνται παράλληλα, και έξι τύποι δραστηριοτήτων εκτελούνται χωρίς το μοντέλο: condition, loop, wait, http, command και decide. Χρησιμοποιήστε γράφο όταν η δρομολόγηση πρέπει να είναι ακριβής.

{
  "trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
  "activities": [
    { "id": "classify", "type": "decide",
      "params": {
        "questions": {
          "kind": {
            "type": "choice",
            "instructions": "What kind of message is this?",
            "criteria": { "invoice": "A bill from a vendor", "other": "Anything else" }
          }
        },
        "default": { "kind": "other" }
      } },
    { "id": "is-invoice", "type": "condition", "params": { "expression": "nodes.classify.kind.choice == invoice" } },
    { "id": "record", "intent": "Record the invoice in _watch_payload as a bill and note the due date." }
  ],
  "connections": [
    { "from": "__trigger__", "to": "classify" },
    { "from": "classify", "to": "is-invoice" },
    { "from": "is-invoice", "to": "record", "label": "True" },
    { "from": "record", "to": "__emit__" }
  ],
  "emit": ["invoice.recorded"]
}

Τι λαμβάνει μια εκτέλεση

Ο υπάλληλος έχει πάντα την περσόνα του και τις απαντήσεις του κατόχου στις ερωτήσεις του inputs. Μια εκτέλεση λαμβάνει επίσης αυτές τις τιμές, ανάλογα με τον ενεργοποιητή της.

ΕίσοδοςΥπάρχει όταν
_event_source, _event_payload, _event_originΕνεργοποιήθηκε ένας ενεργοποιητής συμβάντος. Τα φορτία των 8 KB και άνω συντομεύονται στα βαθμωτά πεδία τους, με διατήρηση των κεφαλίδων email και των αναφορών σε συνημμένα.
_watch_payloadΕνεργοποιήθηκε ένας ενεργοποιητής παρακολούθησης ή φακέλου. Μία γραμμή της εξόδου του παρατηρητή, ή {files} για φάκελο.
inputsΠάντα. Οι δικές τιμές inputs της ροής εργασιών.

Υποθέσεις

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

ΠεδίοΣημασία
keyΥποχρεωτικό. Διαδρομές με τελείες, χωρισμένες με κόμματα, μέσα στα δεδομένα του ενεργοποιητή που προσδιορίζουν το θέμα, όπως contactEmail,email,phone.
typeΤο είδος της υπόθεσης, όπως lead. Οι ροές εργασιών με τον ίδιο τύπο μοιράζονται υποθέσεις. Προεπιλογή το όνομα της ροής εργασιών.
default_waitΠόσο να περιμένει όταν ένας γύρος δεν ορίζει αναμονή: 3d, 12h, 45m. Προεπιλογή τρεις ημέρες.

Κάθε γύρος μιας υπόθεσης πρέπει να τελειώνει με ένα αντικείμενο JSON και τίποτα μετά από αυτό. Το result είναι η επιχειρησιακή κατάσταση· το next λέει στη μηχανή να κάνει wait ή close. Μια προθεσμία είναι RFC 3339 ή σχετικό χρονικό διάστημα. Οτιδήποτε άλλο είναι μη έγκυρος γύρος.

{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
 "next":   {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}}

Όρια και ανάκαμψη

  • Κάθε δραστηριότητα μπορεί να πάρει έως 50 γύρους μοντέλου, εκτός αν το params.maxIterations ορίζει διαφορετικά.
  • Σε έναν γράφο, μία δραστηριότητα μπορεί να εκτελεστεί έως 10.000 φορές σε μία εκτέλεση.
  • Το όριο δαπανών του κατόχου για τον υπάλληλο σταματά μια εκτέλεση όταν επιτευχθεί. Το token_budget μιας δραστηριότητας είναι εκτίμηση.
  • Μια εκτέλεση που διακόπτεται από επανεκκίνηση σημειώνεται ως διακομμένη και συνεχίζεται μία φορά.
  • Ο υπάλληλος μπορεί να τερματίσει μια εκτέλεση νωρίς με το εργαλείο exit.

Εκτέλεση και διαχείριση ροών εργασιών

Ο κάτοχος μπορεί να εκτελέσει οποιαδήποτε ροή εργασιών χειροκίνητα. Οι υπάλληλοι διαχειρίζονται τις ροές εργασιών με τα run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled και τα άλλα εργαλεία ροών εργασιών που αναφέρονται στη σελίδα Βοηθοί και ομάδες.