ฟิลด์
{
"id": "draft-reply",
"label": "Draft the reply",
"intent": "Draft a reply to the customer message in _watch_payload using the reply-drafting skill.",
"skills": ["reply-drafting"],
"requires_tools": ["mail_message_send"],
"on_error": { "retry": 1, "fallback": "notify_owner" }
} | ฟิลด์ | ค่าเริ่มต้น | ความหมาย |
|---|---|---|
id | จำเป็น | ไม่ซ้ำกันภายในเวิร์กโฟลว์ ใช้ใน connections และพาธข้อมูล |
type | custom | ขั้นตอนของพนักงาน หรือหนึ่งใน condition, loop, wait, http, command, decide |
intent | ไม่มี | สิ่งที่พนักงานควรทำให้สำเร็จ ขั้นตอนของพนักงานต้องมี intent หรือ steps |
steps | [] | คำแนะนำตามลำดับ เมื่อประโยคเดียวไม่เพียงพอ |
label | ไม่มี | ชื่อที่แสดงให้เจ้าของเห็น |
skills | [] | ทักษะที่จะใช้ ทักษะจากมาร์เก็ตเพลสที่ระบุไว้ที่นี่จะถูกติดตั้งไปพร้อมกับพนักงาน |
tools | [] | เมื่อตั้งค่าไว้ จะเป็นเครื่องมือเดียวที่ขั้นตอนนี้ใช้ได้ |
requires_tools | [] | เครื่องมือที่ต้องทำงานสำเร็จเพื่อให้ขั้นตอนนับว่าเสร็จ |
cmds | [] | คำสั่งปลั๊กอินที่ระบุไว้สำหรับขั้นตอนนี้ |
mcps | [] | เซิร์ฟเวอร์ MCP ที่ระบุไว้สำหรับขั้นตอนนี้ |
model | ไม่มี | id ของโมเดลสำหรับขั้นตอนนี้ |
params | ไม่มี | พารามิเตอร์สำหรับกิจกรรมแบบมีชนิด และ maxIterations สำหรับขั้นตอนของพนักงาน |
min_iterations | ไม่มี | จำนวนรอบขั้นต่ำของโมเดลก่อนที่ขั้นตอนจะเสร็จได้ |
token_budget | ไม่มี | {max} เป็นค่าประมาณ |
on_error | {retry: 1, fallback: notify_owner} | การลองใหม่ แล้วตามด้วยทางสำรอง ความล้มเหลวใดก็ตามหลังจากลองใหม่แล้วจะจบการทำงาน |
ขั้นตอนของพนักงาน
ขั้นตอนของพนักงานทำงานเป็นหนึ่งรอบของพนักงาน โดยใช้บุคลิก ความทรงจำ และการเชื่อมต่อของพนักงาน และใช้โมเดลได้สูงสุด 50 รอบ หรือตาม params.maxIterations ผลลัพธ์ของขั้นตอนก่อนหน้าจะส่งเข้ามาเป็นบล็อก [Activity 'id' result] ขั้นตอนที่จบเวิร์กโฟลว์ซึ่งมีรายการ emit จะได้รับคำสั่งให้เรียก emit_event พร้อมอีเวนต์เหล่านั้น เครื่องมือ exit พร้อมใช้งานเสมอเพื่อจบการทำงาน
บริบทข้อมูล
กิจกรรมแบบมีชนิดอ่านค่าด้วยพาธแบบจุดจากออบเจกต์เดียว inputs เก็บอินพุตของการทำงานรอบนั้น nodes.<id> เก็บเอาต์พุตของกิจกรรมแต่ละรายการที่เสร็จแล้ว (แยกวิเคราะห์เป็น JSON เมื่อเป็น JSON) และ item เก็บรายการปัจจุบันภายในลูป พาธเปล่า ๆ จะค้นหาใน inputs ก่อน แล้วจึงค้นหาใน nodes
condition
{ "id": "large", "type": "condition", "params": { "expression": "inputs.amount >= 500" } } ต้องมี params.expression การเชื่อมต่อขาออกมีป้ายกำกับ True และ False params.mode เลือกวิธีอ่านนิพจน์
| โหมด | นิพจน์ |
|---|---|
expression | ค่าเริ่มต้น path op value โดยใช้ ==, !=, >=, <=, > หรือ < เปรียบเทียบเป็นตัวเลขเมื่อทั้งสองฝั่งเป็นตัวเลข หรือพาธเปล่า ซึ่งเป็นจริงเมื่อค่าประเมินเป็นจริง |
exists | พาธ เป็นจริงเมื่อได้ค่าที่ประเมินเป็นจริง |
contains | path contains text หรือข้อความเปล่าที่ใช้จับคู่กับเอาต์พุตก่อนหน้า |
regex | รูปแบบที่ใช้จับคู่กับเอาต์พุตก่อนหน้า |
loop
{ "id": "each-invoice", "type": "loop", "params": { "source": "nodes.fetch.invoices", "concurrency": 4 } } params.source คือพาธของรายการ การเชื่อมต่อที่มีป้ายกำกับ Each item นำไปสู่ส่วนเนื้อหา ซึ่งทำงานหนึ่งครั้งต่อรายการโดยตั้งค่า item ไว้ ส่วนการเชื่อมต่อที่มีป้ายกำกับ Done จะทำงานหลังจากครบทุกรายการ แต่ละรอบเริ่มพร้อมกันเว้นแต่คุณจะตั้ง concurrency ยอมรับ maxIterations และ batchSize ด้วย
"connections": [
{ "from": "__trigger__", "to": "fetch" },
{ "from": "fetch", "to": "each-invoice" },
{ "from": "each-invoice", "to": "check", "label": "Each item" },
{ "from": "each-invoice", "to": "report", "label": "Done" }
] wait, http และ command
{ "id": "pause", "type": "wait", "params": { "duration": "5m" } }
{ "id": "status", "type": "http", "params": { "url": "https://status.example.com/api", "method": "GET" } }
{ "id": "export", "type": "command", "params": { "command": "date -u" } } | ชนิด | จำเป็น | การทำงาน |
|---|---|---|
wait | params.duration | หยุดชั่วคราวตามช่วงเวลาที่ระบุเป็น s, m หรือ h ไม่มีการรอจนถึงเวลาที่กำหนด หากต้องการทำต่อเมื่อเกิดอีเวนต์ ให้ทริกเกอร์เวิร์กโฟลว์ที่สองจากอีเวนต์นั้น |
http | params.url | ส่งคำขอ method, headers และ body ไม่บังคับ |
command | params.command | เรียกใช้คำสั่งเชลล์ stdout ของคำสั่งคือเอาต์พุตของกิจกรรม |
decide
กิจกรรม decide จะถามคำถามแบบมีชนิดเกี่ยวกับงานที่ทำมาจนถึงตอนนี้ และบันทึกคำตอบที่มีโครงสร้างซึ่ง condition ใช้กำหนดเส้นทางได้
{
"id": "triage",
"type": "decide",
"params": {
"questions": {
"urgency": { "type": "score", "instructions": "How urgent is this request?", "criteria": ["low", "normal", "high"] },
"refund": { "type": "noul", "instructions": "The customer is asking for money back." }
},
"default": { "urgency": "normal", "refund": false }
}
} | ชนิดคำถาม | criteria | คำตอบ |
|---|---|---|
choice | ออบเจกต์ที่จับคู่ตัวเลือกกับคำอธิบาย 2 ถึง 255 ตัวเลือก | choice, confidence และ probabilities |
score | รายการระดับที่เรียงลำดับ 2 ถึง 10 ระดับ | score ตั้งแต่ 0 (ระดับแรก) ขึ้นไป และ confidence |
noul | ไม่มี | noul ความน่าจะเป็นที่ข้อความนั้นเป็นจริง |
กำหนดเส้นทางตามคำตอบด้วย condition เช่น nodes.triage.urgency.score >= 1.5 params.default ให้คำตอบที่ปลอดภัยสำหรับแต่ละคำถามเมื่อตัดสินใจไม่ได้ คำตอบที่ใช้ค่าเริ่มต้นมีความมั่นใจเป็น 0 คำถามที่ไม่มีค่าเริ่มต้นจะไม่ได้คำตอบ ดังนั้น condition ที่ขึ้นกับคำถามนั้นจะไปตามขอบ False
ข้อผิดพลาด
on_error.retry กำหนดจำนวนครั้งที่กิจกรรมที่ล้มเหลวจะลองใหม่ ค่าเริ่มต้นคือ 1 หลังจากลองใหม่ครั้งสุดท้าย การทำงานจะจบลง และด้วย fallback เริ่มต้นที่เป็น notify_owner เจ้าของจะได้รับแจ้ง Nebo ตรวจพารามิเตอร์ที่จำเป็นของกิจกรรมแบบมีชนิดแต่ละรายการเมื่อเริ่มการทำงาน และปฏิเสธสาขาที่ชี้ไปยังกิจกรรมที่ไม่รู้จัก