# Craft Agent

Nguồn: https://docs.aicentos.com/vi/clients/craft-agent

Language: vi

> Dùng aicentos trong Craft Agent —— kết nối OpenAI tương thích tùy chỉnh, dùng chung cho bản desktop và craft-cli

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ị

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](https://aicentos.com)
* Tạo Key: [https://aicentos.com/keys](https://aicentos.com/keys)
* Nạp tiền Ví: [https://aicentos.com/wallet](https://aicentos.com/wallet)

Cài bản desktop:

```bash
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ền

| Trường       | Giá trị                                                                                         |
| ------------ | ----------------------------------------------------------------------------------------------- |
| Loại kết nối | Custom (tùy chỉnh)                                                                              |
| Giao thức    | `openai-completions`, hoặc `anthropic-messages`                                                 |
| Base URL     | `https://aicentos.com/v1` (tương thích OpenAI) / `https://aicentos.com` (tương thích Anthropic) |
| 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

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:

```bash
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`:

```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 tra

```bash
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 ý

* `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ợ](https://docs.aicentos.com/vi/billing/models-list)).
* 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 quan

* [Tài liệu Craft Agents](https://thecraftagents.com/docs)
* [Kho craft-agents](https://github.com/craft-ai-agents/craft-agents-oss)