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

# Hiển thị tài liệu tham chiếu

### Hiển thị tài liệu tham chiếu

#### Mục đích

Tính năng **Tài liệu tham chiếu** cho phép AI Agent hiển thị các **liên kết đến nguồn tài liệu gốc** khi trả lời người dùng, giúp người dùng kiểm chứng thông tin và đối chiếu dễ dàng, tăng độ tin cậy cho câu trả lời.

Để tài liệu tham khảo được hiển thị trong câu trả lời, cần đồng thời thỏa mãn cả hai điều kiện sau:

* Đã cấu hình dữ liệu Reference trong khối “Kết thúc” của nhiệm vụ **( xem tại Cấu hình tham chiếu metadata, [Khối Kết thúc](/khoi-ket-thuc))** 
* Đã bật tùy chọn Tài liệu tham khảo trong mục Tối ưu trò chuyện của Agent.  

Nếu thiếu một trong hai điều kiện trên, câu trả lời sẽ không hiển thị tài liệu tham khảo

#### Phạm vi áp dụng

* **Định dạng tài liệu hỗ trợ:**
  * PDF gốc.
  * Word (.doc, .docx) sau khi convert sang PDF.
  * PowerPoint (.ppt, .pptx).
  * Excel (.xls, .xlsx).
* **Kênh hỗ trợ hiển thị tài liệu tham chiếu:**
  * Xem trước và Kiểm thử.
  * Livechat: khi tích hợp qua kênh Website trên AI Agents Platform.
  * Trang MyAgents: `https://myagents.fpt.ai/`.
  * Lịch sử.

#### Hướng dẫn sử dụng

**Bước 1**: Vào phần **Xây dựng Agent** → chọn tab **Tối ưu trò chuyện**.

**Bước 2**: Tìm mục **Tài liệu tham khảo** bên dưới **"Mở đầu hội thoại"**.

<img src="https://mintcdn.com/fpt-62e894b4/d1zMbl9JAEhYSdjf/images/image296.png?fit=max&auto=format&n=d1zMbl9JAEhYSdjf&q=85&s=bf1c35b10fa0b6f842f6f833ecd877ad" alt="Image296" width="1096" height="500" data-path="images/image296.png" />

**Bước 3**: Gạt công tắc để **Bật** hoặc **Tắt** tính năng.

* **Mặc định**: Tính năng được **Tắt**.
* Khi **Tắt**: Agent chỉ trả lời nội dung, **không hiển thị trích dẫn** dù có dùng nội dung từ tài liệu và có cấu hình tham chiếu Metadata trong khối “Kết thúc”
* Khi **Bật**: Hệ thống kiểm tra trong khối “Kết thúc” có cấu hình tham chiếu Metadata hay không. Agent **tự động chèn tài liệu tham khảo** vào câu trả lời nếu có trích dẫn từ tài liệu.

**Cách hiển thị trên [Xem trước và kiểm thử](/xem-truoc-va-kiem-thu),và [Lịch sử](/lich-su-tro-chuyen):**

<img src="https://mintcdn.com/fpt-62e894b4/-xnI4NY9T7tMBp5f/images/image297.png?fit=max&auto=format&n=-xnI4NY9T7tMBp5f&q=85&s=7a76580a916133907685d016f2569e1c" alt="Image297" width="1132" height="490" data-path="images/image297.png" />

<img src="https://mintcdn.com/fpt-62e894b4/-xnI4NY9T7tMBp5f/images/image298.png?fit=max&auto=format&n=-xnI4NY9T7tMBp5f&q=85&s=7629ea618aa0ed0470ce99bcacff3918" alt="Image298" width="1060" height="500" data-path="images/image298.png" />

<img src="https://mintcdn.com/fpt-62e894b4/-xnI4NY9T7tMBp5f/images/image299.png?fit=max&auto=format&n=-xnI4NY9T7tMBp5f&q=85&s=39615af63634e7767dfd6e8575b83747" alt="Image299" width="1084" height="500" data-path="images/image299.png" />

<img src="https://mintcdn.com/fpt-62e894b4/-xnI4NY9T7tMBp5f/images/image300.png?fit=max&auto=format&n=-xnI4NY9T7tMBp5f&q=85&s=0a418c74fc6574aa1e56eb359b891dd2" alt="Image300" width="579" height="936" data-path="images/image300.png" />

<img src="https://mintcdn.com/fpt-62e894b4/34cYAT85AD9la3e8/images/image301.png?fit=max&auto=format&n=34cYAT85AD9la3e8&q=85&s=1fc7c9e2a4551d42bcc02988e6e9ea40" alt="Image301" width="936" height="442" data-path="images/image301.png" />

**Cách hiển thị trên trang MyAgents:**

<img src="https://mintcdn.com/fpt-62e894b4/34cYAT85AD9la3e8/images/image302.png?fit=max&auto=format&n=34cYAT85AD9la3e8&q=85&s=88b6076714b48885099875ef35fe43a3" alt="Image302" width="1132" height="474" data-path="images/image302.png" />

<img src="https://mintcdn.com/fpt-62e894b4/34cYAT85AD9la3e8/images/image303.png?fit=max&auto=format&n=34cYAT85AD9la3e8&q=85&s=3cdd52bea91212ff5d86be8b8e5931d0" alt="Image303" width="936" height="511" data-path="images/image303.png" />

<img src="https://mintcdn.com/fpt-62e894b4/34cYAT85AD9la3e8/images/image304.png?fit=max&auto=format&n=34cYAT85AD9la3e8&q=85&s=7b52bb4d15be8024a338676bad3ec92c" alt="Image304" width="936" height="508" data-path="images/image304.png" />

<Note>
  * Khi tắt tính năng, các câu trả lời cũ đã có ref vẫn giữ nguyên, kèm theo tooltip: *"Trích dẫn này được tạo khi tính năng tham chiếu còn bật. Hiện tại, tính năng đã tắt nên các câu trả lời mới sẽ không hiển thị trích dẫn"*.
</Note>