模型
- 能力是一種具型別的介面,絕不是產品。
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 中也一樣。