Sử dụng Pi với CometAPI

Pi là dự án Pi Agent Harness. Gói @earendil-works/pi-coding-agent của nó cung cấp một CLI coding agent tương tác với các quy trình làm việc file, shell, edit, write, session, print, JSON, RPC và SDK. Pi có thể tải các provider tùy chỉnh từ ~/.pi/agent/models.json, vì vậy bạn có thể thêm CometAPI dưới dạng các mục OpenAI-compatible provider mà không cần thay đổi mã nguồn của Pi. Tài liệu tham khảo chính thức:

Khả dụng của model thay đổi theo thời gian. Hãy thay your-model-id bằng một model ID khả dụng từ trang Models của CometAPI.

Điều kiện tiên quyết

Node.js >=22.19.0
npm
Một tài khoản CometAPI có API key đang hoạt động từ bảng điều khiển
Pi được cài đặt từ gói npm chính thức

Hiểu về quyền runtime

Pi chạy với các quyền của người dùng và tiến trình khởi chạy nó. Hãy khởi động Pi trong thư mục dự án mà bạn muốn nó làm việc, duy trì một phương án hoàn tác như git, và sử dụng container hoặc sandbox nếu bạn cần ranh giới chặt chẽ hơn cho filesystem, process, network hoặc credentials.

Cấu hình provider

Cài đặt Pi

Cài đặt Pi toàn cục bằng npm:

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

Xác nhận rằng CLI khả dụng:

pi --version

Thiết lập API key CometAPI của bạn

Lưu API key CometAPI của bạn trong biến môi trường COMETAPI_KEY:

read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
export COMETAPI_KEY

Thêm lệnh export vào shell profile của bạn nếu muốn nó được giữ lại giữa các phiên terminal. Không commit API key vào hệ thống quản lý phiên bản.

Thêm provider CometAPI vào models.json

Tạo ~/.pi/agent/models.json nếu chưa tồn tại. Nếu tệp đã chứa các provider, hãy gộp các mục cometapi-responses và cometapi-chat vào object providers hiện có:

{
  "providers": {
    "cometapi-responses": {
      "name": "CometAPI Responses",
      "baseUrl": "https://api.cometapi.com/v1",
      "api": "openai-responses",
      "apiKey": "$COMETAPI_KEY",
      "models": [
        {
          "id": "your-model-id",
          "name": "CometAPI Responses model"
        }
      ]
    },
    "cometapi-chat": {
      "name": "CometAPI Chat Completions",
      "baseUrl": "https://api.cometapi.com/v1",
      "api": "openai-completions",
      "apiKey": "$COMETAPI_KEY",
      "models": [
        {
          "id": "your-model-id",
          "name": "CometAPI Chat model"
        }
      ]
    }
  }
}

Sử dụng cometapi-responses cho các model hoặc workflow yêu cầu OpenAI Responses API. Sử dụng cometapi-chat cho các model tương thích với OpenAI Chat Completions. Pi phân giải $COMETAPI_KEY tại thời điểm gửi request. Giữ API key trong môi trường của bạn hoặc trong quy trình quản lý secrets riêng của bạn.

Xác minh cả hai provider

Liệt kê các model mà Pi có thể nhìn thấy cho provider Responses:

pi --list-models cometapi-responses

Chạy một prompt one-shot ngắn với provider Responses:

pi --provider cometapi-responses --model your-model-id -p "Reply with one short sentence confirming the Responses connection."

Liệt kê các model mà Pi có thể nhìn thấy cho provider Chat Completions:

pi --list-models cometapi-chat

Chạy một prompt one-shot ngắn với provider Chat Completions:

pi --provider cometapi-chat --model your-model-id -p "Reply with one short sentence confirming the Chat Completions connection."

Để sử dụng tương tác, khởi động Pi trong project của bạn và chọn provider CometAPI cùng model bằng /model. Nếu bạn chỉnh sửa models.json trong một phiên tương tác, hãy mở lại /model để Pi tải lại các mục model tùy chỉnh.

Khắc phục sự cố

Pi không hiển thị model CometAPI

Xác nhận rằng ~/.pi/agent/models.json là JSON hợp lệ và mỗi mục provider nằm bên trong đối tượng providers ở cấp cao nhất. Chạy pi --list-models cometapi-responses hoặc pi --list-models cometapi-chat sau khi lưu tệp.

Pi báo rằng không có API key khả dụng

Xác nhận rằng COMETAPI_KEY được thiết lập trong cùng phiên shell dùng để khởi chạy Pi. Nếu bạn sử dụng hồ sơ shell, hãy mở terminal mới hoặc nạp hồ sơ đó trước khi chạy Pi.

Yêu cầu thất bại do base URL

Sử dụng https://api.cometapi.com/v1 làm baseUrl trong models.json. Không trỏ Pi tới URL dashboard hoặc bỏ hậu tố /v1 đối với các route tương thích OpenAI.

Pi thất bại trước khi gửi yêu cầu model

Kiểm tra phiên bản Node.js của bạn bằng node --version. Gói Pi yêu cầu Node.js >=22.19.0.

Model hoạt động trên một route nhưng không hoạt động trên route còn lại

Sử dụng mục provider có trường api khớp với route mà model của bạn hỗ trợ. openai-responses sử dụng Responses API, trong khi openai-completions sử dụng Chat Completions.

Pi có nhiều quyền truy cập hơn dự kiến

Pi chạy với quyền của người dùng và tiến trình đã khởi chạy nó. Hãy chạy Pi trong container hoặc sandbox khi bạn cần ranh giới chặt chẽ hơn đối với tệp, tiến trình, truy cập mạng hoặc thông tin xác thực.

Tổng quan

Tác nhân lập trình AI

Tác nhân AI

Ứng dụng chat AI

Dịch thuật và ngôn ngữ

Nền tảng tự động hóa

Quan sát và đánh giá

Framework AI

Điều kiện tiên quyết

Hiểu về quyền runtime

Cấu hình provider

Khắc phục sự cố

Tài nguyên liên quan

​Điều kiện tiên quyết

​Hiểu về quyền runtime

​Cấu hình provider

​Khắc phục sự cố

​Tài nguyên liên quan

Điều kiện tiên quyết

Hiểu về quyền runtime

Cấu hình provider

Khắc phục sự cố

Tài nguyên liên quan