Các phần cơ sở kiến thức ▾

Điều hướng

▸ Bắt đầu tại đây Theo vai trò

Danh mục

Công cụ 36
Bảng thuật ngữ 12

pi.tag

Pi + JoinGonka Gateway — tác nhân terminal với suy luận giá rẻ

Pi là một coding-agent terminal tối giản, một trong những hệ thống mã nguồn mở phát triển nhanh nhất năm 2026. Các nhà cung cấp trong đó được mô tả khai báo trong ~/.pi/agent/models.json, và bất kỳ endpoint nào hỗ trợ OpenAI Completions hoặc Anthropic Messages đều hoạt động — nghĩa là JoinGonka Gateway có thể kết nối theo cả hai cách. Các mô hình của mạng lưới phi tập trung Gonka rẻ hơn hàng trăm lần so với giá của các nhà cung cấp, và 10M token ban đầu là miễn phí.

Cách nhanh: trình cài đặt

Cách nhanh nhất là sử dụng trình cài đặt của chúng tôi:

npx @joingonka/setup --tool pi

Nó sẽ ghi cấu hình nhà cung cấp với các mô hình mạng hiện tại vào ~/.pi/agent/models.json, đặt mô hình mặc định trong ~/.pi/agent/settings.json (không can thiệp vào lựa chọn của người khác) và kiểm tra bằng yêu cầu trực tiếp xem cổng có chấp nhận khóa và mô hình hay không. Khóa được lưu dưới dạng literal trong tệp cấu hình với quyền 0600 — bạn không cần phải export biến môi trường.

Thiết lập thủ công: nhà cung cấp trong models.json

Nhận khóa jg-… khi đăng ký và thêm nhà cung cấp vào ~/.pi/agent/models.json:

baseUrlhttps://gate.joingonka.ai/v1
apiopenai-completions
apiKeykhóa jg-… của bạn dưới dạng literal. Pi hiểu cả liên kết $VAR/${VAR}!command, nhưng literal hoạt động mà không cần export biến — hãy giữ tệp với quyền 0600
modelsmảng: id, name, contextWindow, maxTokens

Các giá trị chính xác cho các mô hình mạng: deepseek-ai/DeepSeek-V4-Flash-0731 — contextWindow 380000, maxTokens 32768; moonshotai/Kimi-K2.6MiniMaxAI/MiniMax-M2.7 — maxTokens 8192. Các giá trị mặc định của Pi (128000/16384) không khớp với giới hạn thực tế của mạng, vì vậy hãy đặt rõ cả hai trường. Mô hình mặc định nằm trong MỘT tệp KHÁC — ~/.pi/agent/settings.json, các trường defaultProviderdefaultModel. Kiểm tra: pi --list-models sẽ hiển thị các mô hình đã thêm.

Cách Anthropic thay thế

Gateway cũng cung cấp Anthropic Messages: nhà cung cấp với api: "anthropic-messages"baseUrl: "https://gate.joingonka.ai" — không bao gồm đường dẫn /v1/messages, máy khách sẽ tự điền vào. Đối với công việc hàng ngày, cách OpenAI là đủ; biến thể Anthropic hữu ích nếu các tiện ích mở rộng Pi của bạn được thiết kế cho định dạng Messages.

Lưu ý về bảo mật

Pi mặc định không có lớp cấp quyền hoàn chỉnh: tác nhân thực hiện lệnh trong terminal mà không cần xác nhận từng bước như các hệ thống nặng hơn. Hãy chạy nó trong môi trường sandbox — container hoặc tài khoản riêng biệt — đặc biệt là với các tác vụ đa bước tự động. Đây là tính năng của bản thân Pi, không phải của gateway.

Nên chọn mô hình nào và chi phí ra sao

Cả ba mô hình mạng lưới đều hỗ trợ tool calling và streaming. Đối với các phiên dài và kho lưu trữ lớn — DeepSeek V4 Flash (ngữ cảnh dài nhất của mạng, đầu ra lên tới 32768). Kimi K2.6 mạnh về tác vụ đại lý đa bước, MiniMax M2.7 là lựa chọn linh hoạt. Biểu giá đồng nhất, giá thực tế có trong bảng giá của gateway.

Pi kết nối với JoinGonka Gateway bằng một mục nhập trong ~/.pi/agent/models.json: baseUrl gate.joingonka.ai/v1, api openai-completions, khóa dạng literal, các mô hình với contextWindow/maxTokens chính xác. Nhanh hơn nữa là dùng npx @joingonka/setup --tool pi. Chạy tác nhân trong môi trường sandbox và bắt đầu với 10M token miễn phí.

Muốn tìm hiểu thêm?

Khám phá các phần khác hoặc bắt đầu kiếm GNK ngay bây giờ.

pi.cta.text →