Gói
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 | Tệp | Bắt buộc | Mục đích |
|---|---|---|
AGENT.md | có | Tính cách: nhân viên là ai, làm việc ra sao và các quy tắc của họ. Xem Tính cách và bộ nhớ. |
agent.json | không | Các khả năng cần có, câu hỏi cho chủ sở hữu, quy trình, cài đặt bộ nhớ và mức trần phê duyệt. Xem Tham chiếu agent.json. |
skills/ | không | Các kỹ năng theo định dạng SKILL.md tiêu chuẩn. Chỉ nhân viên này thấy chúng. |
manifest.json | chỉ với ứng dụng | Danh tính với "type": "app". Chợ ứng dụng tự viết manifest khi đóng gói một nhân viên. |
ui/ | chỉ với ứng dụng | Trang của ứng dụng. Xem Ứng dụng. |
Viết một gói
Bắt đầu với tính cách. Frontmatter đặt tên nhân viên và đưa ra một dòng mô tả; phần thân là chỉ dẫn bằng văn xuôi thông thường.
--- 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.
Thêm agent.json khi vai trò cần một hệ thống, một cài đặt từ chủ sở hữu, hoặc công việc mà nhân viên tự làm mà không cần được yêu cầu. Tệp này yêu cầu khả năng mail, hỏi một câu khi tuyển và trả lời từng tin nhắn mới ngay khi đến.
{
"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."
}
]
}
}
} Phần theo dõi gọi tên khả năng mail, không phải một sản phẩm. Khi chạy, nó được phân giải thành plugin mà chủ sở hữu đã kết nối cho thư. Xem Quy trình để biết về trình kích hoạt và hoạt động.
Tải lên một bot
Đặt thư mục vào <data>/user/agents/<name>/. Nebo theo dõi AGENT.md, agent.json và manifest.json và tải lại nhân viên khoảng một giây sau khi có thay đổi. Xóa thư mục sẽ vô hiệu hóa nhân viên nhưng vẫn giữ hồ sơ của họ.
Nebo tải nhân viên từ ba nguồn, và nguồn sau được ưu tiên hơn: nhân viên tích hợp sẵn trong Nebo, các gói đã niêm phong từ chợ ứng dụng trong <data>/nebo/agents/, và các thư mục trong <data>/user/agents/. Một nhân viên cũng có thể tạo hoặc thay đổi gói cho bạn bằng các công cụ create_employee và update_employee, vốn ghi vào cùng thư mục đó.
Điều gì xảy ra khi tuyển
Khi chủ sở hữu tuyển nhân viên của bạn từ chợ ứng dụng hoặc bằng mã AGNT-, Nebo sẽ:
- Đọc các nhu cầu của gói mà không cần hỏi mô hình: mọi khả năng trong
requires.interfaces, mọi plugin trongrequires.plugins, và mọi khả năng hoặc plugin mà một trình kích hoạt theo dõi gọi tên. - Hiển thị cho chủ sở hữu một câu đồng ý cho các nhu cầu đó và, khi tuyển, cấp chúng cho nhân viên này dưới dạng quyền thường trực. Các thao tác cần phê duyệt vẫn giữ nguyên như vậy. Xem Khả năng và phê duyệt.
- Cài đặt các phụ thuộc: plugin trong
requires.plugins, các kỹ năng từ chợ ứng dụng được nêu trongskillsvà trong các hoạt động, cùng các phụ thuộc đã khai báo khi gói được xuất bản. - Hỏi chủ sở hữu các câu hỏi trong
inputs, và thông báo cho chủ sở hữu qua Hộp thư đến về bất kỳ khả năng nào chưa có kết nối.
Một quy trình có khả năng chưa được kết nối vẫn được giữ lại và đánh dấu là suy giảm, kèm lý do. Quy trình bắt đầu hoạt động ngay khi chủ sở hữu kết nối một hệ thống.
Những gì Nebo kiểm tra
Nebo đọc agent.json một cách khoan dung. Các khóa không xác định bị bỏ qua. Một quy trình không khớp lược đồ sẽ bị bỏ qua, và chủ sở hữu nhận thông báo trong Hộp thư đến rằng quy trình đó sẽ không chạy; phần còn lại của nhân viên vẫn được tải. Những vấn đề sau khiến toàn bộ tệp bị từ chối:
- Một trình kích hoạt
eventcó danh sáchsourcestrống. - Hai hoạt động có cùng
idtrong một quy trình. - Một đầu vào có
scopekháccompanyhoặcseat, hoặc một câu hỏi về tiền có giá trị mặc định. - Một giá trị
ceilingkhác"approval". - Một cây cuộc gọi điện thoại không có đúng một lời chào và ít nhất một ý định có tên.
Một số kiểm tra chạy khi quy trình bắt đầu thay vì khi tải, chẳng hạn như các tham số mà từng loại hoạt động yêu cầu. Xem Hoạt động.
Viết trách nhiệm, không phải công cụ. Một gói nhân viên gọi tên các khả năng, như ledger hoặc mail, và không bao giờ gọi tên một sản phẩm, công ty hay ngành cụ thể. Chủ sở hữu quyết định hệ thống nào đảm nhận từng khả năng, nên một gói phục vụ được mọi công ty tuyển nó.
Tiếp theo
- Tham chiếu agent.json
- Tính cách và bộ nhớ
- Xuất bản: đưa nhân viên lên chợ ứng dụng.