# Junie

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

Language: vi

> Kết nối aicentos trong Junie CLI qua model profile tùy chỉnh

Junie là coding agent của JetBrains, có hai hình thái: plugin IDE và Junie CLI. **Chỉ Junie CLI hỗ trợ trỏ về endpoint tùy chỉnh**: nó kết nối tới dịch vụ OpenAI tương thích bất kỳ qua JSON profile trong `$JUNIE_HOME/models/`. Plugin IDE hiện không thể trỏ về endpoint tùy chỉnh.

## Chuẩn bị

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

* 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ấu hình cần điền

| Trường                         | Giá trị                                                |
| ------------------------------ | ------------------------------------------------------ |
| `baseUrl`                      | `https://aicentos.com/v1/chat/completions`             |
| `apiType`                      | `OpenAICompletion`                                     |
| `apiKey`                       | Key tạo trong Console (hỗ trợ tham chiếu `${ENV_VAR}`) |
| `id`                           | tên mô hình trong "Model Square" của Console           |
| `displayName` / `providerName` | tự đặt, ví dụ `aicentos`                               |

Lưu ý: profile của Junie ngược với đa số client, `baseUrl` cần điền **endpoint đầy đủ**, phải kết thúc bằng `/chat/completions`, Junie không tự nối đường dẫn.

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

* Tạo file profile (tên file bỏ `.json` chính là định danh profile):
  * Cấp người dùng: `~/.junie/models/aicentos.json` (`$JUNIE_HOME` mặc định là `~/.junie`)
  * Cấp dự án: `<gốc dự án>/.junie/models/aicentos.json` (cần dự án đã được tin cậy)
* Ghi nội dung sau:

```json
{
  "id": "gpt-5",
  "baseUrl": "https://aicentos.com/v1/chat/completions",
  "apiType": "OpenAICompletion",
  "apiKey": "${AICENTOS_API_KEY}",
  "displayName": "aicentos GPT",
  "providerName": "aicentos",
  "fasterModel": { "id": "gpt-5-mini" }
}
```

* Xuất biến môi trường:

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

* Khi khởi động chỉ định profile, hoặc trong giao diện tương tác dùng `/model` để chọn:

```bash
junie --model custom:aicentos
```

## Kiểm tra

Sau khi khởi động, trước tiên test nhẹ bằng một câu prompt đơn giản, xác nhận có thể trả về kết quả bình thường rồi mới chính thức dùng quy trình agentic.

## Lưu ý

* **Plugin JetBrains IDE không hỗ trợ endpoint tùy chỉnh**, bộ profile này chỉ có hiệu lực trong Junie CLI.
* `baseUrl` phải là endpoint đầy đủ (kèm `/v1/chat/completions`), điều này khác với nhiều client chỉ cần điền Base URL.
* `${VAR}` trong `apiKey` và `extraHeaders` được phân giải khi nạp profile; biến môi trường chưa thiết lập sẽ khiến việc nạp profile thất bại.
* Profile cấp dự án chịu giới hạn tin cậy dự án, dự án chưa tin cậy sẽ báo `Unknown custom model profile`.
* Mô hình nhỏ khó đảm nhiệm các tác vụ gọi công cụ nhiều bước và ngữ cảnh dài của Junie, khuyến nghị chọn mô hình có năng lực mạnh hơn.
* Xem thêm giải thích tại trang tài liệu: [https://docs.aicentos.com](https://docs.aicentos.com)