# 設定ガイド

AGENTIC STAR マーケットプレイス版の管理画面で利用可能な設定項目を解説します。

## 管理画面へのアクセス

デプロイ完了後、管理画面の URL にブラウザでアクセスし、購入時に設定した管理者メールアドレスとパスワードでログインしてください。

![管理画面ダッシュボード](https://developers.fd.agenticstar.tm.softbank.jp/assets/images/admin-dashboard-aa72f7354bbbf4a0cfebfbb27062a688.png)

> **注記**
>
> 出荷時は自己署名証明書のため、ブラウザに証明書警告が表示されます。証明書の例外を許可してアクセスしてください。正規 SSL 証明書の設定方法は[ドメイン設定ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/basic/build/guide/domain-guide.md)を参照してください。

## メニュー構成

管理画面は以下のメニューで構成されています。

| カテゴリ         | メニュー        | 説明                       |
| ------------ | ----------- | ------------------------ |
| —            | **ダッシュボード** | 利用状況の概要                  |
| **ユーザー管理**   | 管理者         | 管理画面にアクセスできる管理者の管理       |
|              | ユーザー        | エンドユーザーの管理               |
|              | サービスアカウント   | API 利用のためのサービスアカウント管理    |
| **エージェント管理** | AI ペルソナ     | エージェント応答の人格（ペルソナ）の管理     |
|              | MCP サーバー    | MCP サーバーの管理              |
|              | LLM 設定      | LLM プロバイダー・モデルの設定        |
|              | エージェント設定    | カスタムエージェントの登録・管理         |
|              | ガードレール設定    | コンテンツセーフティと PII マスキング    |
|              | 禁止 URL      | アクセスを禁止する URL の管理        |
| **マスタ管理**    | 組織          | 組織情報の管理                  |
|              | 職種          | 職種マスターの管理                |
|              | お知らせ        | エンドユーザー向けお知らせの管理         |
|              | メールプロバイダ設定  | メールプロバイダーの設定             |
| **ログ管理**     | 監査ログ        | 管理操作の履歴                  |
|              | LLM 監査ログ    | LLM 利用の履歴                |
|              | レポート        | ユーザーレポートの確認              |
|              | アクセスログ      | アクセス履歴                   |
| **システム管理**   | 通知設定        | 通知メールの送信設定               |
| —            | **バージョン管理** | プラットフォームのバージョン確認・アップグレード |

## ユーザー管理

### 管理者

管理画面にアクセスできる管理者アカウントを管理します。初期管理者は購入時に自動作成されます。

### ユーザー

AGENTIC STAR を利用するエンドユーザーを管理します。ユーザーの追加・編集・無効化が可能です。

### サービスアカウント

API を利用するためのサービスアカウントを作成・管理します。サービスアカウントを作成すると、API 認証に使用するクライアント ID とクライアントシークレットが発行されます。

API の利用方法は[マーケットプレイス版 API クイックスタート](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/basic/api/quickstart/call-api.md)を参照してください。

## エージェント管理

### AI ペルソナ

エージェントの応答スタイル（人格）を「ペルソナ」として登録・管理します。チャット呼び出し時に `personaKey` を指定することで、エージェントの応答口調・トーンを切り替えられます。

ペルソナには以下の 2 種類があります。

| 種別     | 説明                                           |
| ------ | -------------------------------------------- |
| **公式** | プラットフォーム標準で提供されるペルソナ。編集・削除は不可（言語の追加もできません）。  |
| **独自** | テナントで作成・管理するペルソナ。多言語対応のために複数ロケールの指示文を登録できます。 |

#### 主な設定項目

| 設定項目        | 説明                                   |
| ----------- | ------------------------------------ |
| **ペルソナキー**  | ペルソナの識別子（1〜64 文字、半角英数字・ハイフン・アンダースコア） |
| **名前**      | ペルソナの表示名                             |
| **説明**      | ペルソナの概要                              |
| **指示文**     | エージェントに与える人格・口調の指示（ロケール単位で登録可能）      |
| **タグ**      | 分類用タグ                                |
| **有効 / 無効** | ペルソナを利用可能にするかの切り替え                   |

### LLM 設定

エージェントが使用する LLM プロバイダーとモデルを設定します。

![LLM 設定画面](https://developers.fd.agenticstar.tm.softbank.jp/assets/images/admin-llm-settings-ddabf6e24c71db141fac1ad4b76b104b.png)

| 設定項目          | 説明                                          |
| ------------- | ------------------------------------------- |
| **設定タイプ**     | 設定の種類                                       |
| **モデル**       | 使用するモデル名（LiteLLM 形式: `provider/model-name`） |
| **API キー**    | LLM プロバイダーの API キー                          |
| **ベース URL**   | LLM プロバイダーのエンドポイント URL                      |
| **API バージョン** | API バージョン（`YYYY-MM-DD` 形式）                  |
| **追加設定**      | JSON 形式の追加パラメータ                             |

> **注記**
>
> API キーなどの機密値は登録後 `********` でマスク表示されます。変更しない場合は既存の値が保持されます。

### エージェント設定

カスタムエージェントを登録し、プラットフォーム上で利用可能にします。

#### 基本情報

| 設定項目         | 説明                                 |
| ------------ | ---------------------------------- |
| **エージェントID** | エージェントの識別子（小文字英数字とハイフン、63 文字以内）    |
| **表示名**      | エージェントの表示名                         |
| **説明**       | エージェントの説明文                         |
| **アイコン**     | アイコン画像のアップロード（PNG / JPEG、512KB 以下） |
| **タグ**       | 分類用タグ（カンマ区切り）                      |

#### Docker イメージ

| 設定項目        | 説明                                    |
| ----------- | ------------------------------------- |
| **レジストリ**   | コンテナレジストリの URL（例: `myacr.azurecr.io`） |
| **イメージ名**   | イメージ名（例: `my-org/rag-agent`）          |
| **タグ**      | イメージタグ（デフォルト: `latest`）               |
| **Secret名** | プライベートレジストリ用の認証シークレット                 |

#### リソース

| 設定項目                 | 説明                            |
| -------------------- | ----------------------------- |
| **CPU リクエスト / リミット** | CPU の割り当て（例: `500m`, `2000m`） |
| **メモリリクエスト / リミット**  | メモリの割り当て（例: `512Mi`, `4Gi`）   |

#### ストレージ

永続ストレージが必要な場合に有効化します。

| 設定項目         | 説明                  |
| ------------ | ------------------- |
| **ストレージサイズ** | 容量（例: `10Gi`）       |
| **マウントパス**   | コンテナ内のマウントパス（絶対パス）  |
| **ストレージクラス** | Kubernetes ストレージクラス |
| **アクセスモード**  | アクセスモード             |

#### ステータス

| 設定項目    | 説明                    |
| ------- | --------------------- |
| **有効化** | エージェントの有効 / 無効を切り替えます |

#### 環境変数

カスタム環境変数を設定できます。以下の予約変数はプラットフォームが自動で注入するため、手動設定は不要です（同名の変数を登録するとエラーになります）。

**常に注入される変数**

- `EXECUTION_ID`
- `CONVERSATION_ID`
- `USER_ID`
- `AGENT_ID`

**条件に応じて注入される変数**

- `USER_ORGANIZATION_ID`
- `USER_ORGANIZATION_LABEL`
- `USER_JOB_ROLE`
- `USER_JOB_LABEL`
- `USER_BIO`
- `USER_LANGUAGE`

カスタム環境変数はシークレット（値をマスク表示）および必須のマークが可能です。

#### 追加設定（JSON）

エージェント固有の追加パラメータを JSON 形式で指定できます。

#### ACR シークレット管理

Azure Container Registry のプライベートレジストリを使用する場合、ユーザー名とパスワードで認証シークレットを自動作成できます。

### ガードレール設定

AI の出力に対するコンテンツセーフティと個人情報保護を設定します。

![ガードレール設定画面](https://developers.fd.agenticstar.tm.softbank.jp/assets/images/admin-guardrails-settings-4605af72aa7eb04bbf7d597cd31e818b.png)

#### コンテンツセーフティ

**プロンプトシールド検出**

ジェイルブレイク攻撃を検出してブロックします。有効/無効を切り替えられます。

**モデレーション検出**

有害コンテンツの検出レベルを設定します。

| レベル   | 説明                  |
| ----- | ------------------- |
| **0** | 無効                  |
| **2** | 推奨（中程度の有害コンテンツを検出）  |
| **4** | 緩和（重度のコンテンツのみ検出）    |
| **6** | 最小（極めて重大なコンテンツのみ検出） |

検出対象カテゴリ: 暴力、性的コンテンツ、ヘイトスピーチ、自傷行為

#### PII マスキング

個人情報（PII）を自動検出してマスキングします。最大 189 カテゴリに対応しています（対応カテゴリ数はクラウドプロバイダーにより異なります）。

主な検出対象:

- 識別情報（電話番号、メールアドレス、マイナンバー等）
- 金融情報（クレジットカード番号、口座番号等）
- 医療情報（保険証番号、医療記録等）
- 位置情報（住所、GPS 座標等）
- 認証情報（パスワード、API キー、トークン等）

##### クラウドプロバイダー別のバックエンド

| プロバイダー    | バックエンド                                          | 対応言語       |
| --------- | ----------------------------------------------- | ---------- |
| **Azure** | Azure AI Language - PII Detection               | 多言語（日本語含む） |
| **AWS**   | Bedrock Guardrails `sensitiveInformationPolicy` | 多言語（日本語含む） |
| **GCP**   | Cloud DLP                                       | 多言語（日本語含む） |

AWS 環境では ContentSafety（コンテンツモデレーション・プロンプトシールド）と PII 検出を**同一の Bedrock Guardrail** で扱う構成を推奨しています。`apply_guardrail` API 1回の呼び出しで両方が評価されるため、追加の IAM 権限は `bedrock:ApplyGuardrail` のみで足ります。

### 禁止 URL

エージェントがアクセスすることを禁止する URL を管理します。

#### 制限の粒度

| 機能             | 制限粒度      | 説明                                                                                                                           |
| -------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------- |
| **基本機能（標準提供）** | ドメイン単位    | ExtAuth Service（Envoy サイドカー経由の認可制御）で Pod のアウトバウンド通信をチェックします。HTTPS 通信は TLS 暗号化によりパスが見えないため、実運用では実質的にドメイン（+ ポート）単位の制限として動作します。 |
| **拡張機能（任意実装）** | URL（パス）単位 | エージェント側で SDK の `ConfigAccess.get_banned_urls()` を利用し、ツール内で URL 文字列を検査する実装を追加することで、パス単位の制限が可能になります。                           |

> **ヒント**
>
> 両方の機能は同じ「禁止 URL」設定（`banned_urls` テーブル）を共有するため、管理画面での登録は一元化されます。拡張機能の実装方法は [SDK リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/basic/develop/reference/sdk-ref.md) の `ConfigAccess.get_banned_urls()` を参照してください。

## マスタ管理

### 組織

組織情報を管理します。

### 職種

職種マスターを管理します。

### お知らせ

エンドユーザー向けのお知らせを作成・管理します。タイトルと本文（Markdown）、優先度、有効 / 無効を設定できます。

### メールプロバイダ設定

通知メールの送信に使用するメールプロバイダーを設定します。

#### 基本設定

メール機能の有効/無効を切り替えられます。

#### SMTP 設定

| 設定項目           | 説明              | 備考                              |
| -------------- | --------------- | ------------------------------- |
| **ホスト**        | SMTP サーバーのホスト名  | 必須（例: `smtp.example.com`）       |
| **ポート**        | SMTP サーバーのポート番号 | 必須（1〜65535、デフォルト: 587）          |
| **暗号化方式**      | 通信の暗号化方式        | None / SSL / TLS（TLS 推奨）        |
| **認証方式**       | 認証の方式           | None / LOGIN / PLAIN / CRAM-MD5 |
| **ユーザー名**      | SMTP 認証のユーザー名   | 必須                              |
| **パスワード**      | SMTP 認証のパスワード   | 必須                              |
| **送信元メールアドレス** | メールの送信元アドレス     | 必須                              |

## ログ管理

### 監査ログ

管理画面での操作履歴を確認できます。誰がいつ何を変更したかを追跡できます。

### LLM 監査ログ

LLM の利用履歴を確認できます。トークン使用量やリクエスト内容を追跡できます。

### レポート

ユーザーレポートの確認ができます。

### アクセスログ

アプリケーションへのアクセス履歴を確認できます。

## システム管理

### 通知設定

エンドユーザーへ送信する通知メールの有効 / 無効を設定します。タスク完了メール、フォローアップメール、Weekly メールを個別に切り替えられます。

## バージョン管理

プラットフォームの現在のバージョンを確認し、利用可能な新しいバージョンへアップグレードできます。バージョンは 1 つずつ順番にアップグレードします。
