Tác nhân lập trình
BasicRouter hoạt động với các tác nhân lập trình và công cụ phát triển AI hỗ trợ các điểm cuối API tương thích OpenAI hoặc tương thích Anthropic. Sử dụng các bí danh định tuyến như mwf/coding-auto để BasicRouter có thể định tuyến đến mô hình lập trình tốt nhất sẵn có mà không yêu cầu nhà phát triển thay đổi cấu hình công cụ.
Thiết lập tương thích OpenAI chung
Sử dụng thiết lập này cho Cursor, Codex, Hermes, OpenClaw, Continue, Aider, Cline, các tác nhân dựa trên LangChain, các tác nhân dựa trên LlamaIndex và các runtime tác nhân tương thích OpenAI tùy chỉnh.
export OPENAI_BASE_URL="https://api.basicrouter.ai/api/v1"
export OPENAI_API_KEY="$BASICROUTER_API_KEY"
export OPENAI_MODEL="mwf/coding-auto"Thiết lập tương thích Anthropic chung
Sử dụng thiết lập này cho các máy khách tương thích Claude và các công cụ mong đợi định dạng Anthropic Messages.
export ANTHROPIC_BASE_URL="https://api.basicrouter.ai/api/anthropic"
export ANTHROPIC_API_KEY="$BASICROUTER_API_KEY"
export ANTHROPIC_MODEL="mwf/coding-auto"Mô hình tác nhân được khuyến nghị
| Trường hợp sử dụng | Bí danh khuyến nghị | Yêu cầu |
|---|---|---|
| Lập trình chung | mwf/coding-auto | Gọi công cụ, phát trực tuyến, khả năng lập trình mạnh. |
| Trò chuyện lập trình nhanh | mwf/coding-fast | Độ trễ thấp và phát trực tuyến. |
| Phân tích kho lưu trữ lớn | mwf/coding-long | Ngữ cảnh dài và đầu ra ổn định. |
| Trợ lý lập trình nhạy cảm chi phí | mwf/low-cost | Giá thấp hơn và chất lượng lập trình chấp nhận được. |
| Ảnh chụp màn hình UI / lập trình thị giác | mwf/vision-chat | Đầu vào hình ảnh và đầu ra văn bản. |
Hướng dẫn nhanh Cursor
Sử dụng điểm cuối tương thích OpenAI.
Base URL: https://api.basicrouter.ai/api/v1
API Key: BASICROUTER_API_KEY
Model: mwf/coding-autoCác bước khuyến nghị:
- Mở cài đặt Cursor.
- Thêm hoặc bật cấu hình khóa API tương thích OpenAI.
- Đặt ghi đè OpenAI base URL thành
https://api.basicrouter.ai/api/v1. - Thêm một mô hình tùy chỉnh như
mwf/coding-auto,mwf/coding-fast, hoặcmwf/coding-long. - Sử dụng mô hình hỗ trợ phát trực tuyến và gọi công cụ để có hành vi tác nhân tốt nhất.
Khắc phục sự cố:
| Vấn đề | Khắc phục đề xuất |
|---|---|
| Mô hình không hiển thị | Thêm tên mô hình thủ công như một mô hình tùy chỉnh. |
| Gọi công cụ thất bại | Sử dụng mô hình có tool_calling: true trong trang Mô hình. |
| Phát trực tuyến bị gián đoạn | Thử lại với backoff hoặc sử dụng bí danh định tuyến có dự phòng. |
| Lỗi 401 | Kiểm tra khóa API và base URL. |
| Lỗi mô hình 404 | Xác nhận mô hình được bật cho tài khoản. |
Hướng dẫn nhanh Claude Code
Sử dụng điểm cuối cổng tương thích Anthropic.
export ANTHROPIC_BASE_URL="https://api.basicrouter.ai/api/anthropic"
export ANTHROPIC_API_KEY="$BASICROUTER_API_KEY"
export ANTHROPIC_MODEL="mwf/coding-auto"BasicRouter hỗ trợ đường dẫn tương thích Anthropic này cho Claude Code và khả năng tương thích SDK Anthropic:
POST /api/v1/messagesCác yêu cầu khuyến nghị:
| Yêu cầu | Lý do |
|---|---|
| Cấu trúc yêu cầu tương thích Anthropic Messages | Claude Code mong đợi tin nhắn kiểu Anthropic. |
| Hỗ trợ phát trực tuyến | Claude Code dựa vào trải nghiệm phát trực tuyến. |
| Hỗ trợ gọi công cụ | Bắt buộc cho quy trình lập trình tác nhân. |
| Ngữ cảnh dài | Hữu ích cho các tác vụ cấp kho lưu trữ. |
| Dự phòng ổn định | Hữu ích cho các phiên lập trình dài. |
Hướng dẫn nhanh Codex
Sử dụng BasicRouter như một nhà cung cấp mô hình tương thích OpenAI tùy chỉnh.
Cấu hình nhà cung cấp ví dụ:
[model_providers.basicrouter]
name = "BasicRouter"
base_url = "https://api.basicrouter.ai/api/v1"
env_key = "BASICROUTER_API_KEY"
wire_api = "responses"
model_provider = "basicrouter"
model = "mwf/coding-auto"Biến môi trường:
export BASICROUTER_API_KEY="br_xxx"Các mô hình khuyến nghị:
| Mô hình | Trường hợp sử dụng |
|---|---|
mwf/coding-auto | Mô hình tác nhân lập trình mặc định. |
mwf/coding-long | Ngữ cảnh kho lưu trữ lớn. |
mwf/coding-fast | Lặp nhanh và các thay đổi nhỏ. |
Khắc phục sự cố:
| Vấn đề | Khắc phục đề xuất |
|---|---|
| Lỗi xác thực | Xác nhận env_key trỏ đến BASICROUTER_API_KEY. |
| Không tìm thấy mô hình | Thêm bí danh trong Bảng điều khiển BasicRouter hoặc sử dụng ID mô hình trực tiếp. |
| Lỗi API Responses | Chỉ sử dụng wire_api = "responses" cho các mô hình và điểm cuối hỗ trợ Responses. |
| Mô hình chỉ hỗ trợ Chat Completions | Chuyển sang wire API tương thích chat nếu máy khách hỗ trợ. |
Hướng dẫn nhanh Hermes
Sử dụng điểm cuối tương thích OpenAI trừ khi triển khai Hermes của bạn được cấu hình cho giao thức khác.
export OPENAI_BASE_URL="https://api.basicrouter.ai/api/v1"
export OPENAI_API_KEY="$BASICROUTER_API_KEY"
export OPENAI_MODEL="mwf/coding-auto"Chính sách mô hình khuyến nghị:
| Tải công việc Hermes | Mô hình |
|---|---|
| Tạo mã chung | mwf/coding-auto |
| Thực thi tác vụ độ trễ thấp | mwf/coding-fast |
| Quét kho ngữ cảnh dài | mwf/coding-long |
| Tác vụ nền nhạy cảm chi phí | mwf/low-cost |
Hướng dẫn nhanh OpenClaw
Sử dụng điểm cuối tương thích OpenAI cho cấu hình runtime tác nhân kiểu OpenAI.
export OPENAI_BASE_URL="https://api.basicrouter.ai/api/v1"
export OPENAI_API_KEY="$BASICROUTER_API_KEY"
export OPENAI_MODEL="mwf/coding-auto"Nếu OpenClaw hỗ trợ nhiều nhà cung cấp, cấu hình BasicRouter như một nhà cung cấp tương thích OpenAI và sử dụng bí danh định tuyến BasicRouter để chọn mô hình.
{
"provider": "openai-compatible",
"base_url": "https://api.basicrouter.ai/api/v1",
"api_key_env": "BASICROUTER_API_KEY",
"model": "mwf/coding-auto"
}Danh sách kiểm tra khả năng tương thích tác nhân
| Khả năng | Bắt buộc cho |
|---|---|
| Phát trực tuyến | Trải nghiệm terminal/trình soạn thảo tốt. |
| Gọi công cụ | Lập trình tác nhân, chỉnh sửa tệp, thực thi lệnh. |
| Ngữ cảnh dài | Kho lưu trữ lớn và thay đổi nhiều tệp. |
| Đầu ra có cấu trúc | Lập kế hoạch, phân tách tác vụ, quy trình tự động. |
| Đầu vào hình ảnh | Phân tích ảnh chụp màn hình UI và quy trình thiết kế thành mã. |
| Dự phòng | Ổn định sản xuất và tác vụ dài. |