Skip to main content
Pi — це проєкт Pi Agent Harness. Його пакет @earendil-works/pi-coding-agent надає інтерактивний CLI coding agent із робочими процесами file, shell, edit, write, session, print, JSON, RPC та SDK. Pi може завантажувати власні provider з ~/.pi/agent/models.json, тож ви можете додати CometAPI як записи OpenAI-compatible provider без змін у вихідному коді Pi. Офіційні посилання:
Доступність моделей змінюється з часом. Замініть your-model-id на доступний model ID зі сторінки моделей CometAPI.

Передумови

  • Node.js >=22.19.0
  • npm
  • Обліковий запис CometAPI з активним API key з dashboard
  • Pi, встановлений з офіційного npm package

Розуміння дозволів середовища виконання

Pi працює з дозволами користувача та процесу, який його запускає. Запускайте Pi в каталозі проєкту, над яким він має працювати, зберігайте можливість відкату, наприклад через git, і використовуйте container або sandbox, якщо вам потрібні суворіші межі для файлової системи, процесів, мережі чи облікових даних.

Налаштуйте provider

1

Установіть Pi

Установіть Pi глобально за допомогою npm:
Підтвердьте, що CLI доступний:
2

Установіть свій API key CometAPI

Збережіть свій API key CometAPI у змінній середовища COMETAPI_KEY:
Додайте команду export до профілю вашої оболонки, якщо хочете, щоб вона зберігалася між сесіями термінала. Не комітьте API key у систему контролю версій.
3

Додайте providers CometAPI до models.json

Створіть ~/.pi/agent/models.json, якщо він не існує. Якщо файл уже містить providers, об’єднайте записи cometapi-responses і cometapi-chat в наявний об’єкт providers:
Використовуйте cometapi-responses для моделей або workflow, яким потрібен OpenAI Responses API. Використовуйте cometapi-chat для моделей, сумісних з OpenAI Chat Completions. Pi визначає $COMETAPI_KEY під час виконання запиту. Зберігайте API key у своєму середовищі або у власному workflow для секретів.
4

Перевірте обидва providers

Перелічіть моделі, які Pi бачить для provider Responses:
Виконайте короткий одноразовий Prompt із provider Responses:
Перелічіть моделі, які Pi бачить для provider Chat Completions:
Виконайте короткий одноразовий Prompt із provider Chat Completions:
Для інтерактивного використання запустіть Pi у своєму проєкті та виберіть provider CometAPI і модель за допомогою /model. Якщо ви редагуєте models.json під час інтерактивної сесії, знову відкрийте /model, щоб Pi перезавантажив користувацькі записи моделей.

Усунення несправностей

Переконайтеся, що ~/.pi/agent/models.json є коректним JSON і що кожен запис provider розміщений у верхньорівневому об’єкті providers. Після збереження файлу виконайте pi --list-models cometapi-responses або pi --list-models cometapi-chat.
Переконайтеся, що COMETAPI_KEY задано в тій самій сесії shell, з якої запускається Pi. Якщо ви використовуєте профіль shell, відкрийте новий термінал або завантажте профіль перед запуском Pi.
Використовуйте https://api.cometapi.com/v1 як baseUrl у models.json. Не вказуйте для Pi URL інформаційної панелі та не пропускайте суфікс /v1 для OpenAI-сумісних маршрутів.
Перевірте свою версію Node.js за допомогою node --version. Пакет Pi потребує Node.js >=22.19.0.
Використовуйте запис provider, у якого поле api відповідає маршруту, який підтримує ваша модель. openai-responses використовує Responses API, тоді як openai-completions використовує Chat Completions.
Pi працює з дозволами користувача й процесу, які його запустили. Запускайте Pi всередині контейнера або sandbox, коли вам потрібні суворіші межі для файлів, процесів, мережевого доступу або облікових даних.

Пов’язані ресурси