> 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/zh/qi-ta-gong-neng/custom-analytics.md).

# 自定义分析

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

***

## 主要亮点

* 用通俗语言提问， **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>

***

## 常见问题

**还有疑问吗？** 查看我们的自定义分析常见问题：

{% content-ref url="/spaces/1XHeAQmLMHSILvJsICC2/pages/f969c55dc2ca18b5d0d3b15257518ca5bfd811ea" %}
[自定义分析](/docs/faq/zh/bao-biao/zi-ding-yi-fen-xi.md)
{% endcontent-ref %}