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

ข้อมูลอ้างอิง agent.json

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

ตัวอย่าง

{
  "requires": {
    "interfaces": ["ledger", "mail"],
    "plugins": [],
    "tools": []
  },
  "skills": ["@example/skills/receipt-capture"],
  "inputs": [
    {
      "key": "invoice_mailbox",
      "label": "Mailbox that receives vendor invoices",
      "type": "text",
      "id": "finance.ap.invoice_mailbox",
      "scope": "company",
      "required": true,
      "missing": "Ask the owner which mailbox to watch before processing invoices."
    }
  ],
  "memory": {
    "mode": "separate",
    "topics": [
      { "slug": "vendor", "description": "A supplier: terms, usual amounts, contacts, open disputes" }
    ]
  },
  "subscribes": ["finance.ap.*"],
  "ceiling": { "ledger.bill.create": "approval" },
  "workflows": {
    "invoice-intake": {
      "trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
      "activities": [
        { "id": "record", "intent": "If the message in _watch_payload is a vendor invoice, record it as a bill." }
      ]
    }
  }
}

ฟิลด์

ฟิลด์ประเภทความหมาย
requires.interfacesรายการสตริงความสามารถที่ตำแหน่งต้องใช้ เช่น mail หรือ ledger มอบให้ตอนจ้าง การดำเนินการที่ต้องอนุมัติแต่ละรายการยังคงเป็นรายการรออนุมัติ ดู ความสามารถและการอนุมัติ
requires.pluginsรายการสตริงปลั๊กอินที่ติดตั้งพร้อมพนักงาน ใช้เฉพาะเมื่อตำแหน่งนั้นพึ่งพาปลั๊กอินตัวเดียวจริง ๆ ควรใช้ความสามารถแทน
requires.toolsรายการสตริงเครื่องมือที่โหลดเข้าสู่เซสชันของพนักงานตั้งแต่รอบแรก สิ่งนี้ไม่เคยข้ามการอนุมัติ
skillsรายการสตริงทักษะจากมาร์เก็ตเพลสที่จะติดตั้งและใช้: @org/skills/name พร้อม @version หากต้องการ หรือรหัส SKIL- ทักษะในโฟลเดอร์ skills/ ของแพ็กเกจเองไม่ต้องระบุ
inputslistคำถามที่เจ้าของตอบตอนจ้าง ดู อินพุต
memoryobjectวิธีเก็บบทสนทนาและความทรงจำ ดู บุคลิกและความทรงจำ
subscribesรายการสตริงด้านข้อมูลบริษัทที่พนักงานอ่านใหม่เมื่อมีการเปลี่ยนแปลง เช่น finance.ar.*
ceilingmapการดำเนินการไปยัง "approval" การดำเนินการนั้นจะถามเจ้าของเสมอสำหรับพนักงานคนนี้ ไม่รับค่าอื่น
workflowsmapชื่อเวิร์กโฟลว์ไปยังเวิร์กโฟลว์ ดู เวิร์กโฟลว์
toolslistเครื่องมือ HTTP ที่ sidecar ของแอปให้บริการ ดู เครื่องมือ Sidecar
scopesmapกลุ่มของ tools, skills และ plugins ที่ตั้งชื่อไว้ plugins ของขอบเขตจะถูกอธิบายให้พนักงานทราบเมื่อขอบเขตนั้นทำงาน

อินพุต

อินพุตคือคำถามที่เจ้าของตอบตอนจ้างพนักงาน คำตอบจะปรากฏให้พนักงานเห็นภายใต้ "Configured Inputs" และเติมตัวยึดตำแหน่ง {{key}} ในทริกเกอร์แบบเฝ้าดูและแบบโฟลเดอร์

{
  "key": "close_day",
  "label": "Business day to finish the close",
  "type": "select",
  "options": [
    { "value": "3", "label": "Third business day" },
    { "value": "5", "label": "Fifth business day" }
  ],
  "default": "5",
  "scope": "company",
  "id": "finance.close.day"
}
ฟิลด์ค่าเริ่มต้นความหมาย
keyจำเป็นชื่อที่ใช้ในตัวยึดตำแหน่ง ยอมรับ name เป็นทางสำรอง
labelจาก keyคำถามที่แสดงต่อเจ้าของ
typetexttext, textarea, number, select, checkbox หรือ radio
requiredfalseทำเครื่องหมายว่าเป็นคำถามที่เจ้าของต้องตอบ
defaultไม่มีคำตอบที่กรอกไว้ล่วงหน้า ไม่อนุญาตสำหรับคำถามเรื่องเงิน
placeholder, descriptionไม่มีข้อความช่วยเหลือ
optionsไม่มีสำหรับ select และ radio: ออบเจกต์ {value, label} หรือสตริงธรรมดา
idไม่มีชื่อแบบมีจุดที่คงที่สำหรับข้อมูลนั้น เช่น finance.ap.invoice_mailbox เพื่อให้พนักงานคนอื่นใช้ร่วมกันได้
scopecompanycompany: ข้อมูลบริษัทที่ใช้ร่วมกัน seat: เฉพาะการจ้างครั้งนี้
missingไม่มีสิ่งที่พนักงานทำขณะที่คำถามยังไม่ได้รับคำตอบ
moneyfalseทำเครื่องหมายว่าเป็นจำนวนเงิน คำถามเรื่องเงินมีค่าเริ่มต้นไม่ได้

เครื่องมือ Sidecar

แอปที่มี sidecar เปิดเผย HTTP endpoint ให้พนักงานใช้เป็นเครื่องมือ Nebo ลงทะเบียนแต่ละรายการเป็น app__<app>__<name> และส่งการเรียกไปยัง sidecar ที่ method และ path ดู App Sidecar

"tools": [
  {
    "name": "list_entries",
    "description": "List journal entries for a date range.",
    "method": "GET",
    "path": "/entries",
    "input_schema": { "type": "object", "properties": { "from": { "type": "string" } } }
  }
]

เวิร์กโฟลว์

แต่ละคีย์ใต้ workflows ตั้งชื่อเวิร์กโฟลว์หนึ่งรายการ ชื่อนั้นคือตัวระบุ รูปแบบฉบับเต็มอยู่ที่ เวิร์กโฟลว์ ทริกเกอร์ และ กิจกรรม