> 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/671b50c95d1d9869eb2868f6570d4b318bdcb966" alt="Custom Analytics"><figcaption></figcaption></figure>

***

## 重点亮点

* **向 AI 助手提问** 用自然语言获取你需要的库存数据。
* **构建自定义报表** 通过组合商品、属性、价格、日期范围、合作伙伴等条件。
* **保存常用报表** 这样你可以随时再次访问它们。
* **恢复较早版本** 使用内置版本历史记录查看报表的早期版本。
* **可视化你的数据** 通过图表展示，或导出到 Excel。

## 使用场景

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

<mark style="color:$primary;">`自定义分析`</mark> 让你更灵活地处理库存数据。只需向 **AI 助手** 说明你需要的数据，包括你想要的条件和列，即可在几秒内获得一份自定义报表。尤其适用于以下情况：

* 你无法从标准库存报表中获取所需数据
* 你想按商品、供应商、客户或团队成员等详细条件拆分数据
* 你需要比较不同时间段的数据，例如按月、按季度或同比
* 你需要特定数据来支持报告或决策

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

***

## 如何使用自定义分析

### 1. 打开 AI 助手

前往 <mark style="color:$primary;">`报表`</mark> > <mark style="color:$primary;">`自定义分析`</mark>.

如果这是你第一次， **AI** **助手** 会自动打开。否则，点击 <mark style="color:$primary;">`+ 新建报表`</mark> 开始新报表并向 AI 助手请求你需要的数据。

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

{% hint style="warning" %}
二者 **管理员** 和 **成员** 都可以创建和查看自定义报表。你可以通过设置 [自定义角色](/docs/documentation/zh/gai-nian/members.md#custom-roles-and-permissions).
{% endhint %}

### 2. 请求你的数据

向 <mark style="color:$primary;">`AI 助手`</mark> 用自然语言说明你需要的数据。

例如，输入： *“显示上周按类别划分的库存水平”* ，助手就会根据你的请求创建一份报表。

<figure><img src="/files/7229c19221f7d617fa932109a96c625248da31d6" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
尽可能具体地说明你想要的 **条件** 和 **列** 。你提供的细节越多，报表就越符合你的需求。
{% endhint %}

> “显示我上个月的销售数据。”\
> “按商品显示上个月的总销售数量和销售收入，按收入排序前 10 名。”

<figure><img src="/files/781f6b3dbc7d3be1bb37a9697e7547be3d1a6807" alt=""><figcaption></figcaption></figure>

如果你需要用不同的搜索值反复运行同一份报表，请让 AI 助手添加一个 **输入** **字段**。添加后，你每次都可以输入新值，而无需重新创建报表。

<figure><img src="/files/64887bd06b20c52271efe68cab20aa7955c16555" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
将 **输入** **字段** 用于经常变化的值，例如商品名称、日期或供应商。
{% endhint %}

### 3. 使用你的数据

结果会以表格形式显示。点击 <mark style="color:$primary;">`导出到 Excel`</mark> 可下载结果，或点击 <mark style="color:$primary;">`添加图表`</mark> 将其可视化为图表——支持柱状图、折线图、饼图、堆叠柱状图和堆叠面积图。

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

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

结果会自动保存到 <mark style="color:$primary;">`我的报表`</mark>，因此你可以随时再次打开并运行。如果你不小心做了更改，可以将报表回滚到较早版本——点击 <mark style="color:$primary;">`...`</mark> （更多）> <mark style="color:$primary;">`版本历史`</mark>.

<figure><img src="/files/81eb49f00d98b89629c3ce37a50983e3be73579c" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
你的数据会自动同步 **每天一次**。如需查看最新数据，请在运行报表前点击左下角的 **同步按钮** （🔄）。
{% endhint %}

{% hint style="warning" %}
对于具有多个状态的字段，例如 [订单状态](/docs/documentation/zh/zhu-yao-gong-neng/purchase-and-sales.md#purchase-order-status)，AI 的理解可能与你的本意不同。已删除的数据的处理方式也可能与预期不同。请务必在工作中使用前确认输出结果。
{% endhint %}

***

## 模板

自定义分析包含可立即运行的内置模板。试试某个模板看看结果。如果你觉得有用，点击 <mark style="color:$primary;">`保存到我的报表`</mark> 并根据需要进行调整。

<figure><img src="/files/6e9d9286f9526549439510a81347b4eceea0a2e4" alt=""><figcaption></figcaption></figure>

#### 示例

* 每日总库存
* 每周交易汇总
* 每月采购与销售趋势
* 按商品划分的最后缺货日期
* FIFO 库存估值
* 可用库存

***

## SQL 编辑

如果你熟悉 SQL，可以直接使用 [DuckDB SQL](https://duckdb.org/docs/current/sql/introduction) 语法编辑查询，按你想要的方式精确定制报表。

选择一个报表，点击右上角的 <mark style="color:$primary;">`...`</mark> 按钮，然后选择 <mark style="color:$primary;">`编辑 SQL`</mark>.

<figure><img src="/files/673523b2701acd2eaa66e58345fbb2e5a699debc" alt=""><figcaption></figcaption></figure>

你也可以通过在查询中包含 <mark style="color:$primary;">`{{variable_name}}`</mark> 来添加一个输入字段。例如：

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

这将创建一个 **输入** **字段** 名为 item\_name 的字段。输入一个关键词，例如 *sweater*，结果就会显示名称中包含“sweater”的每一项。

<figure><img src="/files/4e5a8ce3aa97ce988518c9a67434524920d8357c" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
在依赖结果之前，请务必先检查。
{% endhint %}

***

## 常见问题

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

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