@earendil-works/pi-coding-agent menyediakan CLI agen coding interaktif dengan alur kerja file, shell, edit, write, session, print, JSON, RPC, dan SDK. Pi dapat memuat provider kustom dari ~/.pi/agent/models.json, sehingga Anda dapat menambahkan CometAPI sebagai entri provider yang kompatibel dengan OpenAI tanpa mengubah source code Pi.
Referensi resmi:
Ketersediaan model berubah dari waktu ke waktu. Ganti
your-model-id dengan model ID yang tersedia dari halaman Model CometAPI.Prasyarat
- Node.js
>=22.19.0 - npm
- Akun CometAPI dengan API key aktif dari dashboard
- Pi terpasang dari paket npm resmi
Memahami izin runtime
Pi berjalan dengan izin dari pengguna dan proses yang menjalankannya. Jalankan Pi di direktori proyek tempat Anda ingin Pi bekerja, pertahankan jalur rollback seperti git, dan gunakan container atau sandbox jika Anda memerlukan batasan yang lebih kuat untuk filesystem, proses, jaringan, atau kredensial.Konfigurasikan provider
1
Instal Pi
Instal Pi secara global dengan npm:Konfirmasikan bahwa CLI tersedia:
2
Atur kunci API CometAPI Anda
Simpan kunci API CometAPI Anda di variabel lingkungan Tambahkan perintah export ke profil shell Anda jika ingin tetap tersimpan di seluruh sesi terminal. Jangan commit kunci API ke version control.
COMETAPI_KEY:3
Tambahkan provider CometAPI ke models.json
Buat Gunakan
~/.pi/agent/models.json jika belum ada. Jika file tersebut sudah berisi provider, gabungkan entri cometapi-responses dan cometapi-chat ke objek providers yang sudah ada:cometapi-responses untuk model atau workflow yang memerlukan OpenAI Responses API. Gunakan cometapi-chat untuk model yang kompatibel dengan OpenAI Chat Completions. Pi me-resolve $COMETAPI_KEY saat waktu request. Simpan kunci API di lingkungan Anda atau di workflow secrets Anda sendiri.4
Verifikasi kedua provider
Tampilkan model yang dapat dilihat Pi untuk provider Responses:Jalankan prompt one-shot singkat dengan provider Responses:Tampilkan model yang dapat dilihat Pi untuk provider Chat Completions:Jalankan prompt one-shot singkat dengan provider Chat Completions:Untuk penggunaan interaktif, mulai Pi di project Anda dan pilih provider serta model CometAPI dengan
/model. Jika Anda mengedit models.json selama sesi interaktif, buka /model lagi agar Pi memuat ulang entri model kustom.Pemecahan masalah
Pi tidak menampilkan model CometAPI
Pi tidak menampilkan model CometAPI
Pastikan bahwa
~/.pi/agent/models.json adalah JSON yang valid dan setiap entri provider berada di dalam objek tingkat atas providers. Jalankan pi --list-models cometapi-responses atau pi --list-models cometapi-chat setelah menyimpan file.Pi melaporkan bahwa tidak ada API key yang tersedia
Pi melaporkan bahwa tidak ada API key yang tersedia
Pastikan bahwa
COMETAPI_KEY diatur dalam sesi shell yang sama yang menjalankan Pi. Jika Anda menggunakan profil shell, buka terminal baru atau source profil tersebut sebelum menjalankan Pi.Request gagal karena base URL
Request gagal karena base URL
Gunakan
https://api.cometapi.com/v1 sebagai baseUrl di models.json. Jangan arahkan Pi ke URL dashboard atau hilangkan sufiks /v1 untuk rute yang kompatibel dengan OpenAI.Pi gagal sebelum mengirim request model
Pi gagal sebelum mengirim request model
Periksa versi Node.js Anda dengan
node --version. Paket Pi memerlukan Node.js >=22.19.0.Model berfungsi di satu rute tetapi tidak di rute lainnya
Model berfungsi di satu rute tetapi tidak di rute lainnya
Gunakan entri provider yang field
api-nya sesuai dengan rute yang didukung model Anda. openai-responses menggunakan API Responses, sedangkan openai-completions menggunakan Chat Completions.Pi memiliki akses lebih banyak dari yang diharapkan
Pi memiliki akses lebih banyak dari yang diharapkan
Pi berjalan dengan izin dari pengguna dan proses yang meluncurkannya. Jalankan Pi di dalam container atau sandbox saat Anda memerlukan batasan yang lebih kuat untuk file, proses, akses jaringan, atau kredensial.