モデル
- 機能は型付きのインターフェースであり、製品ではありません。
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は、役割が本当に特定の1つのプラグインに依存する場合にだけ使ってください。
機能を提供する
"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などです。カタログは共通の語彙であって、柵ではありません。異なるパブリッシャーの社員とプラグインが出会えるよう、合う用語があれば必ずそれを使ってください。新しい用語は慣習の問題であって、エラーではありません。
各操作には、3つの印のいずれかが付きます。
| 印 | 意味 |
|---|---|
| 承認不要 | 読み取り、または元に戻せて、待つと価値を失う保護的な操作(一時停止、キャンセル、ロールバックなど)。確認なしで実行されます。 |
| 承認制 | お金を動かす、社外の誰かに連絡する、または元に戻せない操作。結びつけられたツールが実行される前に、Neboが確認します。 |
| 重要 | お金の移動、契約の成立、会社自身の記録、無人で行動する常設の権限。常に承認が必要です。オーナーは社員ごと、操作ごとに1つずつ許可し、社員全体の設定でこれを緩めることはできません。 |
雇用時の同意
オーナーが社員を雇うと、Neboはパッケージから要件を読み取ります。requires.interfacesの機能、requires.pluginsのプラグイン、そしてウォッチトリガーが指定する各機能またはプラグインです。オーナーには、それらの要件を述べた1文が表示されます。雇用によって、それらがその社員に常設の権限として付与されます。承認制の操作は、承認項目のままです。
プラグイン、MCPサーバー、アプリ、スキルのインストールは、それ自体がその利用の許可になります。1つずつオンにする必要はありません。Nebo自身の組み込み機能は、chat、file、shell、web、contacts、desktop、media、systemにまとめられています。
上限と法令
| 宣言する場所 | 効果 |
|---|---|
agent.jsonのceiling | 列挙された操作は、この社員については常にオーナーに確認します。指定できる値は"approval"だけです。 |
会社レイヤーにある法令のceiling | 列挙された操作は、すべての社員に対して禁止されます。 |
reserved_to: ownerを持つ会社の法令 | 列挙された操作にはオーナー自身の承認が必要で、その承認を社員に委ねることは決してできません。 |
権限モード
社員にはそれぞれ権限モードがあります。どのルールでも決まらない呼び出しをどうするかを決めるもので、オーナーは1回の実行に限って変更できます。
| モード | 動作 |
|---|---|
automatic | デフォルト。社員は自分の職務の範囲内で行動し、承認制の操作とオーナーの確認ルールについてのみ確認します。 |
ask | 何かを変更する呼び出しはすべて確認します。許可ルールで認められている場合を除きます。 |
plan | 読み取りと計画のみ。何かを変更する呼び出しは実行されません。 |
full_access | 何も確認しません。拒否ルールと絶対的な制限は引き続き有効です。 |
Neboはすべての操作を同じ順番でチェックします。まず絶対的な制限、次に上限と法令、次にオーナーのルール、最後にモードです。認証情報の漏洩を防ぐなどの絶対的な制限は、full_accessであっても決して解除されません。