Variables de entorno

Pi utiliza variables de entorno de tres maneras:

• Variables como PI_OFFLINE configuran el proceso Pi.
• Pi establece marcadores de proceso para que los procesos secundarios puedan identificar a Pi como el agente que los inició.
• Los comandos ejecutados por la herramienta bash invocable por LLM reciben variables PI_* que describen la sesión actual.

Las variables clave del proveedor API se documentan por separado en Providers.

Los puntos de entrada CLI y RPC establecen dos marcadores de proceso:

• AI_AGENT=pi es un marcador genérico que permite a las herramientas identificar a Pi como el agente que inició el proceso.
• PI_CODING_AGENT=true es específico de Pi y permite a los procesos secundarios detectar que se ejecutan dentro de Pi.

Los procesos secundarios heredan ambos marcadores. No son específicos de la sesión y no se establecen automáticamente cuando Pi se integra mediante el SDK.

Los comandos ejecutados por la herramienta bash reciben el estado actual de la sesión Pi:

Los valores se resuelven cuando se inicia cada comando. Por lo tanto, cambiar de modelo o cambiar el nivel de razonamiento afecta al siguiente comando bash sin reiniciar Pi. PI_PROVIDER y PI_MODEL identifican el modelo Pi seleccionado, no un modelo ascendente diferente que un enrutador puede elegir internamente.

Cuando se le pregunte qué modelo o proveedor se está ejecutando, inspeccione estas variables en lugar de inferir la respuesta del mensaje del sistema:

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

El archivo de sesión se puede inspeccionar directamente cuando la sesión es persistente:

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

Estas variables se inyectan en la herramienta bash invocable por LLM. No se inyectan en los comandos ! o !! ingresados por el usuario.

Las herramientas Bash creadas con createBashTool() exponen el entorno de sesión de forma predeterminada cuando se registran con Pi. La inyección ocurre antes de spawnHook, por lo que un gancho recibe las variables en ctx.env:

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

Deshabilite los metadatos de la sesión independientemente del gancho de generación:

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

Cuando está deshabilitado, Pi elimina los valores heredados de estas variables, de modo que los procesos Pi anidados no exponen metadatos obsoletos de la sesión principal.

Estas variables son leídas por el propio Pi:

Las credenciales del proveedor como ANTHROPIC_API_KEY, OPENAI_API_KEY y la configuración del proveedor de la nube se enumeran en Providers.