aicentosFx
Dùng aicentos trong Fx —— thêm kết nối mô hình tùy chỉnh qua settings.json cấp người dùng
Cập nhật lần cuối:
Fx là agent lập trình của Vercel Labs, viết bằng Zig thành một binary gốc duy nhất, độc lập mô hình. Kết nối mô hình tùy chỉnh được định nghĩa trong ~/.fx/settings.json cấp người dùng, trỏ base URL về aicentos là được.
Nói trước một cái bẫy dễ dính: .fx.json trong thư mục gốc dự án là chuyện khác, nó cố ý không cho phép phần lớn các trường (kể cả mô hình), để tránh repo được clone về làm thay mô hình hoặc endpoint của bạn. Endpoint tùy chỉnh bắt buộc phải ghi trong ~/.fx/settings.json, ghi trong .fx.json sẽ không có hiệu lực.
Chuẩn bị
Trước tiên, tạo một Key riêng cho Fx tại trang "API Key" trong Console (khuyến nghị đặt tên fx để dễ theo dõi mức sử dụng):
- Console: https://aicentos.com
- Tạo Key: https://aicentos.com/keys
- Nạp tiền khi hết số dư: https://aicentos.com/wallet
Xác nhận đã cài Fx:
curl -fsSL https://fx.sh/setup.sh | bash
fx --versionCấu hình cần điền
| Trường | Giá trị |
|---|---|
| File cấu hình | ~/.fx/settings.json |
| Base URL | https://aicentos.com/v1 |
| API Key | Key tạo trong Console |
| Mô hình | tên mô hình trong "Model Square" của Console |
Các bước thiết lập
1. Sửa thiết lập cấp người dùng
Trong ~/.fx/settings.json, đăng ký một kết nối theo định dạng "kết nối mô hình tùy chỉnh". Cấu trúc trường của đối tượng kết nối lấy tài liệu chính thức làm chuẩn:
- Trang tài liệu: https://fx.sh/docs
- README: https://github.com/vercel-labs/fx
Điền địa chỉ API trong kết nối thành:
https://aicentos.com/v1API Key điền cái đã tạo trong Console, tên mô hình lấy "Model Square" của Console làm chuẩn.
2. Chỉ định dùng kết nối này
Fx cho phép khi khởi động chỉ định provider và mô hình:
fx provider local FX_MODEL=gpt-4o fx ask "Trả lời trong một câu: 1+1 bằng mấy"Cũng có thể chỉ định qua biến môi trường:
export FX_MODEL="gpt-4o"3. Xác nhận provider hiện tại
Fx ghi nhớ lựa chọn theo provider, lần khởi động sau tiếp tục dùng provider lần trước.
Kiểm tra
Trước dùng một prompt không có tác dụng phụ để xác minh kết nối:
fx ask "Trả lời trong một câu: 1+1 bằng mấy"Trả về bình thường nghĩa là kết nối thành công. Nếu báo lỗi xác thực, ưu tiên kiểm tra base URL có /v1 không, API Key có khoảng trắng thừa không.
Lưu ý
- Đừng sửa
.fx.json. File cấp dự án chỉ cho phép vài trường nhưprovider_order,provider_strict, không có trườngmodel, cũng không dùng để cấu hình endpoint tùy chỉnh. provider_order/provider_strictlà tham số định tuyến của Vercel AI Gateway, chỉ có hiệu lực với yêu cầu Gateway, kết nối mô hình tùy chỉnh sẽ bỏ qua chúng, đừng trông chờ dùng chúng để chuyển upstream.- Hỗ trợ của Fx chính thức cho kết nối mô hình tùy chỉnh vẫn đang tiếp tục hoàn thiện, bản đầu có thể cần build mới hơn mới nhận diện được; sau khi nâng cấp, chạy thử một lần lệnh kiểm tra ở trên rồi mới dùng chính thức.
- Script cài binary này sẽ tải từ mạng, trước khi chạy hãy tự xác nhận nguồn đáng tin cậy.
Liên kết liên quan
- Trang chủ dự án: https://github.com/vercel-labs/fx