設定
ChatWalaʻau は .env ファイルで設定します。chatwalaau init でテンプレートを生成
し、値を編集して再起動します。
必須設定
最低限、Azure OpenAI のエンドポイントとモデルを指定します:
AZURE_OPENAI_ENDPOINT=https://<your-resource>.openai.azure.com/
AZURE_OPENAI_MODELS=gpt-4o
AZURE_OPENAI_MODELS はカンマ区切りで、先頭が既定モデルです。マルチモデルや
Anthropic の設定は モデルと推論 を参照。
Azure 認証
バックエンドは Azure OpenAI の資格情報を 4 つのレーンで解決し、2 つの変数で 選択します。動作環境に合うものを選んでください。
| レーン | 使う場面 | .env 設定 |
|---|---|---|
| api-key | 初回 / PoC / CI / コンテナ、テナント跨ぎ | AZURE_OPENAI_API_KEY=<key> |
| cli（既定） | az login 可能なローカル開発 | AZURE_CREDENTIAL_MODE=cli（未設定可） |
| managed-identity | Azure App Service / Container Apps / AKS / Functions / VM | AZURE_CREDENTIAL_MODE=managed-identity |
| default | 1 つのイメージを複数環境で | AZURE_CREDENTIAL_MODE=default |
優先順位: AZURE_OPENAI_API_KEY は常に AZURE_CREDENTIAL_MODE より優先されます。
プロセスごとに、最初の資格情報解決時にアクティブなレーンが INFO ログ 1 行で示され
ます（キー値は決してログ出力されません）。
managed-identity では、コンピュートにマネージド ID を割り当て、Azure OpenAI
リソースに Cognitive Services OpenAI User ロールを付与します。ユーザー割り当て ID
では AZURE_CLIENT_ID も必要です。フェデレーション ID を使う AKS ワークロードは
AZURE_CREDENTIAL_MODE=default を使うと SDK の WorkloadIdentityCredential が自動
選択されます。chatwalaau CLI は、アクティブなレーンが cli 以外のとき
az account show の事前チェックを省略します。
.env の構成
テンプレートは設定を機能ごとにまとめています。ほとんどの機能は オプトインで既定 オフのため、必須の Azure 設定だけでサーバは動作します。各機能ページに使用する変数 が記載されており、本ページはその入口です（全変数表ではありません）。
リリース間で .env を最新に保つ
新しいリリースは多くの場合、既定オフの新設定で価値を追加するため、pip install -U
後もサーバは動き続けます。しかし、どの設定が増えたかは自分の .env からは分からず、
古いキーも溜まります。2 つのオフラインコマンドが、インストール済みリリース同梱の
テンプレートに対して .env を突き合わせます:
chatwalaau env diff # 生成時以降に追加 / 削除された設定
chatwalaau env diff --json # 機械可読
chatwalaau env sync # 突き合わせのプレビュー（ドライラン）
chatwalaau env sync --write # タイムスタンプ付きバックアップ後に適用
- 値はそのまま保持 -- 更新されるのはレイアウトとキーごとのコメントのみ。
- 何も削除しない -- テンプレートにないキーは
Unmanaged keysセクションへ移動。 --writeの前に必ず タイムスタンプ付きバックアップ（.env.<UTC>.bak）を作成。
起動時、追加された新キーが .env に不足していると 1 行ログで通知します。