Variables d'environnement

Pi utilise les variables d'environnement de trois manières:

• Des variables telles que PI_OFFLINE configurent le processus Pi.
• Pi définit PI_CODING_AGENT afin que les processus enfants puissent détecter qu'ils s'exécutent à l'intérieur de Pi.
• Les commandes exécutées par l'outil bash appelable LLM reçoivent des variables PI_* décrivant la session en cours.

Les variables clés du fournisseur API sont documentées séparément dans Providers.

Les points d'entrée CLI et RPC définissent PI_CODING_AGENT=true. Les processus enfants en héritent et peuvent l'utiliser pour détecter qu'ils s'exécutent à l'intérieur de Pi. Il n'est pas spécifique à la session et n'est pas défini automatiquement lorsque Pi est intégré via le SDK.

Les commandes exécutées par l'outil bash reçoivent l'état de session actuel Pi:

Les valeurs sont résolues au démarrage de chaque commande. Changer de modèle ou changer de niveau de raisonnement affecte donc la commande bash suivante sans redémarrer Pi. PI_PROVIDER et PI_MODEL identifient le modèle Pi sélectionné, et non un modèle en amont différent qu'un routeur peut choisir en interne.

Lorsqu'on vous demande quel modèle ou fournisseur est en cours d'exécution, inspectez ces variables au lieu de déduire la réponse à partir de l'invite du système:

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

Le fichier de session peut être inspecté directement lorsque la session est persistante:

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

Ces variables sont injectées dans l'outil bash appelable LLM. Ils ne sont pas injectés dans les commandes ! ou !! saisies par l'utilisateur.

Les outils Bash créés avec createBashTool() exposent l'environnement de session par défaut lorsqu'ils sont enregistrés avec Pi. L'injection a lieu avant spawnHook, donc un hook reçoit les variables en ctx.env:

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

Désactivez les métadonnées de session indépendamment du hook de spawn:

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

Lorsqu'il est désactivé, Pi supprime les valeurs héritées de ces variables afin que les processus Pi imbriqués n'exposent pas les métadonnées obsolètes de la session parent.

Ces variables sont lues par Pi lui-même:

Les informations d'identification du fournisseur telles que ANTHROPIC_API_KEY, OPENAI_API_KEY et la configuration du fournisseur cloud sont répertoriées dans Providers.