設定リファレンス

設定の読み込み方法

設定は、ConfigSource（agent_lab/core/config.py を参照）によって読み込まれるシンプルな辞書で、 DI コンテナにバインドされます。create_app() は default_config_source() を通じて、次の順序どおりにソースを選択します。最初に一致したものが採用されます。

アプリごとに選択を上書きすることもできます。

app = create_app(config_source=YamlConfigSource("config.yml"))  # explicit

設定キー

有効なソースが返す必要のある辞書です。記載のデフォルト値は config-dev.yml（開発用）のものです。リファレンスアプリには、これとまったく同じ構造の config-dev.yml、config-test.yml、 config-docker.yml が同梱されています。

static は特別です。YAML ソースでは明示的に設定しますが、Vault ソースではコード上の規約から導出されます。STATIC_DIR の下に SPA ビルドが存在する場合に有効になります。

Vault シークレットペイロード

VaultConfigSource は単一の KV-v2 シークレット（デフォルトではエンジン secret、パス app_secrets）を読み込み、上記のキーにマッピングします。

このペイロードのプロビジョニング方法（開発用 Docker Compose、Kubernetes、Terraform）は、 Vault によるシークレット管理とデプロイガイドで説明しています。

環境変数

設定ソースの選択

オブザーバビリティ

Langfuse の変数のいずれかが欠けている場合、Langfuse バックエンドは何も通知されずに無効化され、アプリはそのまま起動します（LangWatch も同様です）。詳細と拡張ポイントについてはオブザーバビリティを参照してください。

認証とインテグレーション

シミュレーション（テストスイート専用）

これらの使われ方については、テストとシミュレーションを参照してください。

カスタム設定ソース

ConfigSource ABC を実装し、create_app(config_source=...) に渡します。 AWS Secrets Manager の利用、環境変数のみによるデプロイ、別のソースのラップなどに便利です。

from agent_lab import ConfigSource, create_app


class MyConfigSource(ConfigSource):
    def load(self) -> dict:
        return {
            "api_base_url": "https://api.example.com",
            "db": {"url": "postgresql://…", "vectors": "…", "checkpoints": "…"},
            "auth": {"enabled": True, "url": "…", "realm": "…", "client_id": "…", "client_secret": "…"},
            "broker": {"url": "redis://…"},
            # … remaining keys as in the table above
        }


app = create_app(config_source=MyConfigSource())

同梱のソース（YamlConfigSource、VaultConfigSource、 KubernetesVaultConfigSource）と default_config_source() は、すべてトップレベルの agent_lab パッケージからエクスポートされています。