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

Cách ngắn 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 nhà cung cấp với các model mạng lưới hiện tại vào ~/.pi/agent/models.json, đặt model mặc định trong ~/.pi/agent/settings.json (nó không chặn model bạn đã tự chọn — chỉ có cờ --model minimax|deepseek|glm rõ ràng mới thay đổi điều đó) và kiểm tra bằng yêu cầu trực tiếp xem gateway có chấp nhận khóa và model hay không. Nếu thư mục cài đặt được chuyển bằng biến PI_CODING_AGENT_DIR, trình cài đặt sẽ ghi vào đó. Khóa được đặt dưới dạng literal trong file cấu hình với quyền 0600 — bạn không cần xuất biến môi trường.

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

Giá trị đúng cho các model trong mạng: deepseek-ai/DeepSeek-V4-Flash-0731 — contextWindow 380000, maxTokens 32768; MiniMaxAI/MiniMax-M2.7 — contextWindow 200000, maxTokens 8192; zai-org/GLM-5.3-Flash — contextWindow 390000, maxTokens 8192. 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, nên hãy đặt cả hai trường một cách rõ ràng. Model mặc định nằm ở tệp KHÁC — ~/.pi/agent/settings.json, các trường defaultProvider và defaultModel. Kiểm tra: pi --list-models phải hiển thị các model đã thêm.

Gateway cũng cung cấp Anthropic Messages: nhà cung cấp với api: "anthropic-messages" và 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.

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.

Cả ba mô hình của mạng lưới đều hỗ trợ tool calling và streaming. Đối với các phiên làm việc dài và kho lưu trữ lớn — DeepSeek V4 Flash (một trong những mô hình có ngữ cảnh dài nhất mạng lưới và đầu ra lên đến 32768). MiniMax M2.7 là lựa chọn đa năng, GLM-5.3 Flash là mô hình reasoning với ngữ cảnh dài nhất mạng lưới (390K): nó suy luận trước khi trả lời, vì vậy đừng đặt maxTokens của nó quá thấp. Mức giá thống nhất, giá trực tiếp nằm trong bảng giá gateway.

Nếu sự tối giản của Pi là chưa đủ, hãy xem qua fork của nó là omp (Oh My Pi): cùng một ý tưởng về các nhà cung cấp khai báo, nhưng với các vai trò mô hình, máy chủ ngôn ngữ và các sub-agent. File cấu hình của chúng khác nhau, vì vậy omp được thiết lập riêng biệt.