# Warp

Nguồn: https://docs.aicentos.com/vi/clients/warp

Language: vi

> Kết nối aicentos trong Warp —— đưa Warp Agent chạy qua endpoint suy luận tùy chỉnh

Warp là môi trường phát triển Agent dạng terminal. Nó hỗ trợ **Custom inference endpoint**: chỉ cần đối phương triển khai giao diện OpenAI Chat Completions, là có thể chuyển các lượt gọi mô hình của Warp Agent sang. Trỏ endpoint về aicentos, là có thể dùng các mô hình dưới tài khoản của bạn để đưa Agent của Warp chạy.

## Chuẩn bị

* Cập nhật Warp lên phiên bản có endpoint suy luận tùy chỉnh (bản cũ chỉ có BYOK, không sửa được Base URL).
* Tạo một Key chuyên dụng trong Console của aicentos (khuyến nghị đặt tên `warp-terminal`).
* Xác nhận mô hình định dùng hỗ trợ **gọi công cụ (function calling)**, Warp Agent dựa vào nó để đọc ghi file, thực thi lệnh.

## Cấu hình cần điền

| Trường        | Giá trị                                                      |
| ------------- | ------------------------------------------------------------ |
| Endpoint name | `aicentos` (tự đặt, dùng để nhận diện trong bộ chọn mô hình) |
| Endpoint URL  | `https://aicentos.com/v1`                                    |
| API Key       | Key tạo trong Console                                        |
| Model name    | model ID trong "Model Square" của Console                    |
| Model alias   | tùy chọn, tên hiển thị trong bộ chọn mô hình                 |

## Các bước thiết lập

* Mở cài đặt Warp, tìm kiếm `inference endpoint`, hoặc vào **Settings → AI**.
* Trong khu vực **Custom inference**, nhấn **Add custom model** / **Add destination**.
* Trong hộp thoại điền Endpoint name, Endpoint URL (`https://aicentos.com/v1`), API Key.
* Tại **Model name** điền model ID, nhấn **Add model** để thêm nhiều hơn; có thể điền thêm alias để dễ nhận diện.
* Sau khi lưu, mô hình tùy chỉnh sẽ xuất hiện trong bộ chọn mô hình của Warp, được đánh dấu bằng tên endpoint của bạn.

## Kiểm tra

Trong Warp chọn mô hình vừa thêm, gửi một câu hỏi đơn giản (ví dụ "liệt kê các file trong thư mục hiện tại và giải thích cấu trúc dự án") để xác nhận có thể trả về bình thường. Mô hình endpoint tùy chỉnh sẽ hiển thị trong bộ chọn của chế độ agent, thanh công cụ và ambient agent.

## Lưu ý

* Endpoint URL điền đường dẫn gốc tương thích OpenAI (có thể nối thành `/v1/chat/completions`), đừng viết thành đường dẫn đầy đủ `/v1/chat/completions`.
* Endpoint phải truy cập được từ **mạng công cộng**: yêu cầu của Warp được chuyển tiếp qua máy chủ của nó, `localhost`, địa chỉ mạng nội bộ sẽ bị từ chối. `aicentos.com` là địa chỉ HTTPS công cộng, dùng được ngay.
* API Key và thông tin endpoint được lưu trong kho bảo mật của **thiết bị cục bộ**, máy chủ Warp chỉ dùng ngay khi có yêu cầu, không lưu lại.
* Yêu cầu đi qua endpoint tùy chỉnh **không tiêu tốn AI credits của Warp**, chi phí do phía aicentos tính theo mức sử dụng; nhưng ở gói Business / Enterprise, việc chạy Agent cục bộ vẫn tiêu tốn credits của nền tảng.
* Nếu báo `400 invalid model format`, tức là gateway của bạn yêu cầu dạng `provider/model_id`; lấy model ID do Console đưa ra làm chuẩn, khi cần bổ sung tiền tố theo định dạng đó.
* Endpoint tùy chỉnh hiện chưa thể khai báo riêng cửa sổ ngữ cảnh, phiên hội thoại quá dài có thể bị nén sớm.
* Tài liệu chính thức: `https://docs.warp.dev/agent-platform/inference/custom-inference-endpoint/`