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

เวิร์กโฟลว์

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

เวิร์กโฟลว์แรก

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