Umgebungsvariablen

Pi verwendet Umgebungsvariablen auf drei Arten:

• Variablen wie PI_OFFLINE konfigurieren den Pi-Prozess.
• Pi setzt Prozessmarker, damit untergeordnete Prozesse Pi als startenden Agenten identifizieren können.
• 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 zwei Prozessmarker:

• AI_AGENT=pi ist ein allgemeiner Marker, mit dem Tools Pi als den Agenten identifizieren können, der den Prozess gestartet hat.
• PI_CODING_AGENT=true ist Pi-spezifisch und ermöglicht es untergeordneten Prozessen zu erkennen, dass sie in Pi ausgeführt werden.

Untergeordnete Prozesse erben beide Marker. Sie sind nicht sitzungsspezifisch und werden nicht automatisch gesetzt, wenn Pi über das 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.