पहला वर्कफ़्लो
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 और सहायक और टीमें पर दिए अन्य वर्कफ़्लो टूल से वर्कफ़्लो प्रबंधित करते हैं।