> 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).

# 自定义分析

向 AI 助手请求你需要的库存数据，并构建超越标准报表的自定义报表。可视化为图表、保存以便再次运行，或导出到 Excel。

<figure><img src="https://688782006-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2F8f2NEkEhdQsg9pez8Au6%2F03_Custom%20Analytics.png?alt=media&amp;token=85ad84c6-bc6f-40c3-a3e6-80facea29784" 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?poster=https%3A%2F%2Fcustomer-0jrbilsa8yt3k758.cloudflarestream.com%2F962c957b64db1649124faed7790e9ce9%2Fthumbnails%2Fthumbnail.jpg%3Fheight%3D1080%26time%3D12s&letterboxColor=transparent>" %}

***

## 如何使用自定义分析

### 1. 打开 AI 助手

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

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

<figure><img src="https://688782006-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2F1tkEUK9CKUExy7wD4Rz4%2Fcustom-analytics-new%20report.jpg?alt=media&amp;token=ee042537-ca08-4d8f-92ff-d8c6a9d50c27" 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="https://688782006-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FuApVLbVKfrsPKoqH127E%2Fcustom-analytics-ai%20assistant-question-1.jpg?alt=media&amp;token=17e162da-c125-480c-a8b7-70152de0a414" alt=""><figcaption></figcaption></figure>

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

> "显示我上个月的销售数据。"\
> "按物品显示上个月的总销量和销售收入，并按收入排名前 10。"

<figure><img src="https://688782006-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2Fl9jVsT9QdncYhqTCscK8%2Fcustom-analytics-ai%20assistant-question.jpg?alt=media&amp;token=32beddae-ad86-45a4-ab08-9d30a68afb84" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://688782006-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FY5rotdlFmesjUGZHW9BB%2Fcustom-analytics-input%20field.jpg?alt=media&amp;token=1e6b3b9f-7732-440a-8cb0-6445bc91c88e" alt=""><figcaption></figcaption></figure>

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

### 3. 使用你的数据

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

<figure><img src="https://688782006-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FGKTCDKf2LivE5oKusPyt%2Fcustom-analytics-results.jpg?alt=media&amp;token=62a657eb-3fd7-4bf7-8a14-3e24d741e771" alt=""><figcaption></figcaption></figure>

<figure><img src="https://688782006-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FiwGxjrQuzuWlQyRiPorT%2Fcustom-analytics-chart-settings.jpg?alt=media&amp;token=db3b4037-bf14-4681-a3d3-4ea794f1e8e7" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://688782006-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FYOGLUDtJo9FQPI1RlO2f%2Fcustom%20analytics-my%20reports-sync-version%20history.jpg?alt=media&amp;token=bb621083-03b6-4c1d-9a55-9c1477173c59" alt=""><figcaption></figcaption></figure>

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

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

***

## 模板

自定义分析包含可直接运行的内置模板。试用一个模板看看结果。如果你觉得有用，请点击 <mark style="color:$primary;">`保存到我的报告`</mark> 并进行调整以满足你的需求。

<figure><img src="https://688782006-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FD55hFLgh6bZtpuqsZOSJ%2Fcustom-analytics-templates.jpg?alt=media&amp;token=f368d8d7-3a59-41d4-8490-982fdd80853b" 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="https://688782006-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FuRvm3pRez0cVPJVabxNv%2Fcustom-analytics-edit-SQL.jpg?alt=media&amp;token=11916f5f-552f-4423-8365-8974ebd1351d" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://688782006-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FVdQgFGRBpnXK42JGTr9r%2Fcustom%20analtyics-edit%20SQL.jpg?alt=media&amp;token=7d92eaeb-c29e-486c-8381-75c35d5dd826" alt=""><figcaption></figcaption></figure>

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

***

## 常见问题

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

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