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

แพ็กเกจพนักงาน

แพ็กเกจพนักงานอธิบายตำแหน่งที่บริษัทจ้างได้ ว่าพนักงานรับผิดชอบอะไร ทำงานอย่างไร ต้องใช้ระบบประเภทใด และทำอะไรได้เอง คุณเขียนเป็นโฟลเดอร์ที่มี AGENT.md และเมื่อตำแหน่งนั้นต้องการมากกว่าแชท ก็เพิ่ม agent.json

แพ็กเกจ

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 จะ:

  1. อ่านความต้องการของแพ็กเกจโดยไม่ต้องถามโมเดล ได้แก่ ทุกความสามารถใน requires.interfaces ทุกปลั๊กอินใน requires.plugins และทุกความสามารถหรือปลั๊กอินที่ทริกเกอร์ watch ระบุ
  2. แสดงประโยคขอความยินยอมหนึ่งประโยคสำหรับความต้องการเหล่านั้นแก่เจ้าของ และเมื่อจ้าง จะมอบสิทธิ์เหล่านั้นให้พนักงานคนนี้เป็นสิทธิ์ถาวร การดำเนินการที่ต้องได้รับอนุมัติยังคงต้องอนุมัติเหมือนเดิม ดู ความสามารถและการอนุมัติ
  3. ติดตั้งสิ่งที่ต้องพึ่งพา ได้แก่ ปลั๊กอินใน requires.plugins ทักษะจากมาร์เก็ตเพลสที่ระบุใน skills และในกิจกรรม และสิ่งที่ต้องพึ่งพาที่ประกาศไว้ตอนเผยแพร่แพ็กเกจ
  4. ถามคำถามใน inputs กับเจ้าของ และแจ้งเจ้าของผ่านกล่องข้อความเกี่ยวกับความสามารถที่ยังไม่มีการเชื่อมต่อ

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

สิ่งที่ Nebo ตรวจสอบ

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

  • ทริกเกอร์ event ที่มีรายการ sources ว่าง
  • กิจกรรมสองรายการที่มี id เดียวกันในเวิร์กโฟลว์เดียว
  • อินพุตที่มี scope อื่นนอกจาก company หรือ seat หรือคำถามเรื่องเงินที่มีค่าเริ่มต้น
  • ค่า ceiling อื่นนอกจาก "approval"
  • ผังการรับสายโทรศัพท์ที่ไม่มีคำทักทายหนึ่งรายการพอดี และไม่มีเจตนาที่ตั้งชื่อไว้อย่างน้อยหนึ่งรายการ

การตรวจสอบบางอย่างทำงานตอนที่เวิร์กโฟลว์เริ่ม ไม่ใช่ตอนโหลด เช่น พารามิเตอร์ที่กิจกรรมแต่ละประเภทต้องการ ดู กิจกรรม

เขียนหน้าที่ความรับผิดชอบ ไม่ใช่เครื่องมือ แพ็กเกจพนักงานระบุความสามารถ เช่น ledger หรือ mail และไม่ระบุผลิตภัณฑ์ บริษัท หรืออุตสาหกรรมเฉพาะ เจ้าของเป็นผู้ตัดสินใจว่าระบบใดจะทำหน้าที่แต่ละความสามารถ แพ็กเกจเดียวจึงใช้ได้กับทุกบริษัทที่จ้าง

ถัดไป