> ## Documentation Index
> Fetch the complete documentation index at: https://agentbase.vn/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Playground

> Thử nghiệm và tinh chỉnh AI agent trước khi triển khai. Thay đổi mô hình AI, chỉnh temperature, system prompt, và xem kết quả ngay lập tức.

Playground là môi trường thử nghiệm trực tiếp cho AI agent. Tại đây bạn có thể kiểm tra chất lượng câu trả lời, thay đổi mô hình AI, chỉnh sửa system prompt, và tối ưu agent trước khi triển khai đến khách hàng.

<Frame>
  <img src="https://mintcdn.com/agentbase-6e6fb39b/z3rc3dVOha-BkoTz/images/agent/playground/playground-overview.png?fit=max&auto=format&n=z3rc3dVOha-BkoTz&q=85&s=a3224dd1ed2b733763afd11fcf64e177" alt="Playground Overview" width="2800" height="1800" data-path="images/agent/playground/playground-overview.png" />
</Frame>

## Chọn mô hình AI

Nhấn vào dropdown **Mô hình** trên panel trái để chọn mô hình. Mỗi mô hình có chi phí credits và điểm mạnh khác nhau.

<Frame>
  <img src="https://mintcdn.com/agentbase-6e6fb39b/z3rc3dVOha-BkoTz/images/agent/playground/playground-model-picker.png?fit=max&auto=format&n=z3rc3dVOha-BkoTz&q=85&s=0e5298ea81430e7a0b2c3dcb9a21eb1f" alt="Playground Model Picker" width="2800" height="1800" data-path="images/agent/playground/playground-model-picker.png" />
</Frame>

| Mô hình          | Credits/tin nhắn | Gói          | Đặc điểm                                    |
| ---------------- | ---------------- | ------------ | ------------------------------------------- |
| **GPT-5.4 Mini** | 1                | Free trở lên | Mặc định — nhanh, tiết kiệm, chất lượng tốt |
| **GPT-4o Mini**  | 1                | Free trở lên | Nhỏ gọn, cân bằng tốc độ và hiệu suất       |
| **GPT-5.4 Nano** | 1                | Standard     | Siêu nhẹ, tốc độ phản hồi cực nhanh         |
| **GPT-5 Mini**   | 1                | Standard     | Cân bằng suy luận và chi phí                |
| **GPT-5 Nano**   | 1                | Standard     | Tốc độ cao nhất dòng GPT-5                  |
| **GPT-4o**       | 1                | Standard     | Đa phương thức, hiệu suất cao               |
| **o4 Mini**      | 1                | Standard     | Suy luận logic mạnh, tối ưu chi phí         |
| **GPT-5.4**      | 2                | Standard     | Lý luận nâng cao, hội thoại tinh vi         |
| **GPT-5**        | 2                | Standard     | Hiểu ngữ cảnh sâu, xử lý đa bước            |
| **GPT-5.5**      | 4                | Standard     | Mạnh nhất — suy luận vượt trội              |

<Info>
  Các mô hình từ Anthropic (Claude) và Google (Gemini) sẽ sớm được bổ sung. Xem [So sánh mô hình](/docs/user-guides/ai-performance-quality/models-comparison) để so sánh chi tiết.
</Info>

<Tip>
  Bắt đầu với **GPT-5.4 Mini** — đủ chất lượng cho phần lớn trường hợp. Nâng cấp lên mô hình mạnh hơn khi cần xử lý câu hỏi phức tạp. Xem [So sánh mô hình](/docs/user-guides/ai-performance-quality/models-comparison) để hiểu rõ hơn.
</Tip>

## Temperature (Mức độ sáng tạo)

Temperature kiểm soát mức độ đa dạng và sáng tạo trong phản hồi của AI. Giá trị từ 0 đến 1.

<Note>
  Temperature của model có thể được chỉnh trong phần [Cài đặt Agent](/docs/user-guides/agent/settings).
</Note>

| Giá trị     | Hành vi                       | Phù hợp cho                       |
| ----------- | ----------------------------- | --------------------------------- |
| **0.0**     | Rất nhất quán và dự đoán được | FAQ, thông tin kỹ thuật, giá cả   |
| **0.2**     | Nhất quán với chút biến thể   | Hỗ trợ khách hàng (khuyến nghị)   |
| **0.5**     | Cân bằng                      | Tư vấn, giải thích                |
| **0.7–1.0** | Sáng tạo, đa dạng             | Brainstorming, nội dung marketing |

<Info>
  Giá trị temperature được khuyến nghị là **0.2** để duy trì độ chính xác và tránh agent tự bịa đặt thông tin ngoài dữ liệu đã cung cấp.
</Info>

## System prompt (Hướng dẫn)

System prompt là hướng dẫn định hình tính cách, tông giọng và phạm vi trả lời của agent.

<Frame>
  <img src="https://mintcdn.com/agentbase-6e6fb39b/z3rc3dVOha-BkoTz/images/agent/playground/playground-system-prompt.png?fit=max&auto=format&n=z3rc3dVOha-BkoTz&q=85&s=fc121c0a8fe6da2d7cca859977da0919" alt="Playground System Prompt" width="2800" height="1800" data-path="images/agent/playground/playground-system-prompt.png" />
</Frame>

