Droid

Droid là agent lập trình dòng lệnh do Factory phát hành, hỗ trợ BYOK: đăng ký mô hình tùy chỉnh trong ~/.factory/settings.json, trỏ baseUrl về aicentos là được. Droid yêu cầu cửa sổ ngữ cảnh của mô hình ít nhất 64k, lưu ý khi chọn mô hình.

Chuẩn bịSao chép liên kết neo

Trước tiên, tạo một Key riêng cho Droid tại trang "API Key" trong Console (khuyến nghị đặt tên droid để 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

Cấu hình cần điềnSao chép liên kết neo

Các bước thiết lậpSao chép liên kết neo

1. Thiết lập biến môi trường API KeySao chép liên kết neo

export AICENTOS_API_KEY="sk-API-Key-của-bạn"

Ghi vào ~/.zshrc hoặc ~/.bashrc để lưu lâu dài.

2. Sửa settings.jsonSao chép liên kết neo

Sửa ~/.factory/settings.json, thêm mảng customModels:

{
  "customModels": [
    {
      "model": "gpt-4o",
      "displayName": "GPT-4o (aicentos)",
      "baseUrl": "https://aicentos.com/v1",
      "apiKey": "${AICENTOS_API_KEY}",
      "provider": "generic-chat-completion-api",
      "maxOutputTokens": 8192
    }
  ]
}

Các trường quan trọng:

3. Chọn mô hìnhSao chép liên kết neo

Sau khi khởi động droid, chạy /model, chọn mô hình vừa đăng ký. Sau khi sửa cấu hình, cần khởi động lại droid trong terminal mới file mới được đọc lại.

Kiểm traSao chép liên kết neo

Sau khi chọn mô hình, gửi một yêu cầu đơn giản:

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.

Lưu ýSao chép liên kết neo

• provider khuyến nghị điền generic-chat-completion-api, nó đi giao thức OpenAI Chat Completions, cũng là lựa chọn đúng cho phần lớn kịch bản BYOK. Điền openai sẽ đi Responses API, và ở một số gateway giá trị này sẽ bỏ qua base_url trỏ thẳng đến api.openai.com; điền anthropic thì đi /v1/messages.
• Dọn biến môi trường trước. Nếu trong shell đã export ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL hoặc ANTHROPIC_API_KEY, chúng sẽ ghi đè file cấu hình, khiến yêu cầu vòng qua gateway bạn đã cấu hình. Trước khi kết nối nên unset các biến này.
• Droid đọc đồng thời ~/.factory/settings.json và bản cũ ~/.factory/config.json, file trước có ưu tiên cao hơn. Tên trường bản cũ là dạng snake_case custom_models / model_display_name / base_url / api_key, và không hỗ trợ mở rộng ${VAR_NAME}, khuyến nghị thống nhất dùng settings.json.
• Cửa sổ ngữ cảnh của mô hình ít nhất 64k, mô hình local quá nhỏ có thể hoạt động bất thường.
• Factory chỉ chạy benchmark cho giao diện chính thức Anthropic / OpenAI, tính tương thích của mô hình tùy chỉnh không được bảo đảm; đã biết subagent đôi khi sẽ fallback về giao diện chính thức của Anthropic.
• Thứ tự xử lý sự cố: có thấy mô hình trong /model không → biến môi trường có bị ANTHROPIC_* ghi đè không → baseUrl có /v1 không → số dư có đủ không.

Liên kết liên quanSao chép liên kết neo

• Tài liệu BYOK chính thức: https://docs.factory.ai/model-independence/byok