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

# Tổng quan

<Info icon="lightbulb">
  **Cẩm nang** là nơi chia sẻ cách làm cho tốt. Hướng dẫn sử dụng trả lời "bấm ở đâu", còn Cẩm nang trả lời "nên làm thế nào".
</Info>

Dựng được một Agent thì không khó. Dựng một Agent trả lời đúng, ổn định qua hàng nghìn lượt hội thoại và được cả phòng ban tin dùng thì khó hơn nhiều. Khoảng cách giữa hai việc đó nằm ở kinh nghiệm, và đây là nơi chúng tôi gom kinh nghiệm ấy lại.

<Note>
  Mục này đang được xây dựng và bổ sung dần. Các bài viết sẽ xuất hiện trong thanh điều hướng bên trái khi sẵn sàng.
</Note>

## Khác gì với Hướng dẫn sử dụng

| | Hướng dẫn sử dụng | Cẩm nang |
| - | - | - |
| Trả lời câu hỏi | Tính năng này nằm ở đâu, thao tác ra sao | Nên dùng thế nào cho hiệu quả |
| Tính chất | Mô tả đúng những gì sản phẩm đang có | Quan điểm, kinh nghiệm, đánh đổi |
| Khi nào đọc | Lúc đang thao tác và bị vướng | Lúc chuẩn bị làm, hoặc khi kết quả chưa như ý |
| Cách đọc | Tra cứu theo màn hình | Đọc theo chủ đề, không cần theo thứ tự |

## Trong Cẩm nang có gì

<CardGroup cols={2}>
  <Card title="Mẹo nhanh" icon="bolt">
    Bài ngắn, đọc trong một tới ba phút. Mỗi bài giải quyết đúng một vướng mắc cụ thể khi dựng Agent.
  </Card>

  <Card title="Thực hành tốt" icon="clipboard-check">
    Chuẩn nên theo khi viết Instructions, thiết kế Guardrail, chia Agent hỗ trợ và đặt tên tài nguyên.
  </Card>

  <Card title="Câu chuyện triển khai" icon="building">
    Các tình huống triển khai thật theo ngành và theo phòng ban: Bối cảnh, cách làm, kết quả và bài học.
  </Card>

  <Card title="Lộ trình học" icon="graduation-cap">
    Chuỗi bài có thứ tự, đi từ Agent đầu tiên tới Agent nhiều bước có kết nối và phê duyệt.
  </Card>
</CardGroup>

## Nên đọc gì trước

| Bạn đang ở đâu | Bắt đầu từ |
| - | - |
| Chưa dựng Agent nào | Lộ trình học |
| Agent chạy được nhưng trả lời chưa ổn định | Thực hành tốt |
| Đang vướng đúng một chỗ cụ thể | Mẹo nhanh |
| Cần thuyết phục nội bộ hoặc chọn bài toán để làm trước | Câu chuyện triển khai |

## Nguyên tắc của các bài trong Cẩm nang

* **Xuất phát từ việc thật**: Mỗi bài đi ra từ một tình huống đã gặp khi triển khai, không phải lý thuyết chung chung.
* **Nói rõ đánh đổi**: Không có cách làm nào đúng cho mọi trường hợp, nên bài viết nêu cả điều kiện áp dụng và giới hạn.
* **Có ví dụ dùng được ngay**: Đoạn Instructions, cấu hình hoặc checklist bạn có thể sao chép và sửa cho bài toán của mình.
* **Cập nhật theo sản phẩm**: Khi tính năng thay đổi, bài viết liên quan được rà lại thay vì để nguyên.

## Bắt đầu từ đâu

<CardGroup cols={3}>
  <Card title="EOS là gì" icon="layer-group" href="/eos-la-gi">
    Bức tranh tổng thể về nền tảng trước khi đi vào chi tiết.
  </Card>

  <Card title="Hướng dẫn Workspace" icon="comments" href="/fpt-ai-agent-platform">
    Nơi người dùng cuối trò chuyện với Agent, dùng Artifact và lấy Agent từ Chợ Agent.
  </Card>

  <Card title="Hướng dẫn Console" icon="sliders" href="https://docs-agents.fpt.ai/fpt-ai-agents-console">
    Nơi bạn tạo Agent, cấu hình, kiểm thử, publish và phân quyền.
  </Card>
</CardGroup>

## Đề xuất chủ đề

Bạn đang vướng một bài toán mà chưa tìm thấy bài viết tương ứng, hoặc đã có cách làm hay muốn chia sẻ lại cho cộng đồng người dùng, hãy liên hệ đội ngũ FPT AI Agents.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.