agentengine CLIは、CLI自体の動作を変更する一連の環境変数を読み取ります。このページは、それらの入力のドキュメントです。配置されたエージェント、ローカル開発スタック、または生成されたコンテナを構成する変数は、それらの機能とともに文書化されています。
コマンドが同じ設定に対してフラグを公開している場合、環境変数よりもフラグが優先されます。
更新チェック
リリースされたバイナリは、新しいバージョンがないか確認し、存在する場合はstderrに通知を出力します。このチェックは最大で24時間に1回実行され、その状態を~/.agentengine/update-check.jsonにレコードします。
チェックを無効にするには、AGENTENGINE_NO_UPDATE_CHECK=1 を設定します。このチェックは、CI 環境変数が設定されている場合や、バイナリがローカル開発ビルドするである場合にもスキップされます。
テレメトリー
CLIには2つの独立したレポート作成チャンネルがあります。どちらも、リリースされたバイナリではデフォルトでオンになっており、開発ビルドやCIが設定されている場合はオフになっています。
AGENTENGINE_TELEMETRY_ENABLEDエージェントエンジンゲートウェイに送信される製品使用状況の分析を制御します。AGENTENGINE_SENTRY_ENABLEDSentryに送信されるクラッシュレポートとエラーレポートを制御します。レポート作成には、ビルド時に埋め込まれたSentry DSNも必要であり、リリースビルドにはこれが含まれています。
いずれかの変数を 0、false、no、または off に設定すると、そのチャンネルが無効になります。
製品の分析も、合成（カナリア/テスト）アカウントに対しては自動的にオプトアウトされます。ログインによってテレメトリが無効になっているアカウントが解決されると、CLIはインストール時にその旨をレコードし、実際のユーザーアカウントとして後でログインしてクリアされるまで、ログイン前のイベントを含む製品の分析の送信を停止します。上記の変数が依然として優先されるため、AGENTENGINE_TELEMETRY_ENABLED=0を設定すると、テレメトリは無効のままになります。
製品利用の分析では、機能が使用されたことは記録されますが、何に対して使用されたかは記録されません。各CLIの呼び出しは、そのコマンドパス（例: agentengine dev up）、成功/失敗の結果、失敗時の大まかなエラークラス、およびインストール、ログイン、機能のマイルストーンイベントとともにカウントされます。イベントには、コマンド引数、ファイルパス、シークレット値、エラーメッセージテキストは含まれません。ログイン前の実行は、サインイン時にアカウントにリンクされる仮の匿名IDで記録されます。
Sentry の場合、特に CLI はリリース ビルドに埋め込まれた DSN を抑制します。そのため、CLI が起動するコンテナは、ユーザーがオプトインするまでレポートしません。コンテナのレポート作成には、環境内で AGENTENGINE_SENTRY_ENABLED=1 と明示的な AGENTENGINE_SENTRY_DSN の両方が必要です。これらは、生成されたスタックによってコンテナが読み取る名前に翻訳されます。
ログ記録
CLI は、プラットフォーム ログ ディレクトリの下のファイルにセッション ログを書き込み (write)ます。次の変数はそのログを制御します。フラグ --log-level、--log-file、--no-log は同じ動作を設定し、両方が存在する場合は優先します。
変数 | Flag | default | 効果 |
|---|---|---|---|
|
|
| ファイルの冗長: |
|
| プラットフォームのログディレクトリ内のタイムスタンプ付きパス | ログをこのパスに書き込み (write)ます |
|
| 設定解除 | ファイルログ記録を無効化する |
| — |
| 保持するログファイルの数（これを超えると古いものから削除されます） |
| — | 設定解除 | 自動ログ削除を無効にする |
これらのブール値はどちらも、大文字と小文字を区別せず、1、true、yes、またはonをtrueとして受け入れます。その他の値（設定されていない変数を含む）はfalseです。このページの他の変数については、それぞれの上に許容される値が記載されています。
コマンド出力
ほとんどのコマンドは、出力の先頭にコンテキスト行を表示し、そのコマンドが対象とする組織、プロジェクト、ワークスペース、環境を示します。AGENTENGINE_NO_BREADCRUMB を空ではない値に設定すると、その行が非表示になります。これは、コマンド出力を解析するスクリプトに適しています。
ローカル開発環境でのTLSインスペクション
agentengine dev up PyPIとnpmからパッケージをフェッチするローカルイメージをビルドします。会社のCAでHTTPSをインターセプトするネットワークでは、AGENTENGINE_CA_BUNDLEをそのCAのPEMファイルに設定します（または--ca-bundleを渡します）。CLIはパッケージのインストール前にそれを生成されたイメージに埋め込むため、uvとnpmは再署名されたトラフィックを信頼し、プロキシを介したエージェントのランタイムHTTPS呼び出しも機能します。CAは~/.agentengine/の下のワークスペースごとに記録され、同じマシンでの後の実行で再利用されます。ワークスペース.envの値は無視されるため、クローンされたリポジトリはCAをインストールできません。ローカルagentengine dev upでの企業TLS検査を参照してください。