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

Helm Values リファレンス

AGENTIC STAR マーケットプレイス版の Helm チャートで使用される設定パラメータの一覧です。

各パラメータの「ソース」列は値の設定方法を示します。

ソース説明
固定デフォルトの固定値。通常は変更不要
UI 入力購入時のデプロイフォームで指定した値が設定される
自動取得デプロイ時に Azure リソースから自動取得される
自動生成デプロイ時にランダムなシークレットが自動生成される
config.yamlインストーラーの config.yaml で指定した値が設定される(マーケットプレイスの作成画面には出ない)
開閉コマンドインストール後に管理者が kc_direct_login.sh で開け閉めしたときだけ入る

自動取得・自動生成されるパラメータの全体像​

各サービスのテーブルでは個別の値が「ソース」列に記載されていますが、デプロイ後に「想定どおりに値が設定されているか」を確認するには、ここに集約した一覧を参照してください。特に librechat-env-secret はメインアプリの主要シークレットが集約される Secret で、ここに格納される値の多くがインストーラーによって自動取得・自動生成されます。

自動取得されるパラメータ(Azure の場合)​

パラメータ取得元主な配置先
global.azure.subscriptionIdaz account show各サービスの ConfigMap
global.azure.resourceGroupNameARM テンプレート各サービスの ConfigMap
aks.nodeResourceGroupaz aks show --query nodeResourceGroup各サービスの ConfigMap
global.postgresql.hostPostgreSQL Flexible Server の FQDN*-env-secret
global.postgresql.databaseARM テンプレート出力*-env-secret
global.objectStorage.azure.connectionStringaz storage account show-connection-string(Private Storage)librechat-env-secret (key: AZURE_STORAGE_CONNECTION_STRING)
global.objectStorage.azure.storageAccountNameARM テンプレートConfigMap
global.objectStorage.azure.customDomain<storageAccountName>.blob.core.windows.netConfigMap
publicStorage.connectionStringaz 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内部ストレージ FQDNextauth-service ConfigMap
AWS の場合
  • オブジェクトストレージは 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 上でオブジェクトストレージの設定を読んで確認できます。

curl
# Azure: AZURE_STORAGE_CONNECTION_STRING の確認
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 の形式であれば正常です。

curl
# AWS: S3 のバケット名の確認
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.languagejaUI 入力UI の表示言語(ja / en / fr / es / th / ar / id / zh-Hans / zh-Hant / pt-BR / de-DE / it-IT / vi / ko)

コンテナレジストリ​

パラメータデフォルトソース説明
global.imagePullSecret.enabledfalse固定イメージプルシークレットの有効化
global.imagePullSecret.name""固定シークレット名
global.imagePullSecret.registry""固定レジストリ URL

PostgreSQL​

パラメータデフォルトソース説明
global.postgresql.host—自動取得PostgreSQL サーバーの FQDN
global.postgresql.port5432固定ポート番号
global.postgresql.database—自動取得データベース名
global.postgresql.username—UI 入力管理者ユーザー名
global.postgresql.password—UI 入力管理者パスワード
global.postgresql.useAzureAdfalse固定Azure AD 認証の使用
global.postgresql.poolMinSize5固定コネクションプール最小サイズ
global.postgresql.poolMaxSize20固定コネクションプール最大サイズ
global.postgresql.commandTimeout60固定コマンドタイムアウト(秒)
global.postgresql.poolTimeout30固定プールタイムアウト(秒)
global.postgresql.maxOverflow10固定最大オーバーフロー接続数

Azure 設定​

パラメータデフォルトソース説明
global.azure.subscriptionId—自動取得Azure サブスクリプション ID
global.azure.resourceGroupName—自動取得リソースグループ名

オブジェクトストレージ​

パラメータデフォルトソース説明
global.objectStorage.providerazure固定ストレージプロバイダー
global.objectStorage.azure.containerautonomous-agent-files固定Azure Blob コンテナ名
global.objectStorage.azure.connectionString—自動取得接続文字列
global.objectStorage.azure.storageAccountName—自動取得ストレージアカウント名
global.objectStorage.azure.customDomain—自動取得カスタムドメイン

Ingress TLS​

