Thiết lập công cụ AI

Magpie

Cấu hình Magpie làm cổng vào model của Felo API Platform để gateway cục bộ cung cấp model cho Codex, Claude Code và các agent khác.

Dùng hướng dẫn này nếu bạn đang dùng Magpie — ứng dụng trên thanh menu với gateway cục bộ, gom model của mọi nhà cung cấp vào một danh sách chung cho các agent lập trình — và muốn thêm model của Felo API Platform vào danh sách đó. Magpie chạy gateway tại 127.0.0.1:3425 và ghi lại cấu hình của từng agent để agent gọi qua nó, nên agent không bao giờ cần biết khoá hay địa chỉ của Felo.

Trước khi bắt đầu

Bạn cần một khoá của Felo API Platform. Cùng một khoá dùng cho các giao thức model, các client agent và các API Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page và SuperAgent.

export FELO_API_KEY="YOUR_API_KEY"

Cài Magpie nếu chưa có:

curl -fsSL https://usemagpie.ai/install.sh | sh

Thêm Felo làm provider

Một khoá Felo phục vụ cả Chat Completions, Responses và Anthropic Messages. Hãy truyền cho Magpie mọi địa chỉ mà nó có thể dùng:

magpie provider add felo \
  url=https://openapi.felo.ai/api/v1 \
  responses=https://openapi.felo.ai/api/v1 \
  anthropic=https://openapi.felo.ai/api \
  key="$FELO_API_KEY"

Trong ứng dụng, Providers → Add provider nhận đúng những thông tin đó: tên felo, khoá và base tương thích OpenAI https://openapi.felo.ai/api/v1. Với provider tương thích Anthropic, dùng https://openapi.felo.ai/api.

Ngay khi lưu khoá, Magpie sẽ hỏi Felo danh sách model. Chúng xuất hiện trong bộ chọn của mọi agent dưới dạng felo/<model-id>.

magpie provider models felo   # lấy lại danh sách của Felo
magpie models                 # những gì agent có thể chọn, gồm cả felo/<model>

Chọn model Felo trong agent

magpie claude felo/claude-sonnet-5-5
magpie codex felo/gpt-5.6-sol

Bạn cũng có thể chọn ở trang Agents. Vì Felo hỗ trợ cả ba giao thức, mỗi agent vẫn giữ giao thức của mình — Claude Code dùng Anthropic Messages, Codex dùng Responses — và cả hai đều đi tới Felo.

Các trường của client

Trường	Giá trị
Tên / id provider	`felo`
Base OpenAI Chat Completions	`https://openapi.felo.ai/api/v1`
Base OpenAI Responses	`https://openapi.felo.ai/api/v1`
Base Anthropic Messages	`https://openapi.felo.ai/api`
API key	`FELO_API_KEY` của bạn
Model	`felo/claude-sonnet-5-5`

Kiểm tra cấu hình

magpie provider test felo

Magpie gửi một yêu cầu nhỏ cho từng giao thức và báo độ trễ. Sau đó đặt một câu hỏi ngắn cho agent đang chọn model felo/; có câu trả lời nghĩa là đường đi agent → gateway Magpie → Felo đã thông.

Xử lý sự cố

Vấn đề	Cần kiểm tra
Không thấy model nào dưới `felo`	Kiểm tra khoá rồi chạy `magpie provider models felo`
`Model not found`	Viết `felo/<model-id>` đúng như `magpie models` hiển thị
Xác thực thất bại	Nhập lại khoá bằng `magpie provider key felo <key>`
Gọi Anthropic thất bại	Base phải là `https://openapi.felo.ai/api`, không có `/v1`
Codex bỏ qua model	Khởi động lại Codex; nó đọc danh sách model khi khởi chạy