# 自定义分析

<figure><img src="/files/85c3d9c9351f9e6c3c5d1291856c77faa0c607fe" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %} <mark style="color:$primary;">`自定义分析`</mark> 当前处于 **测试版**。\
在正式发布后，它将成为付费功能。
{% endhint %}

***

## 重点亮点

* 您可以用自然语言提问， **AI 助手** 会为您编写 SQL。
* 使用 SQL 查询您的 BoxHero 数据。
* 结合条件（例如：商品、属性、价格、日期范围、合作伙伴）来定义您想要作为自定义报表返回的数据。
* 保存您经常使用的查询，并可随时再次打开。
* 将结果导出到 Excel 以进行进一步分析或报告。

## 使用场景

标准的 <mark style="color:$primary;">`库存报表`</mark> 功能可让您快速查看所选期间的平均库存数量和库存周转率等关键指标。由于这些报表使用预定义的公式和字段，它们可能无法覆盖您团队所需的所有分析类型。

<mark style="color:$primary;">`自定义分析`</mark> 让您更灵活地控制如何探索数据。它在以下情况下尤其有用：

* 您在标准的 [库存报表](/docs/documentation/zh/qi-ta-gong-neng/analytics.md)
* 中找不到所需数据
* 您希望按商品、供应商、客户、团队成员或其他详细条件筛选或分组数据
* 您需要按月、按季度或同比等时间维度分析
* 您希望保存常用报表并再次使用

***

## 如何使用自定义分析

### 1. 开始使用

前往 <mark style="color:$primary;">`报表`</mark> > <mark style="color:$primary;">`自定义分析`</mark>。这将打开一个新的工作区，您可以在其中创建和管理 SQL 查询。然后选择 <mark style="color:$primary;">`+ 新建`</mark> 来创建新的查询。

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

### 2. 编写查询

您有两种方式编写查询：

1. **使用 AI 助手** 根据自然语言问题生成 SQL（推荐给大多数用户）。
2. **直接编写 SQL** 使用 [DuckDB SQL](https://duckdb.org/docs/stable/sql/introduction).

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

#### 使用 AI 助手

该 <mark style="color:$primary;">`AI 助手`</mark> 可将自然语言问题转换为可运行的 SQL 查询。使用它时您无需懂 SQL。&#x20;

在助手面板中输入您的问题并按回车。助手会生成 SQL，将其应用到编辑器中并运行它。结果会显示在查询下方。

如果您想调整任何内容，可以在保存前编辑生成的 SQL。

{% 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>" %}

**示例问题**

* `低于安全库存水平的商品`
* `过去 90 天没有售出的是什么？`
* `本月销量前 10 的 SKU`
* `已超过预计到货日期的未完成采购订单`
* `按地点划分的库存水平`&#x20;

#### 构建可复用查询

您可以请助手在查询中包含可调整的筛选条件，例如日期范围或合作伙伴名称。助手会使用查询变量，因此您之后可以更改输入，而无需重写 SQL。

例如，提问 *“我可以更改日期范围的商品销售”* 会生成一个带日期变量的查询，每次运行查询时都会提示输入。

<figure><img src="/files/14e12c4e8246bf279e4e7c482c7509ca21e4d843" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
AI 助手最适合处理 **具体的** **问题**。\
不要用 *“显示我的销售额，”* 而要尝试 *“本月按收入排名前 10 的商品。”*
{% 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" %}
点击 <mark style="color:$primary;">`图表`</mark> 按钮可将数据可视化——支持柱状图、折线图、饼图、堆叠柱状图和堆叠面积图。
{% endhint %}

### 3. 保存查询

选择 <mark style="color:$primary;">`执行`</mark> 来测试您的查询。由于结果取决于您编写的条件，请检查输出以确认其符合您的预期。

如果您打算重复使用查询，请选择 <mark style="color:$primary;">`保存`</mark> 在右上角。已保存的查询会显示在左侧边栏中，您可以随时打开并运行它们。

查询成功运行后，您可以使用 <mark style="color:$primary;">`导出到 Excel`</mark>.

<figure><img src="/files/24174802f4f520305f2859e01d12e6248573272b" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
您的数据会自动同步 **每天一次**。\
如需立即同步，请点击侧边栏底部的同步图标（🔄）。
{% endhint %}

***

## 查询变量

如果您在查询中包含 `{{variable_name}}` ，当查询运行时会自动生成一个输入字段。该字段中输入的值会应用到 SQL 查询中的变量。

保存查询后，您的团队成员可以在变量字段中输入自己的值，并在需要时运行报表。

#### 示例

1. 要搜索包含特定关键词的商品，请输入以下查询：

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

2. 当您运行查询时，一个名为 **item\_name** 的输入字段会出现。

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

3. 输入一个关键词，例如 *`sweater`* 结果将显示名称中包含 *“sweater”* 的所有商品。

<figure><img src="/files/9ad6ab46f764a3e936e853bddf61e9a0e177efd8" alt=""><figcaption></figcaption></figure>

4. 如果您打算再次使用该查询，请保存它。您可以随时从左侧菜单中选择并加载已保存的查询。

<figure><img src="/files/3f0c547daa69b81e10e23927bdfef0f3b4826352" alt=""><figcaption></figcaption></figure>

***

## 示例

自定义分析包含可立即运行的内置模板。请先查看模板以了解其工作原理，然后根据需要进行调整或基于您的需求创建新查询。

#### 模板

* 每周库存出入报表
* 月度采购与销售趋势
* 按商品统计的上次出库日期

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

***

**还有更多问题？** 请查看我们的自定义分析 FAQ：

{% content-ref url="/spaces/mkYNU2xLl20GSI6NQQ6q/pages/JZKqCEfW9v3ZHGye2PVO" %}
[Custom analytics](/docs/faq/reporting/custom-analytics.md)
{% endcontent-ref %}


---

# Agent Instructions: 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:

```
GET https://www.boxhero.io/docs/documentation/zh/qi-ta-gong-neng/custom-analytics.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.