メインコンテンツまでスキップ

設定ガイド

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

管理画面へのアクセス​

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

管理画面ダッシュボード

注記

出荷時は自己署名証明書のため、ブラウザに証明書警告が表示されます。証明書の例外を許可してアクセスしてください。正規 SSL 証明書の設定方法はドメイン設定ガイドを参照してください。

メニュー構成​

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

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

ユーザー管理​

管理者​

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

ユーザー​

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

サービスアカウント​

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

API の利用方法はマーケットプレイス版 API クイックスタートを参照してください。

エージェント管理​

AI ペルソナ​

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

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

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

主な設定項目​

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

LLM 設定​

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

LLM 設定画面

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

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

エージェント設定​

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

基本情報​

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

Docker イメージ​

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

リソース​

設定項目説明
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 の出力に対するコンテンツセーフティと個人情報保護を設定します。

ガードレール設定画面

コンテンツセーフティ​

プロンプトシールド検出

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

モデレーション検出

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

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

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

PII マスキング​

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

主な検出対象:

  • 識別情報（電話番号、メールアドレス、マイナンバー等）
  • 金融情報（クレジットカード番号、口座番号等）
  • 医療情報（保険証番号、医療記録等）
  • 位置情報（住所、GPS 座標等）
  • 認証情報（パスワード、API キー、トークン等）
クラウドプロバイダー別のバックエンド​
プロバイダーバックエンド対応言語
AzureAzure AI Language - PII Detection多言語（日本語含む）
AWSBedrock Guardrails sensitiveInformationPolicy多言語（日本語含む）
GCPCloud 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 リファレンス の 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 つずつ順番にアップグレードします。