コネクタのアクセスには3つの層があります。メンバーの接続、エージェントの認可、そのエージェントに付与された名前付き権限です。サービスを接続しても、すべてのエージェントにすべてのアクションが黙って付与されるわけではありません。
接続、認可、権限
| 層 | 制御するもの |
|---|---|
| 接続 | そのサービスに使えるメンバーアカウントまたは認証情報。 |
| エージェントの認可 | その接続済みサービスを使えるエージェント。 |
| 権限付与 | そのエージェントが要求できる名前付きアクションと、その期間。 |
メンバーごとの認証情報を使うサービスでは、各メンバーが自分のアカウントを接続します。共有エージェントは、実行するメンバーの接続済みアカウントと付与を通じて動作します。チームメイトの受信トレイ、トークン、プライベートなチャット履歴を継承しません。
アクセスの付与
エージェントが持っていないコネクタ権限を必要とする場合、Okouは権限リクエストを表示します。AllowまたはDenyを選ぶ前に、コネクタ、エージェント、権限名、理由を確認します。
許可された権限は、製品が提供する期間のいずれかを使えます:
- Allow for 1h
- Allow for 24h
- Allow for 7d
- Allow always
期間限定の付与が期限切れになると、エージェントは再度要求する必要があります。1つの権限を拒否しても、アカウントの接続は切れず、無関係な権限も削除されません。
エージェントの現在のコネクタアクセスは、その認可設定から管理します。コネクタアクセスビューには、どのエージェントが認可され、その権限状態がallowed、denied、mixedのいずれかが表示されます。
認証情報の扱い
OAuthトークンと手動入力のシークレットはプラットフォームに保存されます。コネクタリクエストでは、ファイアウォールがネットワーク境界で認証情報を注入します。シークレットは環境変数としてエージェントコードに公開されません。
APIキー、OAuthトークン、パスワード、クライアントシークレットを、チャット、エージェントのインストラクション、ワークフローのインストラクション、添付ファイルに貼り付けないでください。代わりにコネクタの接続フローを使います。
メンバーのコネクタを切断すると、その接続は将来のRunから削除されます。エージェントの認可を削除すると、そのエージェントはコネクタを使えなくなりますが、他の認可済みエージェントは変わりません。
承認境界
強制できる境界はコネクタの名前付き権限付与です。すべてのメール、投稿、支払い、インフラ変更、削除が常に同じように一時停止することを、汎用的なアクションカテゴリで保証しようとしないでください。
人間のレビューを残すべき作業では:
- コネクタが分けて公開している場合は、読み取りまたは下書きの権限だけを付与し、最終的な書き込み・送信権限を拒否します。
- レビュー要件をエージェントまたはワークフローのインストラクションに明記します。
- 最終アクションは人間が保持します。たとえば、送信や適用の代わりにGmailの下書きや変更提案を生成します。
上流のサービス制御も使います。スコープ付きAPIキー、最小権限のOAuthスコープ、リポジトリ権限、本番用と分けた認証情報です。
チャット、ログ、管理者の可視性
メンバーは自分のチャットスレッドにアクセスします。エージェントやワークフローを公開しても、メンバーのプライベートなチャット履歴やコネクタ認証情報は公開されません。会話や成果物は明示的な共有画面を通じてのみ共有します。
ワークスペース管理者は、請求と容量管理に使うメンバーレベルの利用集計を見られます。それによってプライベートなチャット内容をメンバー横断で自動的に見られるわけではありません。
メンバー自身のチャット内では、アクティビティビューにRunの順序、コネクタアクティビティ、成果物、ステータス、エラーが記録されます。要求されたコネクタアクションが実行されたか、成功したかを確認するために使います。
レビューチェックリスト
- コネクタは意図したメンバーアカウントにリンクされているか?
- 意図したエージェントは認可されているか?
- このタスクに必要な権限だけが許可されているか?
- 付与は永久ではなく、1時間、24時間、7日で失効させられるか?
- ワークフローは不可逆または外部向けのアクションを人間のレビューステップに置いているか?
- 上流の認証情報をさらに絞れるか?
次へ
- チャット境界の内部で何が起きるかはChatを参照。
- カタログとそれぞれの機能はConnectorsを参照。
- 組織レベルの権限設定はFor teamsを参照。