パラメータデフォルトソース説明
global.ingress.tls.enabledtrue固定TLS の有効化
global.ingress.tls.secretNameselfsigned-tls-cert固定TLS 証明書の Secret 名
global.ingress.tls.useCertManagerfalse固定cert-manager の使用
global.ingress.tls.clusterIssuer""固定ClusterIssuer 名

Kubernetes​

パラメータデフォルトソース説明
global.kubernetes.namespaceautonomous-agent固定デフォルト Namespace
global.kubernetes.serviceAccountdefault固定サービスアカウント名
global.kubernetes.rbac.createtrue固定RBAC リソースの作成

メインアプリケーション(librechat)​

パラメータデフォルトソース説明
image.tag—固定(バージョンに依存)イメージタグ
global.domainfront.agentic.internal固定内部ドメイン
vectordb.enabledtrue固定ベクトル DB の有効化
nginx-ingress.enabledfalse固定内蔵 Ingress の無効化(既存を使用)
appConfig.buildModemp固定ビルドモード(マーケットプレイス)
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.podAntiAffinityPresetsoft固定MongoDB の AntiAffinity
api.hpa.minReplicas1固定最小レプリカ数

認証サービス(librechat-auth)​

パラメータデフォルトソース説明
image.tag—固定(バージョンに依存)イメージタグ
env.APP_URL—自動取得認証サービスの URL
env.LIBRECHAT_URL—自動取得メインアプリの URL
env.ADMIN_CONSOLE_URL—自動取得管理画面の URL
env.KEYCLOAK_REALMagenticstar固定Keycloak レルム名
env.KEYCLOAK_ADMINadmin固定Keycloak 管理者名
env.POSTGRES_DBkeycloak_db固定Keycloak 用データベース名
env.BUILD_MODEmp固定ビルドモード
env.EMAIL_AUTH_ENABLEDtrue固定認証メールの有効化
env.NEXT_PUBLIC_REQUIRE_OAUTHtrue固定OAuth 必須
env.WEBAUTHN_RP_NAMEAGENTIC 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.minReplicas1固定最小レプリカ数
keycloakx.replicas1固定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_URLhttps://<外の住所>開閉コマンド認証サーバーが外に名乗る URL。閉じると Secret ごと消える
keycloakx.extraEnvFrom- secretRef:
name: {{ include "keycloak.fullname" . }}-direct-login
開閉コマンド上の Secret を環境変数として読み込む。閉じると空
keycloakx.proxy.modexforwarded開閉コマンド外からの要求を X-Forwarded-* ヘッダーで見分ける。閉じると forwarded(チャート既定)に戻る
keycloakx.ingress.enabledtrue開閉コマンド外の入口(Ingress)。閉じると false
keycloakx.ingress.ingressClassNamenginx開閉コマンドIngress クラス
keycloakx.ingress.rules[0].hostkc.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_COUNTRIESJP固定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_DBkeycloak_db固定Keycloak データベース名
secrets.TOKEN_ENCRYPTION_KEY—自動生成トークン暗号化キー
replicaCount1固定レプリカ数
autoscaling.minReplicas1固定最小レプリカ数
rbac.createtrue固定RBAC リソースの作成

エージェント実行基盤(agent-executor)​

パラメータデフォルトソース説明
image.tag—固定(バージョンに依存)イメージタグ
memory.graphiti.enabledfalse固定Graphiti メモリの有効化(FalkorDB 未搭載のため無効)
deployment.replicas1固定レプリカ数
hpa.minReplicas1固定HPA 最小レプリカ数

外部 API(agenticai-extapi)​

パラメータデフォルトソース説明
image.tag—固定(バージョンに依存)イメージタグ
config.LOG_LEVELINFO固定ログレベル
config.APIGW_PUBLIC_URLhttps://<外部 API のドメイン>自動取得受け口(MCP サーバー・A2A サーバー)の公開 URL。Agent Card の URL と成果物の URI に使う
config.A2A_PUBLIC_URLhttps://<外部 API のドメイン>自動取得A2A サーバーの公開 URL
config.MP_OAUTH_TOKEN_URLhttps://<認証サービスのドメイン>/api/v1/oauth/token自動取得A2A の Agent Card に出す、サービスアカウント(client_credentials)の標準のトークンエンドポイント
config.MP_DIRECT_LOGIN_ISSUER""開閉コマンド認証サーバーの外の入口で出たトークンの発行元 https://<外の住所>/realms/<realm>。開けたときだけ入り、閉じると空に戻る(認証サーバーの外の入口)
mpInbound.enabledfalseconfig.yaml受け口(MCP サーバー・A2A サーバー)の蓋。extapi.inbound_mcp_a2a の値(受け口を開ける)
secrets.CBF_S2S_API_KEY—自動生成S2S API キー
secrets.WEBHOOK_SECRET—自動生成Webhook シークレット
replicaCount1固定レプリカ数
autoscaling.minReplicas1固定最小レプリカ数

