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は、役割が本当に特定の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であっても決して解除されません。