Skip to main content
Pi è il progetto Pi Agent Harness. Il pacchetto @earendil-works/pi-coding-agent fornisce una CLI interattiva per agenti di coding con workflow per file, shell, modifica, scrittura, sessione, stampa, JSON, RPC e SDK. Pi può caricare provider personalizzati da ~/.pi/agent/models.json, quindi puoi aggiungere CometAPI come voci di provider compatibili con OpenAI senza modificare il codice sorgente di Pi. Riferimenti ufficiali:
La disponibilità dei modelli cambia nel tempo. Sostituisci your-model-id con un model ID disponibile dalla pagina dei modelli di CometAPI.

​
Prerequisiti

  • Node.js >=22.19.0
  • npm
  • Un account CometAPI con una chiave API attiva dalla dashboard
  • Pi installato dal pacchetto npm ufficiale

​
Comprendere i permessi di runtime

Pi viene eseguito con i permessi dell’utente e del processo che lo avvia. Avvia Pi nella directory del progetto su cui vuoi farlo lavorare, mantieni un percorso di rollback come git e usa un container o una sandbox se hai bisogno di limiti più rigorosi per filesystem, processi, rete o credenziali.

​
Configura il provider

1

Installa Pi

Installa Pi globalmente con npm:
Conferma che la CLI sia disponibile:
2

Imposta la tua chiave API CometAPI

Memorizza la tua chiave API CometAPI nella variabile d’ambiente COMETAPI_KEY:
Aggiungi il comando di export al profilo della tua shell se vuoi che persista tra le sessioni del terminale. Non salvare le chiavi API nel controllo di versione.
3

Aggiungi i provider CometAPI a models.json

Crea ~/.pi/agent/models.json se non esiste. Se il file contiene già dei provider, unisci le voci cometapi-responses e cometapi-chat nell’oggetto providers esistente:
Usa cometapi-responses per i modelli o i workflow che richiedono l’API OpenAI Responses. Usa cometapi-chat per i modelli compatibili con OpenAI Chat Completions. Pi risolve $COMETAPI_KEY al momento della richiesta. Mantieni la chiave API nel tuo ambiente o nel tuo workflow di gestione dei segreti.
4

Verifica entrambi i provider

Elenca i modelli che Pi può vedere per il provider Responses:
Esegui un breve prompt one-shot con il provider Responses:
Elenca i modelli che Pi può vedere per il provider Chat Completions:
Esegui un breve prompt one-shot con il provider Chat Completions:
Per l’uso interattivo, avvia Pi nel tuo progetto e seleziona il provider e il modello CometAPI con /model. Se modifichi models.json durante una sessione interattiva, apri di nuovo /model in modo che Pi ricarichi le voci dei modelli personalizzati.

​
Risoluzione dei problemi

Verifica che ~/.pi/agent/models.json sia JSON valido e che ogni voce provider si trovi all’interno dell’oggetto providers di primo livello. Esegui pi --list-models cometapi-responses oppure pi --list-models cometapi-chat dopo aver salvato il file.
Verifica che COMETAPI_KEY sia impostata nella stessa sessione della shell che avvia Pi. Se usi un profilo della shell, apri un nuovo terminale oppure ricarica il profilo prima di eseguire Pi.
Usa https://api.cometapi.com/v1 come baseUrl in models.json. Non puntare Pi all’URL della dashboard e non omettere il suffisso /v1 per le route compatibili con OpenAI.
Controlla la tua versione di Node.js con node --version. Il pacchetto Pi richiede Node.js >=22.19.0.
Usa la voce provider il cui campo api corrisponde alla route supportata dal tuo modello. openai-responses usa l’API Responses, mentre openai-completions usa Chat Completions.
Pi viene eseguito con i permessi dell’utente e del processo che lo hanno avviato. Esegui Pi all’interno di un container o di una sandbox quando hai bisogno di limiti più rigidi su file, processi, accesso alla rete o credenziali.

​
Risorse correlate