Variáveis ​​de ambiente

Pi usa variáveis ​​de ambiente de três maneiras:

• Variáveis ​​como PI_OFFLINE configuram o processo Pi.
• Pi define PI_CODING_AGENT para que os processos filhos possam detectar que eles são executados dentro de Pi.
• Os comandos executados pela ferramenta bash que pode ser chamada por LLM recebem variáveis ​​PI_* que descrevem a sessão atual.

As variáveis ​​de chave API do provedor são documentadas separadamente em Providers.

Os pontos de entrada CLI e RPC definem PI_CODING_AGENT=true. Os processos filhos o herdam e podem usá-lo para detectar que são executados dentro de Pi. Não é específico da sessão e não é definido automaticamente quando Pi é incorporado através de SDK.

Os comandos executados pela ferramenta bash recebem o estado atual da sessão Pi:

Os valores são resolvidos quando cada comando é iniciado. Mudar de modelo ou alterar o nível de raciocínio afeta o próximo comando bash sem reiniciar Pi. PI_PROVIDER e PI_MODEL identificam o modelo Pi selecionado, não um modelo upstream diferente que um roteador possa escolher internamente.

Quando questionado sobre qual modelo ou provedor está em execução, inspecione essas variáveis ​​em vez de inferir a resposta do prompt do sistema:

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

O arquivo da sessão pode ser inspecionado diretamente quando a sessão é persistente:

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

Essas variáveis ​​são injetadas na ferramenta bash que pode ser chamada pelo LLM. Eles não são injetados nos comandos ! ou !! inseridos pelo usuário.

As ferramentas Bash criadas com createBashTool() expõem o ambiente de sessão por padrão quando registradas com Pi. A injeção acontece antes de spawnHook, então um gancho recebe as variáveis ​​em ctx.env:

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

Desative os metadados da sessão independentemente do gancho de geração:

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

Quando desabilitado, Pi remove valores herdados para essas variáveis, de forma que processos Pi aninhados não exponham metadados obsoletos da sessão pai.

Essas variáveis ​​são lidas pelo próprio Pi:

As credenciais do provedor, como ANTHROPIC_API_KEY, OPENAI_API_KEY, e a configuração do provedor de nuvem estão listadas em Providers.