የመጀመሪያ የሥራ ፍሰት
ወደ 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 | የክስተት ቀስቃሽ ሲነሳ። 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"}} ገደቦች እና መልሶ ማገገም
params.maxIterationsሌላ ካልተናገረ በስተቀር እያንዳንዱ እንቅስቃሴ እስከ 50 የሞዴል ዙሮች ሊወስድ ይችላል።- በግራፍ ውስጥ አንድ እንቅስቃሴ በአንድ ሩጫ ቢበዛ 10,000 ጊዜ ሊሄድ ይችላል።
- ባለቤቱ ለሰራተኛው ያዘጋጀው የወጪ ገደብ ሲደረስ ሩጫውን ያቆማል። የአንድ እንቅስቃሴ
token_budgetግምት ነው። - በዳግም ማስጀመር የተቋረጠ ሩጫ እንደተቋረጠ ምልክት ይደረግበታል፣ አንድ ጊዜም ይቀጥላል።
- ሰራተኛው በ
exitመሣሪያ ሩጫውን ቀደም ብሎ ሊያበቃ ይችላል።
የሥራ ፍሰቶችን ያሂዱ እና ያስተዳድሩ
ባለቤቱ ማንኛውንም የሥራ ፍሰት በእጁ ሊያሄድ ይችላል። ሰራተኞች የሥራ ፍሰቶችን በrun_workflow፣ በworkflow_status፣ በlist_workflow_runs፣ በset_workflow_enabled እና በረዳቶች እና ቡድኖች ላይ በተዘረዘሩት ሌሎች የሥራ ፍሰት መሣሪያዎች ያስተዳድራሉ።