> ## 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.

# Sử dụng hiệu quả

> Mẹo và chiến lược đã được kiểm chứng để AI agent của bạn hoạt động chính xác, hữu ích và chuyên nghiệp nhất.

Dưới đây là những phương pháp giúp nâng cao chất lượng AI agent, từ cách viết hướng dẫn, chuẩn bị dữ liệu, đến cách lựa chọn mô hình và cải thiện phản hồi sau khi triển khai.

## Tinh chỉnh hướng dẫn cho agent

Hướng dẫn (system prompt) là nền tảng định hình cách agent hoạt động. Một hướng dẫn tốt xác định rõ vai trò, tông giọng, phạm vi phản hồi, và cách xử lý các tình huống đặc biệt.

### Ví dụ hướng dẫn hiệu quả

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

Nhiệm vụ chính: Giúp khách hàng hiểu sản phẩm, hỗ trợ xử lý sự cố cơ bản,
và cung cấp thông tin chính xác về các tính năng và dịch vụ của công ty.

Tông giọng: Chuyên nghiệp, thân thiện, và kiên nhẫn.

Giới hạn:
- Chỉ trả lời dựa trên thông tin từ dữ liệu đã được cung cấp.
- Nếu không có thông tin, nói rõ và hướng dẫn khách hàng liên hệ hỗ trợ.
- Không thảo luận về đối thủ cạnh tranh.
- Không đưa ra cam kết về giá hoặc chính sách ngoài thông tin đã có.

