> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.boxhero.io/docs/documentation/vi/tinh-nang-khac/custom-analytics.md).

# Phân tích tùy chỉnh

<figure><img src="/files/62d180dc18eda65b4220c958e4d7adeeaae03d09" alt=""><figcaption></figcaption></figure>

***

## Điểm nổi bật chính

* Đặt câu hỏi bằng ngôn ngữ tự nhiên và **Trợ lý AI** sẽ viết SQL cho bạn.
* Dùng SQL để truy vấn dữ liệu BoxHero của bạn.
* Kết hợp các điều kiện (ví dụ: mặt hàng, thuộc tính, giá, khoảng ngày, đối tác) để xác định dữ liệu bạn muốn trả về dưới dạng báo cáo tùy chỉnh.
* Lưu các truy vấn bạn thường dùng và mở lại bất cứ lúc nào.
* Xuất kết quả sang Excel để phân tích hoặc báo cáo thêm.

## Các trường hợp sử dụng

Tính năng tiêu chuẩn <mark style="color:$primary;">`Báo cáo tồn kho`</mark> cho bạn cái nhìn nhanh về các chỉ số chính như số lượng tồn kho trung bình và vòng quay hàng tồn kho trong một khoảng thời gian đã chọn. Vì các báo cáo đó sử dụng công thức và trường được định nghĩa sẵn, chúng có thể không bao quát mọi loại phân tích mà nhóm của bạn cần.

<mark style="color:$primary;">`Phân tích tùy chỉnh`</mark> cho bạn nhiều quyền kiểm soát hơn về cách bạn khám phá dữ liệu. Nó đặc biệt hữu ích khi:

* Bạn không thể tìm thấy dữ liệu mình cần trong tính năng tiêu chuẩn [Báo cáo tồn kho](/docs/documentation/vi/tinh-nang-khac/analytics.md)
* Bạn muốn lọc hoặc nhóm dữ liệu theo mặt hàng, nhà cung cấp, khách hàng, thành viên nhóm hoặc các điều kiện chi tiết khác
* Bạn cần phân tích theo thời gian như theo tháng, theo quý hoặc so với cùng kỳ năm trước
* Bạn muốn lưu các báo cáo mình thường dùng và sử dụng lại
* Bạn cần dữ liệu linh hoạt để hỗ trợ báo cáo hoặc ra quyết định

***

## Cách sử dụng Phân tích tùy chỉnh

### 1. Bắt đầu

Đi đến <mark style="color:$primary;">`Báo cáo`</mark> > <mark style="color:$primary;">`Phân tích tùy chỉnh`</mark>. Điều này mở ra một không gian làm việc mới nơi bạn có thể tạo và quản lý các truy vấn SQL của mình. Sau đó, chọn <mark style="color:$primary;">`+ Mới`</mark> để tạo một truy vấn mới.

<figure><img src="/files/01d14a6abe788b9b77812edae1db1a9be56fc303" alt=""><figcaption></figcaption></figure>

### 2. Viết truy vấn

Bạn có hai cách để viết truy vấn:

