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

管理コンソール リファレンス

この区分の表記と、管理コンソールで決まっている値の一覧です。項目の名前は画面の表示に合わせています。どれを選ぶかの考え方は、各ガイドにあります。

表記​

このサービスには、管理のための画面が 2 つあります。DevPortal では次のように書きます。

表記何の画面か
管理コンソールテナントごとにある、管理者がテナントの利用者・Agent・記録・セキュリティを管理する画面。画面の題は「AGENTIC STAR ADMIN」。この区分(Admin)で扱います
ConsoleAPI のクライアントと LLM Gateway のキーを管理する画面(Console ガイド)

ログイン​

項目値既定
管理コンソールへのログインパスワードで入るときは、毎回メールの認証コード。パスキー・SSO で入るときは求めない—
自己登録既定(今の動き)・有効・無効既定(有効と同じ)
パスワードの再設定既定(今の動き)・有効・無効既定(有効と同じ)
操作が無い時にログインが切れるまでの時間15 分〜24 時間。最長の時間以下。管理コンソール自身のログインにも効く—
ログインを続けられる最長の時間1 日〜30 日。管理コンソール自身のログインにも効く—

外部認証設定​

項目値既定
外部認証を有効にする有効・無効無効
Entry ID英小文字で始まり、英小文字・数字・ハイフン・アンダースコアの 2〜64 文字。あとから変えられない—
アイコンPNG・JPEG。512KB まで—
IdP タイプOIDC / OAuth2・SAML 2.0。あとから変えられない—
Scopes(OIDC)空白かカンマで区切るopenid profile email
紐付けキーメールアドレス・サブジェクト(sub)メールアドレス
ユーザー自動作成有効・無効有効
自動承認承認しない(管理者が承認)・指定したドメインだけ自動承認・全員を自動承認—
IdP クレーム値の変換ルールIdP 側の値は完全一致で当たる—

ネットワーク​

項目値既定
アクセス許可IP の書き方IPv4・IPv6・CIDR。0.0.0.0/0・::/0 は登録できない—
アクセス許可IP の適用サービスADMIN・WEB(1 つ以上)—
外部連携 API 許可IP の制限有効・無効無効
国制限設定がかかる所ログイン・チャット・管理コンソール。外部連携 API・LLM Gateway にはかからない。サービスごとには分けられない—
国制限設定のルール名英字で始まり、英字と数字だけで 128 文字まで—
国制限設定の国1 つのルールで 1〜10 か国—
国制限設定の優先度100〜199 の整数。数字が小さいほど先に効く。ルールの間で重ねられない—
国制限設定の動作遮断・検知のみ—
国制限設定が効くまで1 時間ほど—
国制限設定の検知の件数直近 30 日—
Agent が外へつなぐときに使えるポート443・80・8080・8443・8000・3000・5000・9000。HTTP と HTTPS の通信だけ—
Agent が出られる宛先禁止URLに当たる宛先は止まるすべて

ガードレール​

項目値既定
プロンプト攻撃の検出有効・無効有効
有害コンテンツの検出感度推奨・緩い・最も緩い・無効推奨
個人情報のマスキング有効・無効有効
実行時間の上限5・15・30・60・90・120 分か「制限しない」制限しない
機微語・除外語それぞれ 200 件まで—
機微語の長さ語は 100 文字まで、正規表現(RE2)は 500 文字まで—
機微語の表示の名前50 文字まで。[ ] と制御文字は使えない—
除外語の長さ100 文字まで—
正規表現を試す試す文は 2,000 文字まで。当たった所は 50 か所まで出る—
AIエージェントへの共通の指示の連結順序1・2・3—
AIエージェントへの共通の指示の組織全体(全部の組織)・各組織全体(全部の組織)
禁止URL の理由セキュリティ・コンプライアンス・内部ポリシー・その他—
ウィジェットの通信先の制限で登録できるもの拒否(ホスト名。サブドメインも止まる)だけ。変えてから 60 秒ほどで効く—
ガードレール設定が効くまで数分のうちに、次の依頼から—
禁止事項の指示(AIエージェントへの共通の指示)が効くまで最大 30 分—

記録​

項目値既定
記録の保持24 か月(監査ログ・操作監査ログ・AIエージェントの LLM 利用・外部への通信の記録・LLM Gateway の記録)—
CSV の書き出し監査ログは上限なし。外部への通信の記録・利用者の操作の監査は 5,000 件まで。AIエージェントの LLM 利用・LLM Gateway の記録は 1,000 件まで—
会話の書き出しJSON で 1 回 1,000 件まで期間を指定しないときは直近 30 日
利用者の操作の監査の画面—期間を指定しないときは直近 30 日
SIEM の送り先HTTP push(汎用)・Microsoft Sentinel・Splunk・AWS CloudWatch Logs—
SIEM の外部の送り先https だけ—
SIEM へ送る間隔1 分ごと(届くまでおおむね 1〜2 分)—
SIEM に送れる記録9 種類「利用者の操作の監査」「外部への通信の記録」は送らない。ほかは送る
SIEM の HTTP push のトークンのヘッダ名—Authorization
SIEM の CloudWatch Logs のログストリーム—記録の種類の識別子(audit_logs など)

会話の保管と共有​

項目値既定
共有リンクを停止する(機能の許可)オン・オフ。オンにすると、作ったリンクも開けない(一覧の表示と削除はできる)。保存してから 60 秒以内に効く。構築の設定で無効にしているときは、この画面から使えるようにできないオフ
アーカイブまでの日数30〜3650 日。次のアーカイブの実行から効く空(構築の設定の日数)
アーカイブ後の保持日数30〜3650 日。過ぎた会話は添付ごと消え、戻せない。保全(legal hold)中のものは消えない空(無期限)
保全(legal hold)の IDプロジェクトは UUID、会話は 128 文字まで—

エラーのコード​

管理コンソールの設定によって、外部 API が返すエラーです。

HTTP ステータスerror.codeいつ決める設定
403ip_not_allowed外部連携 API 許可IP が有効で、許可していない接続元から呼んだとき外部連携 API 許可IP
403sso_requiredプロジェクトの外部 API で、SSO でログインしていない利用者が、SSO の利用者だけの操作をしたときSSO だけで入らせる

管理者の種類と使える画面​

画面システム管理者組織管理者監査役
ダッシュボード○○—
プロジェクト管理の横断 KPI・実行履歴○○(担当する組織の範囲)○(閲覧だけ)
プロジェクト管理の実行ルール○見るだけ—
プロジェクト管理の確認依頼・組織のプロジェクト組織管理者を兼ねるときだけ○(担当する組織の範囲)—
AIエージェントの AIエージェント一覧(横断)○○(担当する組織の範囲)○(閲覧だけ)
AIエージェントの公開の申請○○(担当する組織の範囲。公開を承認制にするかのテナント全体の設定はシステム管理者だけ)—
接続先と使える範囲の MCPの接続(システム管理者には「MCPサーバー」>「MCPの接続」のタブ)○○(自組織の利用者・プロジェクトの接続だけ)—
記録と監査の監査ログ・操作監査ログ・利用者の操作の監査・AIエージェントの LLM 利用・外部への通信の記録(外部への通信の記録は、監査役ではテナントの監査役だけ。ガードレールアラートと利用者の評価は監査役には出ない)○—○(閲覧だけ)
ユーザーメニューの「パスワード変更」○○○
そのほかの画面(この区分のガイドで扱う設定を含む)○——

組織管理者は、利用者と組織の「管理の役割」で決めます(ロールリファレンス)。