Kết thúc mỗi cuộc trò chuyện tích cực và hỏi xem khách hàng cần thêm trợ giúp không.
```

### Các nguyên tắc quan trọng

<CardGroup cols={2}>
  <Card title="Nên làm" icon="check">
    * Xác định rõ vai trò và nhiệm vụ cụ thể
    * Chỉ định tông giọng (chuyên nghiệp, thân thiện, thoải mái...)
    * Đặt giới hạn rõ ràng về phạm vi câu trả lời
    * Hướng dẫn cách xử lý khi không có thông tin
    * Thêm ví dụ về cách trả lời mong muốn
    * Kiểm thử và chỉnh sửa dần dựa trên phản hồi thực tế
  </Card>

  <Card title="Không nên" icon="ban">
    * Viết hướng dẫn quá chung chung, mơ hồ
    * Đặt các yêu cầu mâu thuẫn nhau
    * Viết quá chi tiết và dài dòng không cần thiết
    * Bỏ qua các tình huống "nằm ngoài phạm vi"
    * Sử dụng ngôn ngữ phức tạp, khó hiểu
  </Card>
</CardGroup>

<Tip>
  Thêm câu **"Bạn chỉ trả lời dựa trên thông tin từ dữ liệu đã được cung cấp"** để ngăn agent tự suy luận ngoài dữ liệu đã huấn luyện, tránh thông tin sai.
</Tip>

## Chất lượng nguồn dữ liệu

Chất lượng phản hồi phụ thuộc trực tiếp vào chất lượng dữ liệu bạn cung cấp. Dữ liệu tốt cho ra câu trả lời tốt.

### Yêu cầu về định dạng

<Info>
  AgentBase sử dụng văn bản có thể đọc được để tạo phản hồi. Hình ảnh, video và các nội dung không phải văn bản hiện **không được xử lý**.
</Info>

| Định dạng                  | Khả năng xử lý | Ghi chú                            |
| -------------------------- | -------------- | ---------------------------------- |
| PDF (có thể chọn văn bản)  | Tốt            | Tài liệu, catalog, báo cáo         |
| PDF (chỉ có hình ảnh/scan) | Không hỗ trợ   | Cần chuyển đổi sang PDF có văn bản |
| DOCX, TXT                  | Tốt            | Hướng dẫn, chính sách              |
| Website (cho phép crawler) | Tốt            | Blog, trang sản phẩm, FAQ          |
| Website (chặn crawler)     | Hạn chế        | Sao chép thủ công hoặc upload PDF  |
| Hình ảnh, video            | Không hỗ trợ   | —                                  |

### Mẹo cải thiện dữ liệu

<Steps>
  <Step title="Thông tin phải rõ ràng và cụ thể">
    Thay vì viết "Giảm giá lớn trong tháng này", hãy viết "Giảm 30% tất cả sản phẩm từ ngày 01/07 đến 31/07/2026".

    Thông tin mơ hồ dẫn đến câu trả lời mơ hồ.
  </Step>

  <Step title="Cấu trúc dữ liệu rõ ràng">
    Dùng tiêu đề, danh sách, và bảng trong tài liệu. Dữ liệu có cấu trúc giúp agent truy xuất thông tin chính xác hơn và nhanh hơn.
  </Step>

  <Step title="Cập nhật thường xuyên">
    Thông tin lỗi thời dẫn đến câu trả lời sai. Cập nhật nguồn dữ liệu khi có thay đổi về sản phẩm, giá cả, hoặc chính sách.
  </Step>

  <Step title="Ưu tiên Q&A cho câu hỏi quan trọng">
    Với các câu hỏi thường gặp và quan trọng, tạo cặp Q\&A thay vì chỉ để trong tài liệu. Q\&A cho độ chính xác cao nhất.
  </Step>
</Steps>

## Hiển thị hình ảnh trong câu trả lời

Agent có thể hiển thị hình ảnh trong câu trả lời bằng cú pháp Markdown trong phần hướng dẫn.

**Cú pháp:**

```text theme={null}
![Mô tả hình ảnh](https://example.com/ten-hinh-anh.jpg)
```

**Ví dụ:** Hướng dẫn agent hiển thị hình ảnh sản phẩm khi được hỏi.

```text theme={null}
Khi khách hỏi về sản phẩm X, hiển thị hình ảnh sau:
![Sản phẩm X](https://yoursite.com/products/product-x.jpg)
```

<Info>
  URL hình ảnh phải kết thúc bằng `.png` hoặc `.jpg` để hiển thị đúng trong chat widget. URL từ Google Drive, Dropbox hay các dịch vụ tương tự thường không hoạt động.
</Info>

## Lựa chọn mô hình AI phù hợp

Mỗi mô hình có điểm mạnh riêng và mức chi phí (credits) khác nhau. Chọn đúng mô hình giúp cân bằng giữa chất lượng và chi phí.

| Trường hợp sử dụng              | Mô hình đề xuất              | Lý do                            |
| ------------------------------- | ---------------------------- | -------------------------------- |
| Hỗ trợ khách hàng cơ bản        | GPT-5.4 Mini (1 credit)      | Nhanh, tiết kiệm, chất lượng tốt |
| Câu hỏi phức tạp, kỹ thuật      | GPT-5.4                      | Lý luận và phân tích tốt hơn     |
| Tác vụ đòi hỏi độ chính xác cao | GPT-5.5                      | Chất lượng xuất sắc              |
| Tốc độ tối đa                   | GPT-5.4 Mini hoặc GPT-5 Nano | Tối ưu cho phản hồi nhanh        |

Xem chi tiết tại trang [So sánh mô hình](/docs/user-guides/ai-performance-quality/models-comparison).

<Tip>
  Hãy sử dụng trang Playground để thử nghiệm cùng một câu hỏi với nhiều mô hình khác nhau, giúp bạn chọn mô hình phù hợp nhất trước khi triển khai.
</Tip>

## Cải thiện phản hồi sau khi triển khai

Sau khi agent đi vào hoạt động, việc theo dõi và cải thiện liên tục sẽ tạo ra sự khác biệt lớn về chất lượng.

### Sử dụng tính năng Sửa câu trả lời

<Frame>
  <img src="https://mintcdn.com/agentbase-6e6fb39b/z3rc3dVOha-BkoTz/images/quick-start/best-practices-revise-answer.gif?s=900dce1dfba7ceeb29b36b73e11a392f" alt="Best Practices Revise Answer" width="800" height="452" data-path="images/quick-start/best-practices-revise-answer.gif" />
</Frame>

<Steps>
  <Step title="Tìm câu trả lời cần sửa">
    Vào **Hoạt động → Chat Logs** và tìm cuộc hội thoại có vấn đề. Lọc theo **Thumbs down** hoặc theo **Điểm tin cậy thấp** để nhanh chóng tìm các phản hồi cần cải thiện.
  </Step>

  <Step title="Nhấn Sửa câu trả lời">
    Trên tin nhắn của agent, nhấn nút **"Sửa câu trả lời"**. Hộp soạn thảo sẽ hiển thị câu hỏi gốc, câu trả lời hiện tại, và ô nhập câu trả lời đúng.
  </Step>

  <Step title="Lưu và áp dụng">
    Câu trả lời được sửa tự động được thêm vào **nguồn dữ liệu Q\&A**, giúp agent trả lời chính xác hơn cho câu hỏi tương tự trong tương lai.
  </Step>
</Steps>

### Vòng lặp cải thiện liên tục

```text theme={null}
Triển khai agent  →  Khách hàng tương tác  →  Xem Chat Logs
       ↑                                              ↓
Agent thông minh hơn  ←  Cập nhật dữ liệu  ←  Phát hiện vấn đề
```

<Tip>
  Dành **10-15 phút mỗi tuần** để đọc chat logs và cải thiện agent. Những agent được theo dõi thường xuyên có chất lượng vượt trội so với những agent bị bỏ qua sau khi triển khai.
</Tip>

## Tiếp theo

<CardGroup cols={2}>
  <Card title="Chất lượng phản hồi" icon="box" href="/docs/docs/user-guides/ai-performance-quality/response-quality">
    Hướng dẫn chi tiết hơn về cách cải thiện độ chính xác phản hồi.
  </Card>

  <Card title="So sánh mô hình" icon="bot" href="/docs/docs/user-guides/ai-performance-quality/models-comparison">
    So sánh chi tiết tất cả mô hình AI có sẵn và chi phí credits.
  </Card>

  <Card title="Nguồn dữ liệu" icon="database" href="/docs/docs/user-guides/agent/data-sources">
    Quản lý và tối ưu dữ liệu huấn luyện cho agent.
  </Card>

  <Card title="Chat Logs" icon="chart-area" href="/docs/docs/user-guides/agent/chat-logs">
    Theo dõi hội thoại và cải thiện agent từ dữ liệu thực tế.
  </Card>
</CardGroup>