แพ็กเกจ
support-coordinator/
├── AGENT.md # required: who the employee is and how it works
├── agent.json # optional: capabilities, inputs, workflows, memory
└── skills/ # optional: skills only this employee uses
└── reply-drafting/
└── SKILL.md | ไฟล์ | จำเป็น | วัตถุประสงค์ |
|---|---|---|
AGENT.md | ใช่ | บุคลิก: พนักงานเป็นใคร ทำงานอย่างไร และมีกฎอะไร ดู บุคลิกและความทรงจำ |
agent.json | ไม่ | ความสามารถที่ต้องใช้ คำถามสำหรับเจ้าของ เวิร์กโฟลว์ การตั้งค่าความทรงจำ และเพดานการอนุมัติ ดู ข้อมูลอ้างอิง agent.json |
skills/ | ไม่ | ทักษะในรูปแบบ SKILL.md มาตรฐาน มีเพียงพนักงานคนนี้ที่เห็น |
manifest.json | เฉพาะแอป | ข้อมูลระบุตัวตนที่มี "type": "app" มาร์เก็ตเพลสจะเขียน manifest ของตัวเองเมื่อแพ็กเกจพนักงาน |
ui/ | เฉพาะแอป | หน้าของแอป ดู แอป |
เขียนแพ็กเกจ
เริ่มจากบุคลิก frontmatter ตั้งชื่อพนักงานและให้คำอธิบายหนึ่งบรรทัด ส่วนเนื้อหาคือคำแนะนำที่เขียนเป็นร้อยแก้วธรรมดา
--- name: Support Coordinator description: Answers every customer message the day it arrives and escalates what it cannot settle. --- # Support Coordinator You answer customer email for the company. Reply within the configured window, in the company's voice, and keep every thread moving until the customer has an answer. ## How you work - Read the whole thread before you reply. - Use the reply-drafting skill for every customer reply. - When a message is about money, draft a proposal for the owner instead of promising anything. ## Rules - Never promise a refund, a discount or a date you cannot confirm.
เพิ่ม agent.json เมื่อตำแหน่งนั้นต้องใช้ระบบ การตั้งค่าจากเจ้าของ หรืองานที่ทำโดยไม่ต้องสั่ง ตัวอย่างนี้ต้องใช้ความสามารถ mail ถามหนึ่งคำถามตอนจ้าง และตอบทุกข้อความใหม่ทันทีที่มาถึง
{
"requires": { "interfaces": ["mail"] },
"inputs": [
{
"key": "reply_window_hours",
"label": "Reply within (hours)",
"type": "number",
"id": "support.reply_window_hours",
"scope": "company",
"default": 24
}
],
"workflows": {
"new-mail": {
"trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
"description": "Handle each customer message as it arrives.",
"activities": [
{
"id": "reply",
"intent": "Read the message in _watch_payload, draft a reply within reply_window_hours, and escalate anything about money to the owner."
}
]
}
}
} watch ระบุความสามารถ mail ไม่ใช่ผลิตภัณฑ์ ขณะรันจะแปลงเป็นปลั๊กอินที่เจ้าของเชื่อมต่อไว้สำหรับอีเมล ดู เวิร์กโฟลว์ สำหรับทริกเกอร์และกิจกรรม
โหลดบนบอท
วางโฟลเดอร์ไว้ใน <data>/user/agents/<name>/ Nebo เฝ้าดู AGENT.md, agent.json และ manifest.json และโหลดพนักงานใหม่ประมาณหนึ่งวินาทีหลังมีการเปลี่ยนแปลง การนำโฟลเดอร์ออกจะปิดใช้งานพนักงานแต่ยังเก็บบันทึกไว้
Nebo โหลดพนักงานจากสามแหล่ง และแหล่งที่มาทีหลังมีลำดับเหนือกว่า ได้แก่ พนักงานที่มีในตัว Nebo แพ็กเกจมาร์เก็ตเพลสแบบปิดผนึกใน <data>/nebo/agents/ และโฟลเดอร์ใน <data>/user/agents/ พนักงานยังสร้างหรือแก้ไขแพ็กเกจให้คุณได้ด้วยเครื่องมือ create_employee และ update_employee ซึ่งเขียนลงโฟลเดอร์เดียวกัน
สิ่งที่เกิดขึ้นตอนจ้าง
เมื่อเจ้าของจ้างพนักงานของคุณจากมาร์เก็ตเพลสหรือด้วยรหัส AGNT- Nebo จะ:
- อ่านความต้องการของแพ็กเกจโดยไม่ต้องถามโมเดล ได้แก่ ทุกความสามารถใน
requires.interfacesทุกปลั๊กอินในrequires.pluginsและทุกความสามารถหรือปลั๊กอินที่ทริกเกอร์ watch ระบุ - แสดงประโยคขอความยินยอมหนึ่งประโยคสำหรับความต้องการเหล่านั้นแก่เจ้าของ และเมื่อจ้าง จะมอบสิทธิ์เหล่านั้นให้พนักงานคนนี้เป็นสิทธิ์ถาวร การดำเนินการที่ต้องได้รับอนุมัติยังคงต้องอนุมัติเหมือนเดิม ดู ความสามารถและการอนุมัติ
- ติดตั้งสิ่งที่ต้องพึ่งพา ได้แก่ ปลั๊กอินใน
requires.pluginsทักษะจากมาร์เก็ตเพลสที่ระบุในskillsและในกิจกรรม และสิ่งที่ต้องพึ่งพาที่ประกาศไว้ตอนเผยแพร่แพ็กเกจ - ถามคำถามใน
inputsกับเจ้าของ และแจ้งเจ้าของผ่านกล่องข้อความเกี่ยวกับความสามารถที่ยังไม่มีการเชื่อมต่อ
เวิร์กโฟลว์ที่ความสามารถยังไม่มีการเชื่อมต่อจะถูกเก็บไว้และทำเครื่องหมายว่าทำงานได้ไม่เต็มที่ พร้อมเหตุผล และจะเริ่มทำงานทันทีที่เจ้าของเชื่อมต่อระบบ
สิ่งที่ Nebo ตรวจสอบ
Nebo อ่าน agent.json แบบผ่อนปรน คีย์ที่ไม่รู้จักจะถูกละเว้น เวิร์กโฟลว์ที่ไม่ตรงกับสคีมาจะถูกข้าม และเจ้าของจะได้รับแจ้งในกล่องข้อความว่าเวิร์กโฟลว์นั้นจะไม่ทำงาน ส่วนที่เหลือของพนักงานยังโหลดได้ ปัญหาต่อไปนี้จะทำให้ปฏิเสธทั้งไฟล์:
- ทริกเกอร์
eventที่มีรายการsourcesว่าง - กิจกรรมสองรายการที่มี
idเดียวกันในเวิร์กโฟลว์เดียว - อินพุตที่มี
scopeอื่นนอกจากcompanyหรือseatหรือคำถามเรื่องเงินที่มีค่าเริ่มต้น - ค่า
ceilingอื่นนอกจาก"approval" - ผังการรับสายโทรศัพท์ที่ไม่มีคำทักทายหนึ่งรายการพอดี และไม่มีเจตนาที่ตั้งชื่อไว้อย่างน้อยหนึ่งรายการ
การตรวจสอบบางอย่างทำงานตอนที่เวิร์กโฟลว์เริ่ม ไม่ใช่ตอนโหลด เช่น พารามิเตอร์ที่กิจกรรมแต่ละประเภทต้องการ ดู กิจกรรม
เขียนหน้าที่ความรับผิดชอบ ไม่ใช่เครื่องมือ แพ็กเกจพนักงานระบุความสามารถ เช่น ledger หรือ mail และไม่ระบุผลิตภัณฑ์ บริษัท หรืออุตสาหกรรมเฉพาะ เจ้าของเป็นผู้ตัดสินใจว่าระบบใดจะทำหน้าที่แต่ละความสามารถ แพ็กเกจเดียวจึงใช้ได้กับทุกบริษัทที่จ้าง
ถัดไป
- ข้อมูลอ้างอิง agent.json
- บุคลิกและความทรงจำ
- การเผยแพร่: นำพนักงานขึ้นมาร์เก็ตเพลส