# 実行ルールと通信ガイド

プロジェクトの「実行ルール」の画面は SaaS 版と同じです。**ただし、マーケットプレイス版では、効き方が SaaS 版と異なります。** 登録 Agent は購入者が作ったコンテナで、その中の操作を基盤が 1 つずつ止めることはしないためです。

|                            | ワークフロー                                                                             | サイクル                                                                               |
| -------------------------- | ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| 基本ルール（Open／Guarded／Strict） | **起動の前**に、Agent が対応しているかを確かめる                                                      | 効かない                                                                               |
| プロジェクトで追加する禁止操作            | 効かない（Agent には渡らない）                                                                 | 効かない                                                                               |
| 外への通信                      | 公開の宛先への HTTP(S) は出口のゲートウェイを通り、止めたい宛先は管理コンソールの「禁止URL」に登録する。ほかの宛先は NetworkPolicy で絞る | 公開の宛先への HTTP(S) は出口のゲートウェイを通り、止めたい宛先は管理コンソールの「禁止URL」に登録する。ほかの宛先は NetworkPolicy で絞る |

**「禁止操作に書けば止まる」という SaaS 版の説明（[実行ルールガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/control-guide.md)）は、マーケットプレイス版には当てはまりません。** Agent にさせたくない操作は、Agent の作りと、下の通信の制限で防いでください。

## 基本ルールの確かめ方（ワークフロー）

ワークフローの工程で登録 Agent を起動する前に、実行基盤は次を確かめます。

1. テナント全体の実行ルールと、プロジェクトの実行ルールを合わせ、**厳しいほう**をこの実行の基本ルールにします
2. その基本ルールが、Agent の認定の「**使える実行ルール**」に入っているかを確かめます
3. 入っていなければ起動せず、その工程は「**ルールにより実行不可**」で終わります。案件は確認依頼で止まります（記録には「Agent がこのプロジェクトの実行ルールに未対応」と出ます。[起動ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/trigger-guide.md#%E3%81%86%E3%81%BE%E3%81%8F%E3%81%84%E3%81%8B%E3%81%AA%E3%81%8B%E3%81%A3%E3%81%9F%E3%81%A8%E3%81%8D)）

「使える実行ルール」は、管理者が Agent の認定で登録します。Agent の開発者が、その基本ルールで動くことを試験で確かめた値です（[設定ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/build/guide/settings-guide.md#%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC%E3%81%A7%E4%BD%BF%E3%81%86)）。

**プロジェクトの基本ルールを厳しくすると、その基本ルールに対応していない 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` に、許可する宛先とポートを書きます。

```yaml
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 の値の変え方は[バージョンアップガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/build/guide/update-guide.md)を参照してください

**通信できない宛先を使う 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」に登録した宛先にはつながりません。** 設定の仕方は[設定ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/build/guide/settings-guide.md)にあります。

**確実に止めたい宛先は、「禁止URL」に加えて NetworkPolicy でも塞いでください**（ワークフローは `allowedEgress` に書かない、サイクルは `additionalDeniedEgressCIDRs` に足す）。

管理コンソールの「ウィジェットの通信先の制限」は、ウィジェットからの通信を許可・遮断する設定です。Agent の外への通信を絞るものではありません。

## 取り違えやすいところ

- **禁止操作に書けば止まると思う。** プロジェクトで追加した禁止操作は、Agent には渡りません。止めたい操作は、Agent の作りと、通信の制限で防ぎます
- **基本ルールを厳しくすれば、Agent が安全になると思う。** 基本ルールは、起動の前に、Agent が対応しているかを確かめるのに使われます。実行中の操作は、基盤では止めません
- **サイクルでも基本ルールが効くと思う。** 効きません
- **確実に止めたい宛先は、「禁止URL」に加えて NetworkPolicy でも塞ぎます。**
- **通信できない宛先を使う Agent を置いても動くと思う。** その宛先につながらず、Agent の作りによっては実行が失敗します

## 次に読むもの

- [どこまで任せるか](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/concepts/delegation.md) — 実行ルールの効き方と、責任の境界
- [エージェントガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/agent-guide.md) — 登録 Agent の契約と、Agent の動きを変えたいとき
- [記録ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/record-guide.md#%E8%B5%B7%E5%8B%95%E3%81%A7%E3%81%8D%E3%81%AA%E3%81%8B%E3%81%A3%E3%81%9F%E3%81%A8%E3%81%8D) — 「ルールにより実行不可」で起動できなかったとき
