Craft Agent

Kết nối LLM của Craft Agent hỗ trợ loại Custom, mô tả chính thức là "URL bất kỳ, endpoint tương thích OpenAI hoặc tương thích Anthropic bất kỳ". Trỏ Base URL về aicentos, cả bản desktop lẫn craft-cli đều dùng được.

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

Trước tiên, tạo một Key chuyên dụng cho Craft Agent trong Console (khuyến nghị đặt tên craft-agent) để dễ xem mức sử dụng theo Key.

• Console: https://aicentos.com
• Tạo Key: https://aicentos.com/keys
• Nạp tiền Ví: https://aicentos.com/wallet

Cài bản desktop:

curl -fsSL https://thecraftagents.com/install-app.sh | bash

Cũng hỗ trợ headless server và cách dùng thuần dòng lệnh.

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

Bản desktop: mở kết nối LLM trong phần cài đặt, thêm một kết nối mới, chọn loại Custom, điền theo bảng trên.

Cách viết tương đương trên dòng lệnh:

export AICENTOS_API_KEY="sk-API-Key-của-bạn"
craft-cli run --provider openai \
  --base-url https://aicentos.com/v1 \
  --api-key "$AICENTOS_API_KEY" \
  --model tên-mô-hình-của-bạn \
  "Xin chào"

Cũng có thể sửa trực tiếp file cấu hình ~/.craft-agent/config.json:

{
  "llmConnections": [
    {
      "providerType": "pi_compat",
      "baseUrl": "https://aicentos.com/v1",
      "customEndpoint": { "api": "openai-completions" },
      "models": [{ "id": "tên-mô-hình-của-bạn" }],
      "defaultModel": "tên-mô-hình-của-bạn"
    }
  ]
}

Khóa không ghi vào cấu hình dạng văn bản thuần, mà lưu ở credentials.enc trong cùng thư mục. Chỉ cần điền một lần qua giao diện, đừng sửa tay file này.

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

craft-cli run --provider openai \
  --base-url https://aicentos.com/v1 \
  --api-key "$AICENTOS_API_KEY" \
  --model tên-mô-hình-của-bạn \
  "Giới thiệu bản thân trong một câu"

Trả về bình thường là thông. Sau đó quay lại Console xem mức sử dụng, xác nhận yêu cầu được ghi vào Key này.

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

• providerType giữ là pi_compat, đây là định danh endpoint tùy chỉnh của nó; đổi sang tên provider tích hợp sẵn sẽ đi theo mô hình chính thức.
• models phải điền tay, nó không tự kéo danh sách mô hình. Tên phải trùng khớp hoàn toàn với "Model Square" trong Console (tham khảo Các mô hình hỗ trợ).
• Khi dùng endpoint tương thích Anthropic, Base URL là https://aicentos.com, không kèm /v1, đổi --provider thành anthropic.
• Vị trí menu của bản desktop thay đổi theo phiên bản, khi không tìm thấy thì lấy cách viết trong config.json làm chuẩn.

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

• Tài liệu Craft Agents
• Kho craft-agents