模型
- 能力是一个类型化的接口,从来不是某个产品。
mail包含mail.inbox.read、mail.inbox.search和mail.message.send这几个操作。 - 员工包在
requires.interfaces中列出其岗位所需的能力。 - 插件通过在
interfaceBindings中把这些操作绑定到自己的命令上来提供某项能力。 - 连接是所有者为该能力连接的插件。指定了某项能力的监视触发器就在这个连接上运行。
声明岗位需要什么
{
"requires": { "interfaces": ["mail", "ledger"] },
"ceiling": { "ledger.bill.create": "approval" }
} 写能力,不要写插件。一个需要 ledger 的员工包适用于每一家公司,无论它用的是哪个会计系统。只有当某个岗位确实依赖某个特定插件时,才使用 requires.plugins。
提供能力
"interfaceBindings": {
"mail.inbox.read": "messages list --folder inbox",
"mail.inbox.search": "messages search --query {query}",
"mail.message.send": "messages send"
} 绑定了任何 mail.* 操作的插件就提供了 mail。每个绑定也会成为员工可用的一个类型化工具,例如 mail_message_send。模板语法请参见 plugin.json 参考。
当某个工作流监视一项能力时,Nebo 会挑选提供该能力的已安装插件,优先选择这位员工在其中有账户的插件,其次按字母顺序。如果一个都没有,该工作流会被保留并标记为降级,同时告诉所有者需要连接什么。
目录
Nebo 自带一份能力及其操作的目录,包括 ledger、mail、sms、telephony、calendar、drive、helpdesk、kb、deals、esign、timebilling、projects、cms、social、ads、reviews、email-marketing、repo、ci、deploy、monitoring 和 incidents。这份目录是共享的用语,而不是一道围栏。只要有合适的术语就使用它,这样来自不同发布者的员工和插件才能对接上;新的术语只是约定问题,不是错误。
每个操作都带有三种标记之一。
| 标记 | 含义 |
|---|---|
| 无需审批 | 读取操作,或者可逆、且一旦等待就会失去意义的保护性操作,例如暂停、取消或回滚。无需询问即可运行。 |
| 需审批 | 涉及转移资金、联系公司以外的人,或无法撤销。Nebo 会在绑定的工具运行前先询问。 |
| 关键 | 涉及资金流动、订立合同、公司自身的记录,或在无人值守时行事的长期授权。始终受审批控制;所有者需要按员工、按操作逐一授予,任何员工级别的设置都不能放宽它。 |
聘用时的同意
当所有者聘用一位员工时,Nebo 会从员工包中读取它的需求:requires.interfaces 中的能力、requires.plugins 中的插件,以及监视触发器指定的每项能力或插件。所有者会看到一句说明这些需求的话。聘用即把它们作为长期权限授予这位员工。需审批的操作仍然是审批项。
安装插件、MCP 服务器、应用或技能,本身就是授权使用它;这些不需要逐一开启。Nebo 自身的内置能力分为 chat、file、shell、web、contacts、desktop、media 和 system 几组。
上限与法规
| 声明位置 | 效果 |
|---|---|
agent.json 中的 ceiling | 对这位员工而言,所列操作始终要询问所有者。唯一的取值是 "approval"。 |
公司层中法规的 ceiling | 所列操作对所有员工都被禁止。 |
带有 reserved_to: owner 的公司法规 | 所列操作需要所有者本人批准,而且这种批准永远不能授予员工。 |
权限模式
每位员工都有一个权限模式。它决定那些没有任何规则覆盖的调用如何处理,所有者也可以针对单次运行覆盖它。
| 模式 | 行为 |
|---|---|
automatic | 默认模式。员工在自己的职责范围内行事,只对需审批的操作和所有者的询问规则进行询问。 |
ask | 每个会改变东西的调用都要询问,除非有允许规则覆盖它。 |
plan | 只读取和规划。会改变任何东西的调用都不会运行。 |
full_access | 什么都不询问。拒绝规则和硬性限制仍然有效。 |
Nebo 按照同样的顺序检查每个动作:先是硬性限制,然后是上限和法规,再是所有者的规则,最后是模式。硬性限制(例如防止凭据泄露)永远不会解除,即使在 full_access 模式下也不例外。