NeboAI
NeboAI
开始使用

能力与审批

能力指的是某一类系统(例如邮件或账本)以及可以对它执行的操作。员工包声明它们需要的能力;插件声明它们提供的能力;所有者在聘用时把两者连接起来。审批附加在操作上,因此无论由哪个系统来承担这项能力,规则都相同。

模型

  • 能力是一个类型化的接口,从来不是某个产品。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 模式下也不例外。