環境変数

Pi は環境変数を次の 3 つの方法で使用します。

• PI_OFFLINE などの変数で Pi プロセスを設定します。
• 子プロセスが Pi を起動元のエージェントとして識別できるように、Pi はプロセスマーカーを設定します。
• LLM から呼び出せるシェルツールが実行するコマンドは、現在のセッションを表す PI_* 変数を受け取ります。

プロバイダーの API キー用変数については、プロバイダー認証に別途記載しています。

プロセスマーカー#

CLI と RPC のエントリーポイントは、次の 2 つのプロセスマーカーを設定します。

• AI_AGENT=pi は、プロセスを起動したエージェントが Pi であることをツールが識別できるようにする汎用マーカーです。
• PI_CODING_AGENT=true は Pi 固有のマーカーで、子プロセスが Pi 内で実行されていることを検出できるようにします。

子プロセスは両方のマーカーを継承します。これらはセッション固有ではなく、SDK を介して Pi を組み込んだ場合には自動的に設定されません。

シェルツールのセッション環境#

bash ツールと powershell ツールが実行するコマンドは、現在の Pi セッションの状態を受け取ります。

値は各コマンドの開始時に解決されます。そのため、モデルの切り替えや推論レベルの変更は、Pi を再起動しなくても次のシェルコマンドに反映されます。PI_PROVIDER と PI_MODEL が示すのは選択された Pi モデルであり、ルーターが内部で選択する可能性のある別の上流モデルではありません。

実行中のモデルまたはプロバイダーを尋ねられた場合は、システムプロンプトから答えを推測せず、これらの変数を確認してください。

printf '%s/%s\n' "$PI_PROVIDER" "$PI_MODEL"
printf 'reasoning=%s session=%s\n' "$PI_REASONING_LEVEL" "$PI_SESSION_ID"

セッションが永続的な場合は、セッションファイルを直接確認できます。

if [ -n "$PI_SESSION_FILE" ]; then
  tail -n 1 "$PI_SESSION_FILE"
fi

これらの変数は、LLM から呼び出せる bash ツールと powershell ツールに注入されます。ユーザーが入力した ! コマンドまたは !! コマンドには注入されません。

カスタムシェルツール#

createBashTool() または createPowerShellTool() で作成したツールを Pi に登録すると、デフォルトでセッション環境が公開されます。注入は spawnHook より前に行われるため、フックは ctx.env で変数を受け取ります。

const bashTool = createBashTool(cwd, {
  spawnHook: (ctx) => ({
    ...ctx,
    env: { ...ctx.env, CI: "1" },
  }),
});

スポーンフックとは独立してセッションメタデータを無効にします：

const powershellTool = createPowerShellTool(cwd, {
  exposeSessionEnvironment: false,
  spawnHook: (ctx) => ctx,
});

無効にすると、ネストされた Pi プロセスが古い親セッションのメタデータを公開しないように、Pi はこれらの変数の継承値を削除します。

Pi プロセスの設定#

次の変数は Pi 自体によって読み取られます。

ANTHROPIC_API_KEY、OPENAI_API_KEY、クラウドプロバイダーの設定などのプロバイダー認証情報は、プロバイダー認証に記載しています。