ตัวอย่าง
{
"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/ ของแพ็กเกจเองไม่ต้องระบุ |
inputs | list | คำถามที่เจ้าของตอบตอนจ้าง ดู อินพุต |
memory | object | วิธีเก็บบทสนทนาและความทรงจำ ดู บุคลิกและความทรงจำ |
subscribes | รายการสตริง | ด้านข้อมูลบริษัทที่พนักงานอ่านใหม่เมื่อมีการเปลี่ยนแปลง เช่น finance.ar.* |
ceiling | map | การดำเนินการไปยัง "approval" การดำเนินการนั้นจะถามเจ้าของเสมอสำหรับพนักงานคนนี้ ไม่รับค่าอื่น |
workflows | map | ชื่อเวิร์กโฟลว์ไปยังเวิร์กโฟลว์ ดู เวิร์กโฟลว์ |
tools | list | เครื่องมือ HTTP ที่ sidecar ของแอปให้บริการ ดู เครื่องมือ Sidecar |
scopes | map | กลุ่มของ 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 | คำถามที่แสดงต่อเจ้าของ |
type | text | text, textarea, number, select, checkbox หรือ radio |
required | false | ทำเครื่องหมายว่าเป็นคำถามที่เจ้าของต้องตอบ |
default | ไม่มี | คำตอบที่กรอกไว้ล่วงหน้า ไม่อนุญาตสำหรับคำถามเรื่องเงิน |
placeholder, description | ไม่มี | ข้อความช่วยเหลือ |
options | ไม่มี | สำหรับ select และ radio: ออบเจกต์ {value, label} หรือสตริงธรรมดา |
id | ไม่มี | ชื่อแบบมีจุดที่คงที่สำหรับข้อมูลนั้น เช่น finance.ap.invoice_mailbox เพื่อให้พนักงานคนอื่นใช้ร่วมกันได้ |
scope | company | company: ข้อมูลบริษัทที่ใช้ร่วมกัน seat: เฉพาะการจ้างครั้งนี้ |
missing | ไม่มี | สิ่งที่พนักงานทำขณะที่คำถามยังไม่ได้รับคำตอบ |
money | false | ทำเครื่องหมายว่าเป็นจำนวนเงิน คำถามเรื่องเงินมีค่าเริ่มต้นไม่ได้ |
เครื่องมือ 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 ตั้งชื่อเวิร์กโฟลว์หนึ่งรายการ ชื่อนั้นคือตัวระบุ รูปแบบฉบับเต็มอยู่ที่ เวิร์กโฟลว์ ทริกเกอร์ และ กิจกรรม