### Viết hướng dẫn hiệu quả

**Xác định vai trò:**

```text theme={null}
Bạn là trợ lý AI của [Tên công ty], chuyên hỗ trợ khách hàng về [lĩnh vực].
```

**Quy tắc trả lời:**

```text theme={null}
- Luôn trả lời bằng tiếng Việt, lịch sự và thân thiện.
- Nếu không biết câu trả lời, nói rõ và hướng dẫn khách liên hệ hotline.
- Không bịa đặt thông tin. Chỉ trả lời dựa trên dữ liệu được cung cấp.
```

**Phạm vi:**

```text theme={null}
Chỉ trả lời các câu hỏi liên quan đến sản phẩm và dịch vụ của công ty.
Từ chối lịch sự các câu hỏi ngoài phạm vi.
```

### Channel prompts

Bên cạnh hướng dẫn cơ bản, bạn có thể viết prompt riêng cho từng kênh triển khai (chat widget, Zalo, Messenger, v.v.) bằng cách vào trang deploy của kênh và bật chế độ prompt riêng.

### Đặt lại prompt

Nhấn biểu tượng **↺ (Đặt lại)** bên cạnh tiêu đề "Hướng dẫn" để hoàn tác về phiên bản đã lưu gần nhất.

Xem thêm mẫu hướng dẫn và hướng dẫn viết prompt tại trang [Chất lượng phản hồi](/docs/user-guides/ai-performance-quality/response-quality).

## Thử nghiệm với Chat Widget

<Frame>
  <img src="https://mintcdn.com/agentbase-6e6fb39b/z3rc3dVOha-BkoTz/images/agent/playground/playground-chat.png?fit=max&auto=format&n=z3rc3dVOha-BkoTz&q=85&s=2722cf31efea60847c7d05eed7166136" alt="Playground Chat" width="2800" height="1800" data-path="images/agent/playground/playground-chat.png" />
</Frame>

Hãy thử nghiệm bằng cách trò chuyện với chat widget mẫu.

## Xem nguồn dữ liệu (Cite Sources)

Sau khi gửi ít nhất 1 tin nhắn, nhấn **"Xem nguồn dữ liệu"** để kiểm tra:

<Frame>
  <img src="https://mintcdn.com/agentbase-6e6fb39b/z3rc3dVOha-BkoTz/images/agent/playground/playground-cite-sources.png?fit=max&auto=format&n=z3rc3dVOha-BkoTz&q=85&s=e0669375ce0198ccec6d2e4ad637b06b" alt="Playground Cite Sources" width="2800" height="1800" data-path="images/agent/playground/playground-cite-sources.png" />
</Frame>

* Danh sách các đoạn văn bản (chunks) đã được truy xuất.
* Nguồn gốc của mỗi đoạn (file nào, trang nào, URL nào).

<Tip>
  Nếu agent trả lời sai hoặc không đủ thông tin, kiểm tra "Xem nguồn dữ liệu" để biết agent đang tham chiếu từ đâu. Từ đó bổ sung hoặc cập nhật đúng nguồn dữ liệu.
</Tip>

## AI Actions

Ngoài trả lời câu hỏi, agent có thể thực hiện các hành động cụ thể như thu thập thông tin khách hàng, chuyển tiếp đến nhân viên, và nhiều hành động khác.

Nhấn **"AI Actions"** trên panel trái để xem và cấu hình các hành động đang được kích hoạt. Xem chi tiết tại trang [Hành động (Actions)](/docs/user-guides/agent/actions/overview).

## Tính năng So sánh

Tính năng So sánh cho phép thử nghiệm nhiều cấu hình agent cùng lúc với cùng một câu hỏi.

## Lưu thay đổi

Khi thay đổi mô hình, temperature, hoặc system prompt, thanh **"Thay đổi chưa lưu"** sẽ xuất hiện ở cuối màn hình.

* **Lưu:** Áp dụng cấu hình mới cho agent. Các cuộc trò chuyện từ đây sẽ dùng cấu hình mới.
* **Hủy bỏ:** Hoàn tác về cấu hình đã lưu trước đó.

<Warning>
  Thay đổi trong Playground chỉ có hiệu lực sau khi nhấn **Lưu**. Chuyển sang trang khác mà chưa lưu sẽ mất toàn bộ thay đổi.
</Warning>

## Mẹo sử dụng Playground hiệu quả

<CardGroup cols={2}>
  <Card title="Test nhiều kịch bản" icon="badge-question-mark">
    Thử các câu hỏi mà khách hàng thực tế hay hỏi — bao gồm cả trường hợp agent không biết câu trả lời.
  </Card>

  <Card title="So sánh trước khi quyết định" icon="git-compare">
    Dùng chế độ So sánh để thử nhiều mô hình với cùng câu hỏi trước khi chọn mô hình chính thức.
  </Card>

  <Card title="Tinh chỉnh system prompt" icon="message-circle-dashed">
    Nếu agent trả lời quá dài, thêm "Trả lời ngắn gọn, không quá 3 câu." vào prompt.
  </Card>

  <Card title="Kiểm tra nguồn dữ liệu" icon="app-window">
    Dùng "Xem nguồn dữ liệu" thường xuyên để đảm bảo agent tìm đúng thông tin.
  </Card>
</CardGroup>