NeboAI
NeboAI
शुरू करें

वर्कफ़्लो

वर्कफ़्लो वह काम है जो कर्मचारी बिना कहे करता है: सुबह का सारांश, हर नए संदेश का जवाब, साप्ताहिक रिपोर्ट। हर वर्कफ़्लो एक ट्रिगर को उन गतिविधियों से जोड़ता है जिन्हें कर्मचारी पूरा करता है। वर्कफ़्लो कर्मचारी की agent.json में रहते हैं, इसलिए वे भूमिका के साथ चलते हैं।

पहला वर्कफ़्लो

agent.json में एक workflows मैप जोड़ें। हर कुंजी एक वर्कफ़्लो का नाम है; हर मान में एक ट्रिगर और गतिविधियाँ होती हैं।

{
  "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 बजे, बॉट के स्थानीय समय पर चलता है। कर्मचारी अपनी पर्सोना, स्किल और कनेक्शन के साथ गतिविधि पूरी करता है।

वर्कफ़्लो फ़ील्ड

फ़ील्डअर्थ
triggerज़रूरी। वर्कफ़्लो कब चलता है। ट्रिगर देखें।
descriptionवर्कफ़्लो किसलिए है।
activitiesचरण। गतिविधियाँ देखें।
connectionsएज {from, to, label} जो गतिविधियों को ग्राफ़ बनाते हैं। __trigger__ शुरुआत है और __emit__ अंत।
emitवे इवेंट जिनकी घोषणा यह वर्कफ़्लो पूरा होने पर करता है: एक सूची, या कॉमा से अलग की गई एक स्ट्रिंग। इवेंट देखें।
inputsहर रन को दिए जाने वाले मान।
budget{total_per_run, cost_estimate}। ग्राफ़ रन में total_per_run आउटपुट टोकन की सीमा तय करता है; वरना दोनों अनुमान हैं।
caseवर्कफ़्लो को हर व्यक्ति या चीज़ के लिए एक लंबे समय तक चलने वाला केस बनाता है। केस देखें।

ट्रिगर वाला और बिना गतिविधियों वाला वर्कफ़्लो मान्य है। बिना गतिविधियों वाला watch केवल अपने इवेंट दूसरे वर्कफ़्लो तक पहुँचाता है।

एक रन कैसे चलता है

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कोई event ट्रिगर चला। 8 KB या उससे बड़े पेलोड को उनके स्केलर फ़ील्ड तक छोटा कर दिया जाता है, ईमेल हेडर और अटैचमेंट संदर्भ रखते हुए।
_watch_payloadकोई watch या folder ट्रिगर चला। वॉचर के आउटपुट की एक लाइन, या फ़ोल्डर के लिए {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 और सहायक और टीमें पर दिए अन्य वर्कफ़्लो टूल से वर्कफ़्लो प्रबंधित करते हैं।