เวิร์กโฟลว์แรก
เพิ่มแมป 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 ในวันทำการ ตามเวลาท้องถิ่นของบอท พนักงานดำเนินกิจกรรมด้วยบุคลิก ทักษะ และการเชื่อมต่อของตัวเอง
ฟิลด์ของเวิร์กโฟลว์
| ฟิลด์ | ความหมาย |
|---|---|
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 และเครื่องมือเวิร์กโฟลว์อื่น ๆ ที่ระบุไว้ใน ผู้ช่วยและทีม