AGENTIC STAR マーケットプレイス版の Helm チャートで使用される設定パラメータの一覧です。
各パラメータの「ソース」列は値の設定方法を示します。
| ソース | 説明 |
|---|
| 固定 | デフォルトの固定値。通常は変更不要 |
| UI 入力 | 購入時のデプロイフォームで指定した値が設定される |
| 自動取得 | デプロイ時に Azure リソースから自動取得される |
| 自動生成 | デプロイ時にランダムなシークレットが自動生成される |
| config.yaml | インストーラーの config.yaml で指定した値が設定される(マーケットプレイスの作成画面には出ない) |
| 開閉コマンド | インストール後に管理者が kc_direct_login.sh で開け閉めしたときだけ入る |
自動取得・自動生成されるパラメータの全体像
各サービスのテーブルでは個別の値が「ソース」列に記載されていますが、デプロイ後に「想定どおりに値が設定されているか」を確認するには、ここに集約した一覧を参照してください。特に librechat-env-secret はメインアプリの主要シークレットが集約される Secret で、ここに格納される値の多くがインストーラーによって自動取得・自動生成されます。
自動取得されるパラメータ(Azure の場合)
| パラメータ | 取得元 | 主な配置先 |
|---|
global.azure.subscriptionId | az account show | 各サービスの ConfigMap |
global.azure.resourceGroupName | ARM テンプレート | 各サービスの ConfigMap |
aks.nodeResourceGroup | az aks show --query nodeResourceGroup | 各サービスの ConfigMap |
global.postgresql.host | PostgreSQL Flexible Server の FQDN | *-env-secret |
global.postgresql.database | ARM テンプレート出力 | *-env-secret |
global.objectStorage.azure.connectionString | az storage account show-connection-string(Private Storage) | librechat-env-secret (key: AZURE_STORAGE_CONNECTION_STRING) |
global.objectStorage.azure.storageAccountName | ARM テンプレート | ConfigMap |
global.objectStorage.azure.customDomain | <storageAccountName>.blob.core.windows.net | ConfigMap |
publicStorage.connectionString | az storage account show-connection-string(Public Storage) | 公開ストレージ用 Secret |
appConfig.authBaseUrl / domainClient / domainServer | 各 LoadBalancer のアドレスから自動設定(独自ドメインへの変更はドメイン設定ガイド) | librechat-env-secret, ConfigMap |
env.APP_URL / LIBRECHAT_URL / ADMIN_CONSOLE_URL | 同上 | librechat-auth-secret, agenticai-admin-secret |
env.WEBAUTHN_RP_ID | 認証ドメインから導出 | librechat-auth-secret |
env.ALLOWED_ORIGINS / AFD_CHATBOARD_FRONT_AUTH_DOMAIN / AFD_CHATBOARD_ADMIN_DOMAIN / CHATBOARD_FRONT_DOMAIN | ドメイン設定から導出 | extauth-service ConfigMap |
internalHosts.storageHosts | 内部ストレージ FQDN | extauth-service ConfigMap |
- オブジェクトストレージは S3 です(
global.objectStorage.provider は aws)。バケットとリージョンは CloudFormation スタックが作ったものが自動で設定され、librechat-env ConfigMap の AWS_BUCKET_NAME・AWS_REGION に入ります。アクセスキーは使わず、Pod に割り当てた IAM ロールで読み書きします
- PostgreSQL のホストは RDS のエンドポイントで、ユーザー名とパスワードはスタック作成時に指定した値が自動で設定されます
- 表の
global.azure.*・aks.nodeResourceGroup・global.objectStorage.azure.*・publicStorage.connectionString は使いません
自動生成されるパラメータ(ランダムシークレット)
アプリケーションの間の認証や暗号化に使う鍵・パスワードは、インストール時に環境ごとのランダムな値として自動生成され、各サービスの Secret に格納されます。手で変更しないでください(変更すると、保存済みのデータが読めなくなったり、サービス間の通信が失敗したりします)。
デプロイ後の確認方法
デプロイが正常に完了したかは、Kubernetes 上でオブジェクトストレージの設定を読んで確認できます。
kubectl get secret librechat-env-secret -n agentic-star-front \
-o jsonpath='{.data.AZURE_STORAGE_CONNECTION_STRING}' | base64 -d
Azure では、DefaultEndpointsProtocol=https;AccountName=...;AccountKey=...;EndpointSuffix=core.windows.net の形式であれば正常です。
kubectl get configmap librechat-env -n agentic-star-front \
-o jsonpath='{.data.AWS_BUCKET_NAME}'
AWS では、CloudFormation スタックが作ったバケットの名前が返れば正常です。
空文字 / CHANGE_ME_* / <placeholder> のような値が返る場合は、インストーラーが何らかの理由でクラウドのリソースから値を取得できなかった可能性があります。構築トラブルシューティングガイドを確認するか、サポートへ連絡してください。
共通設定(common-values)
すべてのサービスで共有される設定です。
環境設定
| パラメータ | デフォルト | ソース | 説明 |
|---|
global.environment | — | UI 入力 | 環境名(Environment Name) |
global.customerEnvironment | — | UI 入力 | 環境名と同値 |
global.primary.language | ja | UI 入力 | UI の表示言語(ja / en / fr / es / th / ar / id / zh-Hans / zh-Hant / pt-BR / de-DE / it-IT / vi / ko) |
コンテナレジストリ
| パラメータ | デフォルト | ソース | 説明 |
|---|
global.imagePullSecret.enabled | false | 固定 | イメージプルシークレットの有効化 |
global.imagePullSecret.name | "" | 固定 | シークレット名 |
global.imagePullSecret.registry | "" | 固定 | レジストリ URL |
PostgreSQL
| パラメータ | デフォルト | ソース | 説明 |
|---|
global.postgresql.host | — | 自動取得 | PostgreSQL サーバーの FQDN |
global.postgresql.port | 5432 | 固定 | ポート番号 |
global.postgresql.database | — | 自動取得 | データベース名 |
global.postgresql.username | — | UI 入力 | 管理者ユーザー名 |
global.postgresql.password | — | UI 入力 | 管理者パスワード |
global.postgresql.useAzureAd | false | 固定 | Azure AD 認証の使用 |
global.postgresql.poolMinSize | 5 | 固定 | コネクションプール最小サイズ |
global.postgresql.poolMaxSize | 20 | 固定 | コネクションプール最大サイズ |
global.postgresql.commandTimeout | 60 | 固定 | コマンドタイムアウト(秒) |
global.postgresql.poolTimeout | 30 | 固定 | プールタイムアウト(秒) |
global.postgresql.maxOverflow | 10 | 固定 | 最大オーバーフロー接続数 |
Azure 設定
| パラメータ | デフォルト | ソース | 説明 |
|---|
global.azure.subscriptionId | — | 自動取得 | Azure サブスクリプション ID |
global.azure.resourceGroupName | — | 自動取得 | リソースグループ名 |
オブジェクトストレージ
| パラメータ | デフォルト | ソース | 説明 |
|---|
global.objectStorage.provider | azure | 固定 | ストレージプロバイダー |
global.objectStorage.azure.container | autonomous-agent-files | 固定 | Azure Blob コンテナ名 |
global.objectStorage.azure.connectionString | — | 自動取得 | 接続文字列 |
global.objectStorage.azure.storageAccountName | — | 自動取得 | ストレージアカウント名 |
global.objectStorage.azure.customDomain | — | 自動取得 | カスタムドメイン |
Ingress TLS
| パラメータ | デフォルト | ソース | 説明 |
|---|
global.ingress.tls.enabled | true | 固定 | TLS の有効化 |
global.ingress.tls.secretName | selfsigned-tls-cert | 固定 | TLS 証明書の Secret 名 |
global.ingress.tls.useCertManager | false | 固定 | cert-manager の使用 |
global.ingress.tls.clusterIssuer | "" | 固定 | ClusterIssuer 名 |
Kubernetes
| パラメータ | デフォルト | ソース | 説明 |
|---|
global.kubernetes.namespace | autonomous-agent | 固定 | デフォルト Namespace |
global.kubernetes.serviceAccount | default | 固定 | サービスアカウント名 |
global.kubernetes.rbac.create | true | 固定 | RBAC リソースの作成 |
メインアプリケーション(librechat)
| パラメータ | デフォルト | ソース | 説明 |
|---|
image.tag | — | 固定(バージョンに依存) | イメージタグ |
global.domain | front.agentic.internal | 固定 | 内部ドメイン |
vectordb.enabled | true | 固定 | ベクトル DB の有効化 |
nginx-ingress.enabled | false | 固定 | 内蔵 Ingress の無効化(既存を使用) |
appConfig.buildMode | mp | 固定 | ビルドモード(マーケットプレイス) |
appConfig.authBaseUrl | — | 自動取得 | 認証サービスの URL |
appConfig.domainClient | — | 自動取得 | クライアントドメイン |
appConfig.domainServer | — | 自動取得 | サーバードメイン |
appConfig.jwtSecret | — | 自動生成 | JWT シークレット |
appConfig.jwtRefreshSecret | — | 自動生成 | JWT リフレッシュシークレット |
appConfig.credsKey | — | 自動生成 | 認証情報暗号化キー |
appConfig.credsIv | — | 自動生成 | 認証情報暗号化 IV |
appConfig.tokenEncryptionKey | — | 自動生成 | トークン暗号化キー |
appConfig.searchSyncSecret | — | 自動生成 | 検索同期シークレット |
appConfig.gateApiKey | — | 自動生成 | Gate API キー |
appConfig.extApiKey | — | 自動生成 | 外部 API キー |
appConfig.extApiWebhookSecret | — | 自動生成 | Webhook シークレット |
appConfig.cspImgSrcAdditional | "" | — | CSP img-src 追加ドメイン |
appConfig.trustProxy | ""(MP 既定 1) | — | 送信元 IP 判定で信頼する前段プロキシ段数。Front Door / CloudFront 等を前段に置く場合は "2" を指定(未指定だと実利用者ではなく前段プロキシの IP で判定される) |
appConfig.webpushVapidPublicKey | "" | — | WebPush VAPID 公開鍵 |
appConfig.webpushVapidPrivateKey | "" | — | WebPush VAPID 秘密鍵 |
appConfig.webpushVapidEmail | "" | — | WebPush VAPID 通知先メールアドレス |
mongodb.podAntiAffinityPreset | soft | 固定 | MongoDB の AntiAffinity |
api.hpa.minReplicas | 1 | 固定 | 最小レプリカ数 |
認証サービス(librechat-auth)
| パラメータ | デフォルト | ソース | 説明 |
|---|
image.tag | — | 固定(バージョンに依存) | イメージタグ |
env.APP_URL | — | 自動取得 | 認証サービスの URL |
env.LIBRECHAT_URL | — | 自動取得 | メインアプリの URL |
env.ADMIN_CONSOLE_URL | — | 自動取得 | 管理画面の URL |
env.KEYCLOAK_REALM | agenticstar | 固定 | Keycloak レルム名 |
env.KEYCLOAK_ADMIN | admin | 固定 | Keycloak 管理者名 |
env.POSTGRES_DB | keycloak_db | 固定 | Keycloak 用データベース名 |
env.BUILD_MODE | mp | 固定 | ビルドモード |
env.EMAIL_AUTH_ENABLED | true | 固定 | 認証メールの有効化 |
env.NEXT_PUBLIC_REQUIRE_OAUTH | true | 固定 | OAuth 必須 |
env.WEBAUTHN_RP_NAME | AGENTIC STAR | 固定 | WebAuthn 表示名 |
env.WEBAUTHN_RP_ID | — | 自動取得 | WebAuthn RP ID(認証ドメイン) |
secrets.JWT_SECRET | — | 自動生成 | JWT シークレット |
secrets.TOKEN_ENCRYPTION_KEY | — | 自動生成 | トークン暗号化キー |
secrets.KEYCLOAK_ADMIN_PASSWORD | — | 自動生成 | Keycloak 管理者パスワード |
secrets.KEYCLOAK_CLIENT_SECRET | — | 自動生成 | Keycloak クライアントシークレット |
autoscaling.minReplicas | 1 | 固定 | 最小レプリカ数 |
keycloakx.replicas | 1 | 固定 | Keycloak レプリカ数 |
認証サーバーの外の入口(keycloak-extensions)
認証サーバー(リリース名 keycloak-extensions、Namespace librechat-auth)の外の入口(ドメイン設定ガイド)を開けたときだけ入る値です。インストーラーの config.yaml の keycloak.direct_login_address(空=閉じる(既定)・auto・ドメイン)か、インストール後の kc_direct_login.sh open が入れ、close が外します。手で helm upgrade するときも同じ名前で渡します。
| パラメータ | 開けたときの値 | ソース | 説明 |
|---|
keycloakx.secrets.direct-login.stringData.AGENTIC_STAR_KC_EXTERNAL_URL | https://<外の住所> | 開閉コマンド | 認証サーバーが外に名乗る URL。閉じると Secret ごと消える |
keycloakx.extraEnvFrom | - secretRef:
name: {{ include "keycloak.fullname" . }}-direct-login | 開閉コマンド | 上の Secret を環境変数として読み込む。閉じると空 |
keycloakx.proxy.mode | xforwarded | 開閉コマンド | 外からの要求を X-Forwarded-* ヘッダーで見分ける。閉じると forwarded(チャート既定)に戻る |
keycloakx.ingress.enabled | true | 開閉コマンド | 外の入口(Ingress)。閉じると false |
keycloakx.ingress.ingressClassName | nginx | 開閉コマンド | Ingress クラス |
keycloakx.ingress.rules[0].host | kc.agentic.internal | 開閉コマンド | 入口の内向きの名前(他の 4 つの入口と同じ形)。外に出す 12 本の道を paths に持つ |
keycloakx.ingress.annotations."nginx.ingress.kubernetes.io/server-alias" | <外の住所> | 開閉コマンド | 入口の別名。住所を変えると入れ替わる |
keycloakx.ingress.annotations."nginx.ingress.kubernetes.io/ssl-redirect"
…/force-ssl-redirect | 認証サービスの Ingress と同じ値 | 開閉コマンド(初回のみ) | 初めて開けるときに認証サービスの Ingress から写す。以後は購入者が変えた値を残す |
keycloakx.ingress.annotations."nginx.ingress.kubernetes.io/proxy-buffer-size" | 128k | 開閉コマンド(初回のみ) | 認証サーバーの応答ヘッダーが大きいときの 502 を防ぐ |
keycloakx.ingress.tls[0].hosts | [kc.agentic.internal] | 開閉コマンド(初回のみ) | TLS のホスト。方法 1〜3 で購入者が変える |
keycloakx.ingress.tls[0].secretName | 認証サービスの Ingress と同じ Secret 名 | 開閉コマンド(初回のみ) | 出荷時は selfsigned-tls-cert。cert-manager を使うときは認証サービスと別の名前(app-tls-cert-kc)にする |
認証サーバーの Ingress は、他のサービスの global.ingress.tls.* を読みません。TLS と注釈は上の keycloakx.ingress.* に直接渡してください。
管理画面(agenticai-admin)
| パラメータ | デフォルト | ソース | 説明 |
|---|
image.tag | — | 固定(バージョンに依存) | イメージタグ |
env.GEO_BLOCKING_EXCLUDED_COUNTRIES | JP | 固定 | Geo ブロック除外国(ISO 3166-1) |
env.ALLOWED_ORIGINS | — | 自動取得 | 許可オリジン |
env.AFD_CHATBOARD_FRONT_AUTH_DOMAIN | — | 自動取得 | 認証・フロントドメイン |
env.AFD_CHATBOARD_ADMIN_DOMAIN | — | 自動取得 | 管理画面ドメイン |
env.CHATBOARD_FRONT_DOMAIN | — | 自動取得 | フロントドメイン |
env.MP_INBOUND_MCP_A2A_ENABLED | "false" | config.yaml | 外部 API の受け口(MCP・A2A)が開いているか。extapi.inbound_mcp_a2a と同じ値を入れる(受け口を開ける) |
secrets.KEYCLOAK_DB | keycloak_db | 固定 | Keycloak データベース名 |
secrets.TOKEN_ENCRYPTION_KEY | — | 自動生成 | トークン暗号化キー |
replicaCount | 1 | 固定 | レプリカ数 |
autoscaling.minReplicas | 1 | 固定 | 最小レプリカ数 |
rbac.create | true | 固定 | RBAC リソースの作成 |
エージェント実行基盤(agent-executor)
| パラメータ | デフォルト | ソース | 説明 |
|---|
image.tag | — | 固定(バージョンに依存) | イメージタグ |
memory.graphiti.enabled | false | 固定 | Graphiti メモリの有効化(FalkorDB 未搭載のため無効) |
deployment.replicas | 1 | 固定 | レプリカ数 |
hpa.minReplicas | 1 | 固定 | HPA 最小レプリカ数 |
外部 API(agenticai-extapi)
| パラメータ | デフォルト | ソース | 説明 |
|---|
image.tag | — | 固定(バージョンに依存) | イメージタグ |
config.LOG_LEVEL | INFO | 固定 | ログレベル |
config.APIGW_PUBLIC_URL | https://<外部 API のドメイン> | 自動取得 | 受け口(MCP サーバー・A2A サーバー)の公開 URL。Agent Card の URL と成果物の URI に使う |
config.A2A_PUBLIC_URL | https://<外部 API のドメイン> | 自動取得 | A2A サーバーの公開 URL |
config.MP_OAUTH_TOKEN_URL | https://<認証サービスのドメイン>/api/v1/oauth/token | 自動取得 | A2A の Agent Card に出す、サービスアカウント(client_credentials)の標準のトークンエンドポイント |
config.MP_DIRECT_LOGIN_ISSUER | "" | 開閉コマンド | 認証サーバーの外の入口で出たトークンの発行元 https://<外の住所>/realms/<realm>。開けたときだけ入り、閉じると空に戻る(認証サーバーの外の入口) |
mpInbound.enabled | false | config.yaml | 受け口(MCP サーバー・A2A サーバー)の蓋。extapi.inbound_mcp_a2a の値(受け口を開ける) |
secrets.CBF_S2S_API_KEY | — | 自動生成 | S2S API キー |
secrets.WEBHOOK_SECRET | — | 自動生成 | Webhook シークレット |
replicaCount | 1 | 固定 | レプリカ数 |
autoscaling.minReplicas | 1 | 固定 | 最小レプリカ数 |
受け口(MCP サーバー・A2A サーバー)を開ける
外部 API の受け口(MCP サーバー POST /api/v1/mcp、A2A サーバー POST /api/v1/a2a/agents/{agentId})は、既定で閉じています(404 Not Found)。開けると、外部の AI クライアントや他社のエージェントが、サービスアカウントのトークン(client_credentials)で Agent を呼べます。利用者が自分のアカウントで MCP を使う場合は、あわせて認証サーバーの外の入口を開けます。
| 設定箇所 | 値 | 説明 |
|---|
config.yaml の extapi.inbound_mcp_a2a | false(既定)/ true | インストーラーが下の 2 つの値に同じ値を入れる。未設定・空も false |
外部 API(agenticai-extapi)の mpInbound.enabled | false / true | 受け口の蓋 |
管理画面(agenticai-admin)の env.MP_INBOUND_MCP_A2A_ENABLED | "false" / "true" | 管理画面の Agent の「呼び方」に MCP・A2A の行を出す。false なら「管理者が受け口を開けていない」と表示する |
開ける前提:
- 外部 API のドメイン(
domain.extapi)に独自ドメインと正規の証明書を設定していること(出荷時の自己署名証明書では外部のクライアントがつながりません)
- 接続元の制限(送信元 IP の許可など)は購入者の責任で行う
- 呼ばれる Agent は
WEBHOOK_URL を持ち、SDK の marketplace handler を使う(応答のストリーミングに必要)
インストール後に開けるには、外部 API と管理画面の両方を更新します(チャートバージョンは HELM_DRIVER=configmap helm list -A で確認した、今デプロイされているものを指定します)。
HELM_DRIVER=configmap helm upgrade agenticai-extapi agenticai-prod/agenticai-extapi \
--version 3.3.0 --reuse-values \
--set mpInbound.enabled=true \
-n agenticai-extapi-service
HELM_DRIVER=configmap helm upgrade agenticai-admin agenticai-prod/agenticai-admin \
--version 3.3.0 --reuse-values \
--set-string env.MP_INBOUND_MCP_A2A_ENABLED=true \
-n agentic-star-admin
閉じるときは、同じコマンドで false を渡します。使い方は MCP リファレンスと A2A リファレンスを参照してください。
ゲートウェイ(gate-services)
| パラメータ | デフォルト | ソース | 説明 |
|---|
image.tag | — | 固定(バージョンに依存) | イメージタグ |
appConfig.defaultFromName | "" | 固定 | メール送信者名 |
secrets.apiKey | — | 自動生成 | Gate API キー |
secrets.encryptionKey | — | 自動生成 | 暗号化キー |
secrets.azureConnectionString | "" | 固定 | Azure 接続文字列(未使用) |
replicaCount | 1 | 固定 | レプリカ数 |
autoscaling.minReplicas | 1 | 固定 | 最小レプリカ数 |
ゼロトラスト認可サービス(extauth-service)
| パラメータ | デフォルト | ソース | 説明 |
|---|
image.tag | — | 固定(バージョンに依存) | イメージタグ |
webhook.enabled | true | 固定 | Webhook の有効化 |
webhook.image.tag | — | 固定(バージョンに依存) | Webhook イメージタグ |
webhook.replicaCount | 1 | 固定 | Webhook レプリカ数 |
webhook.pdb.enabled | false | 固定 | Webhook PDB の有効化 |
webhook.mutating.failurePolicy | Ignore | 固定 | Webhook 障害時ポリシー |
webhook.affinity | null | 固定 | AntiAffinity 無効(単一レプリカ) |
cert-manager.enabled | false | 固定 | cert-manager の無効化(別途インストール済み) |
cert-manager.installCRDs | false | 固定 | CRD インストールの無効化 |
replicaCount | 1 | 固定 | レプリカ数 |
autoscaling.minReplicas | 1 | 固定 | 最小レプリカ数 |
pdb.enabled | false | 固定 | PDB の有効化 |
affinity | null | 固定 | AntiAffinity 無効(単一レプリカ) |
internalHosts.storageHosts | — | 自動取得 | 内部ストレージのホスト名 |
セキュリティ強化のためのレプリカ数・PDB・failurePolicy の変更方法はセキュリティガイドを参照してください。
ベクトル DB(qdrant)
| パラメータ | デフォルト | ソース | 説明 |
|---|
qdrant.replicaCount | 1 | 固定 | レプリカ数 |
qdrant.config.cluster.enabled | false | 固定 | クラスターモードの有効化 |
loadBalancer.enabled | false | 固定 | LoadBalancer の有効化 |
dashboard.enabled | false | 固定 | ダッシュボードの有効化 |
loadBalancer.enabled および dashboard.enabled は本番環境では必ず false にしてください。有効化すると外部からのアクセスが可能になり、データ漏洩のリスクがあります。
データベースマイグレーション(db-migration)
| パラメータ | デフォルト | ソース | 説明 |
|---|
image.tag | — | 固定(バージョンに依存) | イメージタグ |
secrets.create | true | 固定 | Secret の自動作成 |
secrets.keycloakDb | keycloak_db | 固定 | Keycloak データベース名 |
jobs.migrate.enabled | true | 固定 | マイグレーションジョブの有効化 |
jobs.migrate.backoffLimit | 0 | 固定 | リトライ回数 |
jobs.migrate.target | head | 固定 | マイグレーションターゲット |
jobs.downgrade.enabled | false | 固定 | ダウングレードジョブの有効化 |
masterData.enabled | true | 固定 | マスターデータ投入の有効化 |
qdrant.enabled | true | 固定 | Qdrant 初期データ投入の有効化 |
掲載対象外のサービス
以下のサービスの values は本リファレンスに掲載していません。これらは監視・インフラ基盤のサービスで、ユーザーが設定を変更する必要は通常ありません。
| サービス | 説明 |
|---|
| kube-prometheus-stack | Prometheus 監視スタック |
| prometheus-adapter | カスタムメトリクス API |
| ingress-nginx | Ingress コントローラー |
| loki | ログストレージ |
| alloy-logs / alloy-metrics | ログ・メトリクスコレクター |
| k8s-monitoring | Kubernetes モニタリング |
| agenticai-observability | Grafana / Jaeger |
| agenticai-datadog | Datadog 連携 |
| pvc-lifecycle-manager | PVC ライフサイクル管理 |
| init-platform | プラットフォーム初期化ジョブ |
これらのサービスの設定変更が必要な場合は、helm get values <リリース名> -n <namespace> で現在の値を確認してください。