# Zed Agent

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

Language: vi

> Kết nối aicentos trong Agent Panel của Zed qua provider OpenAI tương thích

Zed tích hợp sẵn loại provider OpenAI tương thích, khai báo endpoint, mô hình và độ dài ngữ cảnh trong `settings.json`, là có thể cho Agent Panel dùng các mô hình aicentos tích hợp.

## Chuẩn bị

Trước tiên, tạo một Key chuyên dụng cho Zed tại trang "API Key" trong Console (khuyến nghị đặt tên `zed-agent`).

* 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)

Zed không ghi API Key vào `settings.json`, mà đọc biến môi trường cùng tên: Provider ID sẽ được chuyển thành chữ hoa dạng snake\_case rồi thêm hậu tố `_API_KEY`. Vì vậy khi Provider ID đặt là `aicentos`, tên biến môi trường chính là `AICENTOS_API_KEY`.

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

| Trường                          | Giá trị                                      |
| ------------------------------- | -------------------------------------------- |
| Provider ID                     | tự đặt, ví dụ `aicentos`                     |
| `api_url`                       | `https://aicentos.com/v1`                    |
| `available_models[].name`       | tên mô hình trong "Model Square" của Console |
| `available_models[].max_tokens` | cửa sổ ngữ cảnh của mô hình                  |
| API Key                         | biến môi trường `AICENTOS_API_KEY`           |

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

* Mở `settings.json` của Zed (command palette thực hiện `zed: open settings`).
* Thêm cấu hình `language_models.openai_compatible`:

```json
{
  "language_models": {
    "openai_compatible": {
      "aicentos": {
        "api_url": "https://aicentos.com/v1",
        "available_models": [
          {
            "name": "gpt-5",
            "display_name": "GPT-5 (aicentos)",
            "max_tokens": 128000,
            "max_output_tokens": 16384,
            "capabilities": {
              "tools": true,
              "images": false,
              "chat_completions": true
            }
          }
        ]
      }
    }
  }
}
```

* Xuất biến môi trường (ghi vào `~/.zshrc` rồi tải lại):

```bash
export AICENTOS_API_KEY="sk-Key-aicentos-của-bạn"
```

* Mở Agent Panel, trong dropdown mô hình chọn mô hình dưới provider này.

Cũng có thể trong cài đặt Agent nhấn **Add Provider**, điền tên Provider, API URL, model ID và cửa sổ ngữ cảnh qua giao diện đồ hoạ.

## Kiểm tra

Sau khi cấu hình xong, tạo một hội thoại mới trong Agent Panel, trước tiên test nhẹ bằng một câu prompt đơn giản, xác nhận có thể trả về bình thường rồi mới chính thức dùng gọi công cụ.

## Lưu ý

* `api_url` chỉ điền đến `https://aicentos.com/v1`, đừng bổ sung thành `/chat/completions` đầy đủ; Zed sẽ tự nối.
* API Key không được viết trực tiếp vào `settings.json`, bắt buộc dùng biến môi trường (hoặc lưu vào system keychain qua giao diện cài đặt Provider); biến môi trường khác rỗng có độ ưu tiên cao hơn keychain.
* `max_tokens` là cửa sổ ngữ cảnh, khuyến nghị điền theo giá trị thực của mô hình; nếu thiếu sẽ khiến việc quản lý ngữ cảnh bất thường.
* Gọi công cụ mặc định được bật (`capabilities.tools`), nhập ảnh và gọi công cụ song song mặc định tắt, khi cần thì bật thủ công.
* Tài liệu chính thức: [https://zed.dev/docs/ai/llm-providers](https://zed.dev/docs/ai/llm-providers)
* Xem thêm giải thích tại trang tài liệu: [https://docs.aicentos.com](https://docs.aicentos.com)