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

# Khối Phân tích tài liệu

**Mục đích:** Phân tích và trích xuất các nội dung của tệp được tải lên trong quá trình trò chuyện với AI Agent (ví dụ: ảnh, tệp PDF, Excel...).

**Usecase sử dụng:**

* **Trích xuất mã lỗi từ ảnh**: Người dùng gửi ảnh chụp lỗi hệ thống → Hệ thống trích xuất mã lỗi từ ảnh → Mã lỗi được dùng để query vào cơ sở dữ liệu, hiển thị hướng dẫn xử lý phù hợp.
* **Gửi ảnh để tư vấn**: Người dùng gửi ảnh sản phẩm/dịch vụ → Hệ thống tự động chuyển tệp đến tư vấn viên (TVV) để hỗ trợ chi tiết hơn.

**Đầu vào:** Biến `sys.attachments`

```json theme={null}
{
  "files": [
    {
      "type": "",
      "url": ""
    }
  ],
  "instruction": ""
}
```

**Đầu ra:** Biến `result`

```json theme={null}
{
  "results": [""]
}
```

***

**Các bước sử dụng:**

**Bước 1.** Mở một nhiệm vụ bất kỳ → Nhấn **Thêm khối** tại vị trí mong muốn trong quy trình.

<img src="https://mintcdn.com/fpt-62e894b4/d1zMbl9JAEhYSdjf/images/image212.png?fit=max&auto=format&n=d1zMbl9JAEhYSdjf&q=85&s=ef51759dfd0cc66d3987f1b41605c904" alt="Image212" width="342" height="158" data-path="images/image212.png" />

**Bước 2.** Gán giá trị cho biến đầu vào: Chọn biến **`sys.attachments`**.

<img src="https://mintcdn.com/fpt-62e894b4/d1zMbl9JAEhYSdjf/images/image213.png?fit=max&auto=format&n=d1zMbl9JAEhYSdjf&q=85&s=0b5366b02d326e649d5f5416fcf7da54" alt="Image213" width="405" height="398" data-path="images/image213.png" />

**Bước 3.** Thêm **hướng dẫn trích xuất (prompt)** tại phần **Instructions** (không bắt buộc) trong trường hợp cần trích xuất nội dung tệp theo mong muốn cụ thể.

<img src="https://mintcdn.com/fpt-62e894b4/d1zMbl9JAEhYSdjf/images/image214.png?fit=max&auto=format&n=d1zMbl9JAEhYSdjf&q=85&s=8fe75dbe0f4b1d0c0e791d78aaac70fe" alt="Image214" width="412" height="374" data-path="images/image214.png" />

**Bước 4.** Khối "Phân tích tài liệu" có thể thao tác tương tự các khối khác: Chỉnh sửa chi tiết, Sao chép/Dán/Nhân bản/Xóa, Chạy thử.