AGENT.md
AGENT.md là Markdown thuần. Bắt đầu bằng frontmatter đặt tên nhân viên và đưa ra một dòng mô tả; cả chợ ứng dụng và đội ngũ AI của chủ sở hữu đều dùng hai thông tin này. Sau đó viết tính cách ở ngôi thứ hai: trách nhiệm của nhân viên, cách họ làm việc và các quy tắc của họ.
--- name: Collections Specialist description: Follows up on every overdue invoice until it is paid, disputed, or handed to the owner. --- # Collections Specialist You keep receivables moving. Every overdue invoice gets a follow-up on schedule, in a tone that protects the customer relationship. ## How you work - Check the aging report before any follow-up so you never chase a paid invoice. - Escalate to the owner when a customer disputes an amount. ## Rules - Never threaten, and never mention collections agencies. - Never agree to a payment plan; propose it to the owner.
Nebo cung cấp tính cách cho nhân viên khi bắt đầu mỗi phiên, cùng với tên, mô tả và mọi trình kích hoạt từ frontmatter, và các cài đặt mà chủ sở hữu đặt cho nhân viên trong Nebo: tính cách, quy tắc và tâm hồn. Tính cách là riêng của nhân viên; nó không bao giờ được thêm vào prompt mà các nhân viên khác dùng chung.
Hãy viết vai trò chịu trách nhiệm gì và quyết định ra sao. Đừng đưa tên công cụ hay tên sản phẩm vào: công cụ của nhân viên đến từ các khả năng và kết nối, và cùng một tính cách phải hoạt động được ở mọi công ty tuyển nhân viên đó.
Bộ nhớ
Mỗi nhân viên đọc các thông tin riêng của chủ sở hữu và chỉ ghi vào bộ nhớ của chính mình. Nhân viên làm việc với bộ nhớ qua các công cụ remember, recall và forget. Chọn cách lưu giữ cuộc trò chuyện và bộ nhớ bằng memory.mode trong agent.json.
| Chế độ | Hành vi | Dùng cho |
|---|---|---|
single | Một cuộc trò chuyện liên tục và một bộ nhớ. Đây là mặc định. | Hầu hết các vai trò. |
separate | Nhiều cuộc trò chuyện dùng chung bộ nhớ riêng của nhân viên. Cuộc trò chuyện với người khác ngoài chủ sở hữu, chẳng hạn người gọi điện hoặc khách truy cập, có bộ nhớ niêm phong riêng. | Các vai trò trò chuyện với nhiều người. |
confidential | Mỗi cuộc trò chuyện là một vụ việc được niêm phong. Không điều gì học được ở cuộc này hiển thị ở cuộc khác, kể cả cuộc trò chuyện của chủ sở hữu. | Các vụ việc của khách hàng cần được tách biệt. |
"memory": {
"mode": "separate",
"topics": [
{ "slug": "account", "description": "A customer account: balance, promises to pay, contacts, disputes" }
],
"write_bar": ["web", "external-email"],
"share_with": []
} | Trường | Ý nghĩa |
|---|---|
mode | single, separate hoặc confidential. Giá trị cũ context_isolated: true được hiểu là separate. |
topics | Tối đa 8 cặp {slug, description} cho nhân viên biết những loại thông tin cần ghi nhớ. Slug viết thường, nối bằng dấu gạch ngang; mô tả dài từ 1 đến 120 ký tự. Các slug dành riêng: tacit, entity, daily, project, memory, style, artifact. |
write_bar | Một lần chạy đã tiếp nhận nội dung từ một trong các nguồn sau thì không được ghi vào bộ nhớ: web, external-email, channel, document, phone, coworker. Khi bỏ trống, channel và phone bị chặn ở chế độ separate và confidential. Một danh sách trống sẽ tắt việc chặn này. |
share_with | ID nhân viên, hoặc *, được phép nhận bộ nhớ của nhân viên này trong các câu trả lời gửi cho họ. Mặc định để trống, nghĩa là không chia sẻ gì. |
Lớp thông tin công ty
Lớp thông tin công ty là kiến thức mà mọi nhân viên dùng chung: thuật ngữ của công ty, các bên mà công ty làm việc cùng, các quy tắc, luật lệ, tiêu chuẩn và tài liệu tham khảo. Lớp này nằm trong các gói trên bot. Một gói là một thư mục có đúng một tệp đánh dấu, INDUSTRY.md, FRANCHISE.md hoặc COMPANY.md, cùng các thư mục theo loại bên cạnh. Khi các lớp mâu thuẫn, lớp công ty được ưu tiên hơn lớp nhượng quyền, và lớp nhượng quyền được ưu tiên hơn lớp ngành.
<data>/packs/example-co/ ├── COMPANY.md ├── vocabulary/ ├── parties/ ├── rules/ ├── laws/ │ └── refunds.md ├── standards/ ├── workflows/ └── reference/
Mỗi tệp trong một thư mục là Markdown với frontmatter tùy chọn. Frontmatter chứa cấu trúc, chẳng hạn always của một quy tắc, id và value của một tiêu chuẩn, hoặc ceiling của một luật; phần thân chứa văn xuôi. Một gói chứa kiến thức, không bao giờ chứa quy trình thao tác, vì vậy gói có chứa kỹ năng sẽ bị từ chối.
Luật
ceiling của một luật liệt kê những thao tác mà không nhân viên nào được thực hiện. Ở lớp công ty, reserved_to: owner thay đổi điều đó: các thao tác vẫn có thể thực hiện, nhưng chỉ khi có sự phê duyệt của chính chủ sở hữu, và quyền phê duyệt đó không bao giờ có thể được trao cho người khác.
--- ceiling: [ledger.refund.create] reserved_to: owner --- Refunds are issued only by the owner. Employees may prepare a refund and send it to the owner for approval.
Cách nhân viên học lớp thông tin
Nhân viên không tra cứu lớp thông tin trong lúc làm việc. Khi một lớp thay đổi, mỗi nhân viên đọc thay đổi đó một lần và viết lại các quy tắc của chính mình. Chủ sở hữu luôn có thể chỉnh sửa COMPANY.md và mọi thư mục của công ty; lưu một thay đổi chính là cách chủ sở hữu khẳng định điều gì là đúng.