> For the complete documentation index, see [llms.txt](https://docs.datasuite.vn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.datasuite.vn/ai-companion-tro-ly-phan-tich-du-lieu.md).

# AI Companion - Trợ lý phân tích dữ liệu

### Giới thiệu

Data Suite AI Companion là trợ lý tích hợp sẵn trên nền tảng Data Suite, cho phép người dùng chat để khám phá dữ liệu có trong Organization của mình.

### AI Companion có thể làm gì?

| Năng lực                                                           | Kích hoạt (ví dụ)                                                 | Khả năng                                                                                                                                                                                                                                                                    |
| ------------------------------------------------------------------ | ----------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Talk to data - Truy vấn số liệu đơn thuần                          | "Doanh thu sản phẩm A theo tháng của năm nay là bao nhiêu?"       | Truy vấn số liệu đơn thuần. Người dùng chat với Companion để hỏi về số liệu, thay vì phải tự mình tìm báo cáo và số liệu mong muốn. Companion có quyền truy cập Data Model, tự thực hiện truy vấn dựa trên yêu cầu, sau đó trả về kết quả dưới dạng bảng biểu hoặc biểu đồ. |
| Root cause analysis - Phân tích nguyên nhân                        | "Vì sao doanh thu giảm so với cùng kỳ năm trước?"                 | Người dùng sau khi hỏi về số liệu, có thể yêu cầu Companion so sánh giữa các chu kỳ và phân tích nguyên nhân biến động. Companion tự động truy vấn và đào sâu dữ liệu hiện có và đưa ra ý kiến tham khảo.                                                                   |
| Executive briefing - Lập báo cáo tổng hợp và phân tích chuyên sâu. | "Tổng hợp các chỉ số"                                             | AI quét toàn bộ báo cáo và data model trong Organization mà người dùng có quyền truy cập, trình bày thành báo cáo tổng hợp tất cả chỉ số tìm được. Hoạt động tốt nhất với mô hình Finance.                                                                                  |
| Talk to file                                                       | Tải file Excel và đặt câu hỏi hoặc yêu cầu tạo báo cáo từ dữ liệu | AI phân tích nội dung file do người dùng tải lên. File đã tải được lưu trong workspace của người dùng và có thể quản lý file trong thư viện (xoá hoặc chat lại)                                                                                                             |
| Prompt to report                                                   | "Tạo báo cáo mới"; "Thêm chart vào báo cáo"                       |                                                                                                                                                                                                                                                                             |
| AI Task scheduler                                                  |                                                                   | Người dùng cài đặt lịch hẹn, hệ thống tự động kích hoạt một câu lệnh và lưu kết quả vào một Chat riêng trên danh sách Chat để người dùng xem sau.                                                                                                                           |

### Chuẩn bị & Sử dụng

Vì bảo mật, AI Companion được thiết kế để:

* Chỉ truy cập những Data Model có bật cấu hình "cho phép đọc"
* Chỉ hoạt động nếu người dùng có quyền đọc Data Model và quyền truy vấn (query)
* Chỉ truy xuất được một phần dữ liệu trong Data Model mà người dùng được cấp quyền, nếu Data Model có cấu hình phân quyền theo dòng (Xem thêm [Data Row-Level Security](/chia-se-va-quan-ly-truy-cap/phan-quyen/data-row-level-security.md)).

#### Cấu hình Data Model

Người dùng truy cập mục Data Model, và bật "Enable for AI" trên model muốn cho phép AI Companion truy cập. Model không bật tuỳ chọn này, AI sẽ không thể đọc được cấu trúc bên trong.

<figure><img src="https://2137341912-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIwHpnhGKp0mcSL3nAcxD%2Fuploads%2Fe9prhZrXH69JD0rrC6LL%2Fai-companion-1.png?alt=media&amp;token=57491e33-f94c-44e1-bfaf-72f914767298" alt=""><figcaption></figcaption></figure>

#### Tạo User Role & User Group

Người dùng truy cập mục User Role ⇒ Add Role ⇒ Điền tên Role mới ⇒ Check vào 2 quyền (permission) sau:

* Read data model ⇒ cho phép đọc Data Model
* Query ⇒ cho phép gửi query truy vấn dữ liệu

<div><figure><img src="https://2137341912-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIwHpnhGKp0mcSL3nAcxD%2Fuploads%2FY51CMO3mGL4qO21icZGJ%2Fai-companion-2.png?alt=media&amp;token=6a1b065e-328d-45e7-b77c-e0869965e8fe" alt=""><figcaption></figcaption></figure> <figure><img src="https://2137341912-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIwHpnhGKp0mcSL3nAcxD%2Fuploads%2FF48F4jDKuGkkNsRyn9XE%2Fai-companion-3.png?alt=media&amp;token=0de66e7f-055d-447e-a3c6-7de72b1d3ada" alt=""><figcaption></figcaption></figure></div>

Người dùng tiếp tục truy cập mục User Group ⇒ Create User Group ⇒ Điền tên user group mới

Tại trang chi tiết User Group mới, mở tab System Roles ⇒ Chọn User Role có đủ 2 quyền "Read data model" và "Query" và gán cho user group ⇒ Save

<figure><img src="https://2137341912-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIwHpnhGKp0mcSL3nAcxD%2Fuploads%2Fm8xZU9wu3d9A4nelTaTQ%2Fai-companion-4.png?alt=media&amp;token=10a81ae5-9996-4ff2-b41e-e0a74e5ec092" alt=""><figcaption></figcaption></figure>

#### Cấp quyền User

Người dùng chuyển sang tab Assignments ⇒ Chọn người dùng trong workspace để thêm vào User Group ⇒ Save.

Lưu ý: Chỉ người dùng được thêm vào group này mới có đủ quyền để chat với AI Companion và truy vấn được dữ liệu.

<figure><img src="https://2137341912-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIwHpnhGKp0mcSL3nAcxD%2Fuploads%2Fp5oaD5dKgPZ1MVcwrBVs%2Fai-companion-5.png?alt=media&amp;token=e4220a7b-efd5-45ec-b849-e76709ded2be" alt=""><figcaption></figcaption></figure>

### Chat với AI Companion

Tại trang chủ, người dùng truy cập mục AI Companion trên menu chính, bên dưới mục Home để truy cập giao diện AI Companion.

Người dùng có thể đặt câu hỏi và tương tác với AI Companion theo bảng chức năng tại [#ai-companion-co-the-lam-gi](#ai-companion-co-the-lam-gi "mention")

<figure><img src="https://2137341912-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIwHpnhGKp0mcSL3nAcxD%2Fuploads%2FlwVRsOOf16fIqETQw39s%2Fai-companion-6.png?alt=media&amp;token=05b47625-fb56-4af7-8ba7-753fd49c8d40" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2137341912-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIwHpnhGKp0mcSL3nAcxD%2Fuploads%2FUHhAt3aS4KQa7uwdqvgX%2Fai-companion-8.png?alt=media&amp;token=9701de14-3b3e-4916-bceb-c8217a4a8169" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2137341912-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIwHpnhGKp0mcSL3nAcxD%2Fuploads%2FRv2oal7T9uoefhiqyMIV%2Fai-companion-7.png?alt=media&amp;token=ed671472-accf-47e3-b155-7efde6051a19" alt=""><figcaption></figcaption></figure>

### Lưu lượng & giới hạn

Tham khảo [Bảng giá Data Suite](https://datasuite.vn/bang-gia/).

### Tính năng sắp có (coming soon)

* Business Knowledge Base:
  * Cho phép quản lý kho kiến thức nghiệp vụ của Companion, giới hạn theo phạm vi toàn Organization hoặc một Data Model cụ thể
  * Kiểm duyệt rule do người dùng tự đặt cho Companion trong quá trình chat, người quản lý duyệt hoặc từ chối nạp vào kho kiến thức chung.