@earendil-works/pi-coding-agent paketi; dosya, shell, düzenleme, yazma, oturum, yazdırma, JSON, RPC ve SDK iş akışlarıyla etkileşimli bir coding agent CLI sağlar. Pi, ~/.pi/agent/models.json içinden özel provider’ları yükleyebilir; böylece Pi kaynak kodunu değiştirmeden CometAPI’yi OpenAI-compatible provider girdileri olarak ekleyebilirsiniz.
Resmi başvurular:
Model kullanılabilirliği zaman içinde değişir.
your-model-id değerini CometAPI Models page üzerinde bulunan kullanılabilir bir model ID ile değiştirin.Ön koşullar
- Node.js
>=22.19.0 - npm
- dashboard üzerinden alınmış etkin bir API key’e sahip bir CometAPI hesabı
- Resmi npm paketinden kurulmuş Pi
Çalışma zamanı izinlerini anlayın
Pi, onu başlatan kullanıcı ve sürecin izinleriyle çalışır. Pi’yi üzerinde çalışmasını istediğiniz proje dizininde başlatın, git gibi bir geri alma yolu bulundurun ve daha güçlü dosya sistemi, süreç, ağ veya kimlik bilgisi sınırlarına ihtiyacınız varsa bir container ya da sandbox kullanın.Sağlayıcıyı yapılandırın
1
Pi'yi yükleyin
Pi’yi npm ile global olarak yükleyin:CLI’nin kullanılabilir olduğunu doğrulayın:
2
CometAPI API anahtarınızı ayarlayın
CometAPI API anahtarınızı Terminal oturumları arasında kalıcı olmasını istiyorsanız export komutunu shell profilinize ekleyin. API anahtarlarını sürüm kontrolüne commit etmeyin.
COMETAPI_KEY ortam değişkeninde saklayın:3
models.json dosyasına CometAPI sağlayıcılarını ekleyin
~/.pi/agent/models.json yoksa oluşturun. Dosya zaten sağlayıcılar içeriyorsa, cometapi-responses ve cometapi-chat girdilerini mevcut providers nesnesiyle birleştirin:cometapi-responses kullanın. OpenAI Chat Completions ile uyumlu modeller için cometapi-chat kullanın. Pi, istek sırasında $COMETAPI_KEY değerini çözümler. API anahtarını ortamınızda veya kendi secrets iş akışınızda tutun.4
Her iki sağlayıcıyı da doğrulayın
Pi’nin Responses sağlayıcısı için görebildiği modelleri listeleyin:Responses sağlayıcısıyla kısa bir tek seferlik Prompt çalıştırın:Pi’nin Chat Completions sağlayıcısı için görebildiği modelleri listeleyin:Chat Completions sağlayıcısıyla kısa bir tek seferlik Prompt çalıştırın:Etkileşimli kullanım için projenizde Pi’yi başlatın ve
/model ile CometAPI sağlayıcısını ve modelini seçin. Etkileşimli bir oturum sırasında models.json dosyasını düzenlerseniz, Pi’nin özel model girdilerini yeniden yüklemesi için /model komutunu tekrar açın.Sorun giderme
Pi, CometAPI modelini göstermiyor
Pi, CometAPI modelini göstermiyor
~/.pi/agent/models.json dosyasının geçerli JSON olduğunu ve her provider girişinin üst düzey providers nesnesinin içinde olduğunu doğrulayın. Dosyayı kaydettikten sonra pi --list-models cometapi-responses veya pi --list-models cometapi-chat komutunu çalıştırın.Pi, kullanılabilir bir API anahtarı olmadığını bildiriyor
Pi, kullanılabilir bir API anahtarı olmadığını bildiriyor
COMETAPI_KEY değişkeninin Pi’yi başlatan aynı shell oturumunda ayarlandığını doğrulayın. Bir shell profili kullanıyorsanız, Pi’yi çalıştırmadan önce yeni bir terminal açın veya profili source edin.İstekler base URL nedeniyle başarısız oluyor
İstekler base URL nedeniyle başarısız oluyor
models.json içinde baseUrl olarak https://api.cometapi.com/v1 kullanın. Pi’yi dashboard URL’sine yönlendirmeyin ve OpenAI-compatible route’lar için /v1 son ekini kaldırmayın.Pi, model isteği göndermeden önce başarısız oluyor
Pi, model isteği göndermeden önce başarısız oluyor
Node.js sürümünüzü
node --version ile kontrol edin. Pi paketi Node.js >=22.19.0 gerektirir.Model bir route'ta çalışıyor ama diğerinde çalışmıyor
Model bir route'ta çalışıyor ama diğerinde çalışmıyor
Modelinizin desteklediği route ile
api alanı eşleşen provider girişini kullanın. openai-responses Responses API’yi kullanırken, openai-completions Chat Completions kullanır.Pi'nin beklenenden daha fazla erişimi var
Pi'nin beklenenden daha fazla erişimi var
Pi, onu başlatan kullanıcı ve sürecin izinleriyle çalışır. Dosyalar, süreçler, ağ erişimi veya kimlik bilgileri etrafında daha güçlü sınırlar gerektiğinde Pi’yi bir container ya da sandbox içinde çalıştırın.