受け口(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_a2afalse(既定)/ trueインストーラーが下の 2 つの値に同じ値を入れる。未設定・空も false
外部 API(agenticai-extapi)の mpInbound.enabledfalse / 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 で確認した、今デプロイされているものを指定します)。

curl
# 外部 API: 受け口を開ける
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

# 管理画面: 「呼び方」に MCP・A2A を出す
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 接続文字列(未使用)
replicaCount1固定レプリカ数
autoscaling.minReplicas1固定最小レプリカ数

ゼロトラスト認可サービス(extauth-service)​

パラメータデフォルトソース説明
image.tag—固定(バージョンに依存)イメージタグ
webhook.enabledtrue固定Webhook の有効化
webhook.image.tag—固定(バージョンに依存)Webhook イメージタグ
webhook.replicaCount1固定Webhook レプリカ数
webhook.pdb.enabledfalse固定Webhook PDB の有効化
webhook.mutating.failurePolicyIgnore固定Webhook 障害時ポリシー
webhook.affinitynull固定AntiAffinity 無効(単一レプリカ)
cert-manager.enabledfalse固定cert-manager の無効化(別途インストール済み)
cert-manager.installCRDsfalse固定CRD インストールの無効化
replicaCount1固定レプリカ数
autoscaling.minReplicas1固定最小レプリカ数
pdb.enabledfalse固定PDB の有効化
affinitynull固定AntiAffinity 無効(単一レプリカ)
internalHosts.storageHosts—自動取得内部ストレージのホスト名
ヒント

セキュリティ強化のためのレプリカ数・PDB・failurePolicy の変更方法はセキュリティガイドを参照してください。

ベクトル DB(qdrant)​

パラメータデフォルトソース説明
qdrant.replicaCount1固定レプリカ数
qdrant.config.cluster.enabledfalse固定クラスターモードの有効化
loadBalancer.enabledfalse固定LoadBalancer の有効化
dashboard.enabledfalse固定ダッシュボードの有効化
危険

loadBalancer.enabled および dashboard.enabled は本番環境では必ず false にしてください。有効化すると外部からのアクセスが可能になり、データ漏洩のリスクがあります。

データベースマイグレーション(db-migration)​

パラメータデフォルトソース説明
image.tag—固定(バージョンに依存)イメージタグ
secrets.createtrue固定Secret の自動作成
secrets.keycloakDbkeycloak_db固定Keycloak データベース名
jobs.migrate.enabledtrue固定マイグレーションジョブの有効化
jobs.migrate.backoffLimit0固定リトライ回数
jobs.migrate.targethead固定マイグレーションターゲット
jobs.downgrade.enabledfalse固定ダウングレードジョブの有効化
masterData.enabledtrue固定マスターデータ投入の有効化
qdrant.enabledtrue固定Qdrant 初期データ投入の有効化

掲載対象外のサービス​

以下のサービスの values は本リファレンスに掲載していません。これらは監視・インフラ基盤のサービスで、ユーザーが設定を変更する必要は通常ありません。

サービス説明
kube-prometheus-stackPrometheus 監視スタック
prometheus-adapterカスタムメトリクス API
ingress-nginxIngress コントローラー
lokiログストレージ
alloy-logs / alloy-metricsログ・メトリクスコレクター
k8s-monitoringKubernetes モニタリング
agenticai-observabilityGrafana / Jaeger
agenticai-datadogDatadog 連携
pvc-lifecycle-managerPVC ライフサイクル管理
init-platformプラットフォーム初期化ジョブ

これらのサービスの設定変更が必要な場合は、helm get values <リリース名> -n <namespace> で現在の値を確認してください。