NeboAI
NeboAI
เริ่มต้นใช้งาน

กิจกรรม

กิจกรรมคือขั้นตอนหนึ่งของเวิร์กโฟลว์ กิจกรรมส่วนใหญ่ดำเนินการโดยพนักงาน คุณระบุเจตนา แล้วพนักงานทำงานด้วยทักษะและการเชื่อมต่อของตัวเอง มีหกชนิดที่ทำงานโดยไม่ใช้โมเดล การกำหนดเส้นทางและจังหวะเวลาจึงแม่นยำ

ฟิลด์

{
  "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 และพาธข้อมูล
typecustomขั้นตอนของพนักงาน หรือหนึ่งใน 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พาธ เป็นจริงเมื่อได้ค่าที่ประเมินเป็นจริง
containspath 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" } }
ชนิดจำเป็นการทำงาน
waitparams.durationหยุดชั่วคราวตามช่วงเวลาที่ระบุเป็น s, m หรือ h ไม่มีการรอจนถึงเวลาที่กำหนด หากต้องการทำต่อเมื่อเกิดอีเวนต์ ให้ทริกเกอร์เวิร์กโฟลว์ที่สองจากอีเวนต์นั้น
httpparams.urlส่งคำขอ method, headers และ body ไม่บังคับ
commandparams.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 ตรวจพารามิเตอร์ที่จำเป็นของกิจกรรมแบบมีชนิดแต่ละรายการเมื่อเริ่มการทำงาน และปฏิเสธสาขาที่ชี้ไปยังกิจกรรมที่ไม่รู้จัก