# Tích hợp Roo AI Assistant

Tích hợp 9Router với Roo AI Assistant để truy cập nhiều model AI qua một giao diện thống nhất.

## Yêu cầu

- Roo AI Assistant đã cài đặt
- 9Router API key từ [dashboard](https://9router.com/dashboard)
- 9Router đang chạy (cục bộ hoặc cloud)

## Các bước Cấu hình

### 1. Mở Roo Settings

Khởi chạy Roo AI Assistant và mở panel settings.

### 2. Cấu hình API Provider

1. Đi đến cài đặt **API Provider**
2. Chọn **Ollama** làm provider type
3. Cấu hình các settings sau:

**Cho 9Router cục bộ:**
```
Base URL: http://localhost:20128/v1
API Key: your-api-key-from-dashboard
```

**Cho 9Router cloud:**
```
Base URL: https://9router.com/v1
API Key: your-api-key-from-dashboard
```

### 3. Chọn Model

Chọn từ các model 9Router có sẵn:

**Claude Models:**
- `cc/claude-opus-4-5-20251101` - Mạnh nhất
- `cc/claude-sonnet-4-20250514` - Cân bằng
- `cc/claude-haiku-4-20250514` - Nhanh

**DeepSeek Models:**
- `cx/deepseek-chat` - Đa năng
- `cx/deepseek-reasoner` - Reasoning phức tạp

**GLM Models:**
- `glm/glm-4-plus` - Nâng cao
- `glm/glm-4-flash` - Phản hồi nhanh

### 4. Test Connection

Gửi tin nhắn test để xác minh tích hợp:

```
Hello! Can you confirm you're connected through 9Router?
```

## Ví dụ Sử dụng

### Chat Cơ bản
```
Ask Roo: "Explain quantum computing in simple terms"
Model: cc/claude-sonnet-4-20250514
```

### Tạo Code
```
Ask Roo: "Write a Python function to calculate Fibonacci numbers"
Model: cx/deepseek-chat
```

### Reasoning Phức tạp
```
Ask Roo: "Analyze the trade-offs between microservices and monolithic architecture"
Model: cx/deepseek-reasoner
```

## Mẹo Chọn Model

- **Task nhanh**: Dùng `cc/claude-haiku-4-20250514` hoặc `glm/glm-4-flash`
- **Hiệu năng cân bằng**: Dùng `cc/claude-sonnet-4-20250514` hoặc `cx/deepseek-chat`
- **Reasoning phức tạp**: Dùng `cc/claude-opus-4-5-20251101` hoặc `cx/deepseek-reasoner`
- **Tối ưu chi phí**: Dùng model DeepSeek hoặc GLM

## Troubleshooting

### Connection Failed
- Xác minh 9Router đang chạy: `curl http://localhost:20128/health`
- Kiểm tra API key đúng
- Đảm bảo Base URL bao gồm hậu tố `/v1`

### Model không khả dụng
- Kiểm tra tên model khớp chính xác (case-sensitive)
- Xác minh model được bật trong 9Router plan
- Thử model khác từ danh sách

### Phản hồi Chậm
- Chuyển sang model nhanh hơn (haiku, flash)
- Kiểm tra kết nối network
- Theo dõi logs 9Router để xem vấn đề

## Cấu hình Nâng cao

### Custom Model Aliases

Bạn có thể tạo shortcut cho model thường dùng trong Roo settings:

```
Alias: "fast" → cc/claude-haiku-4-20250514
Alias: "smart" → cc/claude-opus-4-5-20251101
Alias: "code" → cx/deepseek-chat
```

### Nhiều Profile

Setup profile khác nhau cho use case khác nhau:
- **Development**: Model DeepSeek cho code
- **Writing**: Model Claude cho nội dung
- **Research**: Model Reasoner cho phân tích

## Bước tiếp theo

- [Cấu hình Cursor](cursor.md) cho tích hợp IDE
- [Setup Continue](continue.md) cho VSCode
- [Khám phá CLI usage](../cli/basic-usage.md)