環境変数

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

• PI_OFFLINE などの変数は、Pi プロセスを構成します。
• Pi は PI_CODING_AGENT を設定し、子プロセスが Pi 内で実行されていることを検出できるようにします。
• LLM 呼び出し可能な bash ツールによって実行されるコマンドは、現在のセッションを記述する PI_* 変数を受け取ります。

プロバイダー API キー変数は、Providers に個別に文書化されています。

CLI と RPC のエントリーポイントは PI_CODING_AGENT=true を設定します。子プロセスはそれを継承し、それを使用して、Pi 内で実行されていることを検出できます。これはセッション固有ではなく、Pi が SDK を通じて埋め込まれたときに自動的に設定されません。

bash ツールによって実行されるコマンドは、現在の Pi セッション状態を受け取ります。

値は各コマンドの開始時に解決されます。したがって、モデルを切り替えたり、推論レベルを変更すると、Pi を再起動しなくても、次の bash コマンドに影響します。 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 ツールに挿入されます。これらは、ユーザーが入力した ! または !! コマンドには挿入されません。

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

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

スポーンフックとは別にセッションメタデータを無効にします。

const bashTool = createBashTool(cwd, {
  exposeSessionEnvironment: false,
  spawnHook: (ctx) => ctx,
});

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

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

ANTHROPIC_API_KEY、OPENAI_API_KEY などのプロバイダーの認証情報、およびクラウドプロバイダーの構成は、Providers にリストされます。