ਪਹਿਲਾ ਵਰਕਫਲੋ
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 | ਲਾਜ਼ਮੀ। ਵਰਕਫਲੋ ਕਦੋਂ ਚੱਲਦਾ ਹੈ। Triggers ਦੇਖੋ। |
description | ਵਰਕਫਲੋ ਕਿਸ ਲਈ ਹੈ। |
activities | ਕਦਮ। Activities ਦੇਖੋ। |
connections | ਕਿਨਾਰੇ {from, to, label} ਜੋ ਗਤੀਵਿਧੀਆਂ ਨੂੰ ਗ੍ਰਾਫ਼ ਬਣਾਉਂਦੇ ਹਨ। __trigger__ ਸ਼ੁਰੂਆਤ ਹੈ ਅਤੇ __emit__ ਅੰਤ। |
emit | ਇਵੈਂਟ ਜਿਹਨਾਂ ਦਾ ਇਹ ਵਰਕਫਲੋ ਪੂਰਾ ਹੋਣ ’ਤੇ ਐਲਾਨ ਕਰਦਾ ਹੈ: ਇੱਕ ਸੂਚੀ, ਜਾਂ ਕਾਮਿਆਂ ਨਾਲ ਵੱਖ ਕੀਤੀ ਇੱਕ ਸਟ੍ਰਿੰਗ। Events ਦੇਖੋ। |
inputs | ਹਰ ਰਨ ਨੂੰ ਦਿੱਤੇ ਜਾਂਦੇ ਮੁੱਲ। |
budget | {total_per_run, cost_estimate}। ਗ੍ਰਾਫ਼ ਰਨ ਵਿੱਚ total_per_run ਆਉਟਪੁਟ ਟੋਕਨਾਂ ਦੀ ਹੱਦ ਤੈਅ ਕਰਦਾ ਹੈ; ਨਹੀਂ ਤਾਂ ਦੋਵੇਂ ਅੰਦਾਜ਼ੇ ਹਨ। |
case | ਵਰਕਫਲੋ ਨੂੰ ਹਰ ਵਿਅਕਤੀ ਜਾਂ ਚੀਜ਼ ਲਈ ਇੱਕ ਲੰਮਾ ਚੱਲਣ ਵਾਲਾ ਕੇਸ ਬਣਾਉਂਦਾ ਹੈ। Cases ਦੇਖੋ। |
ਟ੍ਰਿਗਰ ਵਾਲਾ ਅਤੇ ਗਤੀਵਿਧੀਆਂ ਤੋਂ ਬਿਨਾਂ ਵਰਕਫਲੋ ਜਾਇਜ਼ ਹੈ। ਗਤੀਵਿਧੀਆਂ ਤੋਂ ਬਿਨਾਂ 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 ਅਤੇ ਸਹਾਇਕ ਅਤੇ ਟੀਮਾਂ ’ਤੇ ਦਰਜ ਹੋਰ ਵਰਕਫਲੋ ਟੂਲਾਂ ਨਾਲ ਵਰਕਫਲੋ ਸੰਭਾਲਦੇ ਹਨ।