実行ルールと通信ガイド
プロジェクトの「実行ルール」の画面は SaaS 版と同じです。ただし、マーケットプレイス版では、効き方が SaaS 版と異なります。 登録 Agent は購入者が作ったコンテナで、その中の操作を基盤が 1 つずつ止めることはしないためです。
| ワークフロー | サイクル | |
|---|---|---|
| 基本ルール(Open/Guarded/Strict) | 起動の前に、Agent が対応しているかを確かめる | 効かない |
| プロジェクトで追加する禁止操作 | 効かない(Agent には渡らない) | 効かない |
| 外への通信 | 公開の宛先への HTTP(S) は出口のゲートウェイを通り、止めたい宛先は管理コンソールの「禁止URL」に登録する。ほかの宛先は NetworkPolicy で絞る | 公開の宛先への HTTP(S) は出口のゲートウェイを通り、止めたい宛先は管理コンソールの「禁止URL」に登録する。ほかの宛先は NetworkPolicy で絞る |
「禁止操作に書けば止まる」という SaaS 版の説明(実行ルールガイド)は、マーケットプレイス版には当てはまりません。 Agent にさせたくない操作は、Agent の作りと、下の通信の制限で防いでください。
基本ルールの確かめ方(ワークフロー)
ワークフローの工程で登録 Agent を起動する前に、実行基盤は次を確かめます。
- テナント全体の実行ルールと、プロジェクトの実行ルールを合わせ、厳しいほうをこの実行の基本ルールにします
- その基本ルールが、Agent の認定の「使える実行ルール」に入っているかを確かめます
- 入っていなければ起動せず、その工程は「ルールにより実行不可」で終わります。案件は確認依頼で止まります(記録には「Agent がこのプロジェクトの実行ルールに未対応」と出ます。起動ガイド)
「使える実行ルール」は、管理者が Agent の認定で登録します。Agent の開発者が、その基本ルールで動くことを試験で確かめた値です(設定ガイド)。
プロジェクトの基本ルールを厳しくすると、その基本ルールに対応していない Agent は動かなくなります。 たとえば「使える実行ルール」が Open と Guarded だけの Agent は、Strict のプロジェクトでは起動しません。
適用した基本ルールは、実行の記録に残ります。
Agent が自分で「この操作はしない」と判断したときは、Agent が「ルールにより実行不可」を報告することもあります。どの操作をそう扱うかは、Agent の作りで決まります。
プロジェクトの禁止操作は、起動の前の照合に使われます。 もう無い連携先を指す禁止操作が残っていると、起動できずに確認依頼になります。使わなくなった連携先を指す禁止操作は消してください。
外への通信を絞る
登録 Agent が外部と通信できる範囲は、2 つの層で決まります。どちらも、プロジェクトではなく環境全体の設定です。
| 層 | 設定する人と場所 | 絞れるもの |
|---|---|---|
| 禁止URL | 管理者。管理コンソールの「禁止URL」 | 止めたい宛先の URL |
| NetworkPolicy | 環境を構築・運用する人。agent-executor の Helm の値 | 宛先・ポート |
ワークフローの Agent
公開の宛先への HTTP(S) は、出口のゲートウェイを通ります。 止めたい宛先は、管理コンソールの「AIエージェントの制限」>「禁止URL」に登録します。
HTTP(S) ではない宛先(外部のデータベースなど)と、クラスターの中の宛先を使う Agent を動かすには、環境を運用する人が、agent-executor の marketplaceDefaults.networkPolicy.workflowEgress.allowedEgress に、許可する宛先とポートを書きます。
marketplaceDefaults:
networkPolicy:
workflowEgress:
allowedEgress:
- to:
- ipBlock:
cidr: 203.0.113.10/32
ports:
- protocol: TCP
port: 5432
- NetworkPolicy には URL は書けません。特定の URL を止めたいときは、管理コンソールの「禁止URL」に登録します
mode: openにすると、宛先とポートを絞らなくなります(クラウドのメタデータなどは除きます)。勧めません- 宛先が増えたら、この値に足して agent-executor を更新します。Helm の値の変え方はバージョンアップガイドを参照してください
通信できない宛先を使う Agent は、その宛先につながりません。Agent の作りによっては、実行が失敗します。 新しい Agent を置く前に、Agent の開発者に通信先を確かめてください。
サイクルの Agent
サイクルの Agent の Pod は、会話で使う Agent と同じ NetworkPolicy です。公開の宛先への HTTP(S) は、ワークフローと同じく、出口のゲートウェイを通ります。 止めたい宛先は、管理コンソールの「AIエージェントの制限」>「禁止URL」に登録します。クラスターの中のサービス(プライベートの IP アドレスの範囲)には出られ、クラウドのメタデータ(169.254.0.0/16)には出られません。HTTP(S) ではない外部の宛先(外部のデータベースなど)を使う Agent を動かすには、環境を運用する人が、agent-executor の marketplaceDefaults.networkPolicy.chatEgress.allowedEgress に、許可する宛先とポートを書きます。止めたいクラスターの中の宛先の IP アドレスの範囲は、marketplaceDefaults.networkPolicy.additionalDeniedEgressCIDRs に足します。
禁止URL
Agent の Pod には、通信の判定サービスを通る HTTP(S) のプロキシの設定が入ります。このプロキシの設定に従う通信は、管理コンソールの「禁止URL」に登録した宛先にはつながりません。 設定の仕方は設定ガイドにあります。
確実に止めたい宛先は、「禁止URL」に加えて NetworkPolicy でも塞いでください(ワークフローは allowedEgress に書かない、サイクルは additionalDeniedEgressCIDRs に足す)。
管理コンソールの「ウィジェットの通信先の制限」は、ウィジェットからの通信を許可・遮断する設定です。Agent の外への通信を絞るものではありません。
取り違えやすいところ
- 禁止操作に書けば止まると思う。 プロジェクトで追加した禁止操作は、Agent には渡りません。止めたい操作は、Agent の作りと、通信の制限で防ぎます
- 基本ルールを厳しくすれば、Agent が安全になると思う。 基本ルールは、起動の前に、Agent が対応しているかを確かめるのに使われます。実行中の操作は、基盤では止めません
- サイクルでも基本ルールが効くと思う。 効きません
- 確実に止めたい宛先は、「禁止URL」に加えて NetworkPolicy でも塞ぎます。
- 通信できない宛先を使う Agent を置いても動くと思う。 その宛先につながらず、Agent の作りによっては実行が失敗します