1. **Dùng Trợ lý AI** để tạo SQL từ một câu hỏi bằng ngôn ngữ tự nhiên (khuyến nghị cho hầu hết người dùng).
2. **Viết SQL trực tiếp** dùng [DuckDB SQL](https://duckdb.org/docs/stable/sql/introduction).

<figure><img src="/files/a6fdc64d21b6d17a8229f8fa94731b847adccd92" alt=""><figcaption></figcaption></figure>

#### Khi dùng Trợ lý AI

Người <mark style="color:$primary;">`Trợ lý AI`</mark> biến các câu hỏi bằng ngôn ngữ tự nhiên thành các truy vấn SQL hoạt động. Bạn không cần biết SQL để sử dụng nó.&#x20;

Nhập câu hỏi của bạn vào bảng Trợ lý và nhấn Enter. Trợ lý sẽ tạo SQL, áp dụng vào trình soạn thảo và chạy nó. Kết quả sẽ xuất hiện bên dưới truy vấn.

Bạn có thể chỉnh sửa SQL đã tạo trước khi lưu nếu muốn điều chỉnh bất cứ điều gì.

{% embed url="<https://customer-0jrbilsa8yt3k758.cloudflarestream.com/38e5c1fa675d1d7f16b1d9e95a6aabd4/iframe?autoplay=true&controls=false&letterboxColor=transparent&loop=true&muted=true&poster=https://customer-0jrbilsa8yt3k758.cloudflarestream.com/38e5c1fa675d1d7f16b1d9e95a6aabd4/thumbnails/thumbnail.jpg?height=1080&preload=true>" %}

**Ví dụ câu hỏi**

* Các mặt hàng dưới mức tồn kho an toàn
* Những gì chưa bán trong 90 ngày qua?
* Top 10 SKU theo số lượng bán ra trong tháng này
* Các PO mở đã quá ngày dự kiến đến
* Mức tồn kho theo địa điểm&#x20;

#### Xây dựng các truy vấn có thể tái sử dụng

Bạn có thể yêu cầu trợ lý bao gồm các bộ lọc có thể điều chỉnh trong truy vấn, chẳng hạn như khoảng ngày hoặc tên đối tác. Trợ lý sử dụng Biến truy vấn để bạn có thể thay đổi đầu vào sau này mà không cần viết lại SQL.

Ví dụ, khi hỏi *"doanh số theo mặt hàng cho một khoảng ngày mà tôi có thể thay đổi"* sẽ tạo một truy vấn với biến ngày yêu cầu nhập liệu mỗi khi truy vấn chạy.

<figure><img src="/files/fb47c52442c9f748e8b2eae009f6daed068e3108" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Trợ lý AI hoạt động tốt nhất với **cụ thể** **các câu hỏi**. \
Thay vì *"cho tôi xem doanh số,"* hãy thử *"10 mặt hàng hàng đầu theo doanh thu trong tháng này."*
{% endhint %}

{% embed url="<https://customer-0jrbilsa8yt3k758.cloudflarestream.com/27509a71c500d77cd43f29409abe0d68/iframe?autoplay=true&controls=false&letterboxColor=transparent&loop=true&muted=true&poster=https://customer-0jrbilsa8yt3k758.cloudflarestream.com/27509a71c500d77cd43f29409abe0d68/thumbnails/thumbnail.jpg?height=1080&preload=true>" %}

{% hint style="success" %}
Nhấp vào <mark style="color:$primary;">`Biểu đồ`</mark> nút để trực quan hóa dữ liệu — hỗ trợ biểu đồ cột, đường, tròn, cột chồng, vùng chồng.
{% endhint %}

### 3. Lưu truy vấn

Chọn <mark style="color:$primary;">`Thực thi`</mark> để kiểm tra truy vấn của bạn. Vì kết quả phụ thuộc vào các điều kiện bạn viết, hãy xem lại đầu ra để xác nhận rằng nó khớp với điều bạn mong đợi.

Nếu bạn dự định sử dụng lại một truy vấn, hãy chọn <mark style="color:$primary;">`Lưu`</mark> ở góc trên bên phải. Các truy vấn đã lưu sẽ xuất hiện trong thanh bên trái, nơi bạn có thể mở và chạy chúng bất cứ lúc nào.

Sau khi truy vấn của bạn chạy thành công, bạn có thể xuất kết quả bằng <mark style="color:$primary;">`Xuất ra Excel`</mark>.

<figure><img src="/files/88c5d16ec60177712102e36b667fcd31a043577e" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Dữ liệu của bạn tự động đồng bộ **một lần mỗi ngày**.\
Để đồng bộ ngay, nhấp vào biểu tượng đồng bộ (🔄) ở cuối thanh bên.
{% endhint %}

***

## Biến truy vấn

Nếu bạn bao gồm `{{variable_name}}` trong truy vấn của bạn, một trường nhập sẽ tự động được tạo khi truy vấn chạy. Giá trị nhập vào trường đó sẽ được áp dụng cho biến trong truy vấn SQL của bạn.

Khi bạn lưu một truy vấn, các thành viên trong nhóm có thể nhập giá trị riêng của họ vào trường biến và chạy báo cáo bất cứ khi nào họ cần.

#### Ví dụ

1. Để tìm các mặt hàng chứa một từ khóa cụ thể, nhập truy vấn sau:

```sql
select sku, name 
from items 
where name ilike '%' || {{item_name}} || '%';
```

2. Khi bạn chạy truy vấn, một trường nhập có tên **item\_name** sẽ xuất hiện.

<figure><img src="/files/1b979de1bf18dcedfcd41f424341540917cddab1" alt=""><figcaption></figcaption></figure>

3. Nhập một từ khóa như *`sweater`* và kết quả sẽ hiển thị tất cả các mặt hàng có *“sweater”* trong tên của chúng.

<figure><img src="/files/196b7f065070c204b60dc1ee3e6a47d29f6812da" alt=""><figcaption></figcaption></figure>

4. Hãy lưu truy vấn nếu bạn định dùng lại. Bạn có thể chọn và tải các truy vấn đã lưu bất cứ lúc nào từ menu bên trái.

<figure><img src="/files/b4ab42619e22d5e891173f1b298aaa29cbe89495" alt=""><figcaption></figcaption></figure>

***

## Các ví dụ

Phân tích tùy chỉnh bao gồm các mẫu có sẵn mà bạn có thể chạy ngay. Hãy xem xét một mẫu để hiểu cách nó hoạt động, sau đó điều chỉnh nó hoặc tạo một truy vấn mới dựa trên nhu cầu của bạn.

#### Mẫu

* Báo cáo nhập/xuất tồn kho hàng tuần
* Xu hướng mua hàng và doanh số hàng tháng
* Ngày xuất hàng gần nhất theo mặt hàng

<figure><img src="/files/eb494603c0dd246022b0ee26ba28b57e13e2944b" alt=""><figcaption></figcaption></figure>

***

## Câu hỏi thường gặp

**Vẫn còn thắc mắc?** Xem Câu hỏi thường gặp về Phân tích tùy chỉnh của chúng tôi:

{% content-ref url="/spaces/ZTj6bpOuH6MmecGVGoNx/pages/32b7ef85c6395e7a344e78951196379093e55c39" %}
[Phân tích tùy chỉnh](/docs/faq/vi/bao-cao/phan-tich-tuy-chinh.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://www.boxhero.io/docs/documentation/vi/tinh-nang-khac/custom-analytics.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.