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 marcadores de processo para que os processos filhos possam identificar o Pi como o Agent que os iniciou.
• 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 dois marcadores de processo:

• AI_AGENT=pi é um marcador genérico que permite às ferramentas identificar o Pi como o Agent que iniciou o processo.
• PI_CODING_AGENT=true é específico do Pi e permite que processos filhos detectem que estão sendo executados dentro do Pi.

Os processos filhos herdam ambos os marcadores. Eles não são específicos da sessão e não são definidos automaticamente quando o Pi é incorporado por meio do 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.