Mô hình
- Một khả năng là một interface có kiểu, không bao giờ là một sản phẩm.
mailcó các thao tácmail.inbox.read,mail.inbox.searchvàmail.message.send. - Một gói nhân viên liệt kê các khả năng mà vai trò cần trong
requires.interfaces. - Một plugin cung cấp một khả năng bằng cách liên kết các thao tác của khả năng đó với các lệnh của chính plugin trong
interfaceBindings. - Một kết nối là plugin mà chủ sở hữu đã kết nối cho khả năng đó. Một trình kích hoạt theo dõi gọi tên một khả năng sẽ chạy trên kết nối này.
Khai báo những gì một vai trò cần
{
"requires": { "interfaces": ["mail", "ledger"] },
"ceiling": { "ledger.bill.create": "approval" }
} Gọi tên khả năng, không phải plugin. Một gói nhân viên yêu cầu ledger sẽ hoạt động với mọi công ty, dù họ dùng hệ thống kế toán nào. Chỉ dùng requires.plugins khi vai trò thực sự phụ thuộc vào một plugin cụ thể.
Cung cấp một khả năng
"interfaceBindings": {
"mail.inbox.read": "messages list --folder inbox",
"mail.inbox.search": "messages search --query {query}",
"mail.message.send": "messages send"
} Một plugin liên kết bất kỳ thao tác mail.* nào sẽ cung cấp mail. Mỗi liên kết cũng trở thành một công cụ có kiểu cho nhân viên, chẳng hạn mail_message_send. Cú pháp mẫu có trong tham chiếu plugin.json.
Khi một quy trình theo dõi một khả năng, Nebo chọn plugin đã cài có cung cấp khả năng đó, ưu tiên plugin mà nhân viên này có tài khoản, sau đó theo thứ tự bảng chữ cái. Nếu không có plugin nào, quy trình vẫn được giữ, bị đánh dấu là suy giảm, và chủ sở hữu được báo cần kết nối gì.
Danh mục
Nebo đi kèm một danh mục các khả năng và thao tác của chúng, bao gồm ledger, mail, sms, telephony, calendar, drive, helpdesk, kb, deals, esign, timebilling, projects, cms, social, ads, reviews, email-marketing, repo, ci, deploy, monitoring và incidents. Danh mục là bộ từ vựng chung, không phải hàng rào. Hãy dùng các thuật ngữ của nó ở bất cứ đâu phù hợp để nhân viên và plugin từ các nhà xuất bản khác nhau có thể kết hợp với nhau; một thuật ngữ mới là vấn đề quy ước, không phải lỗi.
Mỗi thao tác mang một trong ba nhãn.
| Nhãn | Ý nghĩa |
|---|---|
| Không cần phê duyệt | Một thao tác đọc, hoặc một hành động bảo vệ có thể hoàn tác và mất giá trị nếu phải chờ, chẳng hạn tạm dừng, hủy hoặc quay lui. Chạy mà không cần hỏi. |
| Cần phê duyệt | Chuyển tiền, liên hệ với người bên ngoài công ty, hoặc không thể hoàn tác. Nebo hỏi trước khi công cụ được liên kết chạy. |
| Trọng yếu | Chuyển tiền, ký kết hợp đồng, hồ sơ riêng của công ty, hoặc thẩm quyền thường trực để hành động khi không có người giám sát. Luôn cần phê duyệt; chủ sở hữu cấp từng quyền cho từng nhân viên và từng thao tác, và không có cài đặt nào áp dụng cho toàn bộ nhân viên có thể nới lỏng điều này. |
Sự đồng ý khi tuyển
Khi chủ sở hữu tuyển một nhân viên, Nebo đọc nhu cầu của nhân viên đó từ gói: các khả năng trong requires.interfaces, các plugin trong requires.plugins, và từng khả năng hoặc plugin mà một trình kích hoạt theo dõi gọi tên. Chủ sở hữu thấy một câu nêu rõ những nhu cầu đó. Việc tuyển dụng cấp chúng cho nhân viên đó dưới dạng quyền thường trực. Các thao tác cần phê duyệt vẫn là mục cần phê duyệt.
Việc cài một plugin, một máy chủ MCP, một ứng dụng hay một kỹ năng tự nó đã là sự cấp quyền để dùng; chúng không cần bật từng cái một. Các khả năng tích hợp sẵn của chính Nebo được nhóm thành chat, file, shell, web, contacts, desktop, media và system.
Mức trần và luật
| Khai báo trong | Tác động |
|---|---|
ceiling trong agent.json | Các thao tác được liệt kê luôn hỏi chủ sở hữu đối với nhân viên này. Giá trị duy nhất là "approval". |
ceiling của một luật trong lớp thông tin công ty | Các thao tác được liệt kê bị chặn với mọi nhân viên. |
Một luật của công ty với reserved_to: owner | Các thao tác được liệt kê cần 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 cấp cho nhân viên. |
Chế độ quyền
Mỗi nhân viên có một chế độ quyền. Chế độ này quyết định những lệnh gọi mà không quy tắc nào xử lý, và chủ sở hữu có thể ghi đè nó cho một lần chạy.
| Chế độ | Hành vi |
|---|---|
automatic | Mặc định. Nhân viên hành động trong phạm vi công việc và chỉ hỏi đối với các thao tác cần phê duyệt và các quy tắc hỏi trước của chủ sở hữu. |
ask | Mọi lệnh gọi làm thay đổi điều gì đó đều phải hỏi, trừ khi có quy tắc cho phép bao quát nó. |
plan | Chỉ đọc và lập kế hoạch. Lệnh gọi làm thay đổi điều gì đó sẽ không chạy. |
full_access | Không hỏi gì cả. Các quy tắc từ chối và giới hạn cứng vẫn có hiệu lực. |
Nebo kiểm tra mọi hành động theo cùng một thứ tự: giới hạn cứng trước, sau đó đến mức trần và luật, rồi đến quy tắc của chủ sở hữu, cuối cùng là chế độ. Giới hạn cứng, chẳng hạn bảo vệ thông tin đăng nhập khỏi bị rò rỉ, không bao giờ được gỡ bỏ, kể cả ở full_access.