Umgebungsvariablen

Pi verwendet Umgebungsvariablen auf drei Arten:

• Variablen wie PI_OFFLINE konfigurieren den Pi-Prozess.
• Pi setzt PI_CODING_AGENT, damit untergeordnete Prozesse erkennen können, dass sie in Pi ausgeführt werden.
• Befehle, die vom LLM-aufrufbaren bash-Tool ausgeführt werden, empfangen PI_* Variablen, die die aktuelle Sitzung beschreiben.

Provider-API-Schlüsselvariablen werden separat in Providers dokumentiert.

Die Einstiegspunkte CLI und RPC setzen PI_CODING_AGENT=true. Untergeordnete Prozesse erben es und können damit erkennen, dass sie in Pi ausgeführt werden. Es ist nicht sitzungsspezifisch und wird nicht automatisch festgelegt, wenn Pi über SDK eingebettet wird.

Befehle, die vom bash-Tool ausgeführt werden, erhalten den aktuellen Pi-Sitzungsstatus:

Die Werte werden beim Start jedes Befehls aufgelöst. Ein Modellwechsel oder eine Änderung der Argumentationsebene wirkt sich daher auf den nächsten bash-Befehl aus, ohne dass Pi neu gestartet werden muss. PI_PROVIDER und PI_MODEL identifizieren das ausgewählte Pi Modell, nicht ein anderes Upstream-Modell, das ein Router intern auswählen kann.

Wenn Sie gefragt werden, welches Modell oder welcher Anbieter ausgeführt wird, überprüfen Sie diese Variablen, anstatt die Antwort aus der Systemeingabeaufforderung abzuleiten:

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

Die Sitzungsdatei kann direkt überprüft werden, wenn die Sitzung dauerhaft ist:

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

Diese Variablen werden in das LLM-aufrufbare bash-Tool eingefügt. Sie werden nicht in vom Benutzer eingegebene !- oder !!-Befehle eingefügt.

Mit createBashTool() erstellte Bash-Tools legen die Sitzungsumgebung standardmäßig offen, wenn sie mit Pi registriert werden. Die Injektion erfolgt vor spawnHook, sodass ein Hook die Variablen in ctx.env empfängt:

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

Sitzungsmetadaten unabhängig vom Spawn-Hook deaktivieren:

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

Wenn die Option deaktiviert ist, entfernt Pi geerbte Werte für diese Variablen, sodass verschachtelte Pi-Prozesse keine veralteten Metadaten der übergeordneten Sitzung offenlegen.

Diese Variablen werden von Pi selbst gelesen:

Anbieteranmeldeinformationen wie ANTHROPIC_API_KEY, OPENAI_API_KEY und die Cloud-Anbieterkonfiguration werden in Providers aufgeführt.