# 产品目录与推荐

**Flow Agents → AI Knowledge Hub** 中的 **Product** 磁贴存放你的产品目录——你所售卖的每件商品的名称、价格和详情。目录填好后，每当客户询问——"有没有……""……多少钱""哪一款最便宜？"——你的 Flow 智能体就会推荐真实的产品和真实的价格，无论客户用哪种语言提问，即使产品名拼错了也没问题。

## 逐个添加产品

打开 **Product** 磁贴并点击 **Add entry**。每个产品包含：

* **Product name** — 商品名称，例如 *Widget Pro 2024*。
* **Description** — 简短的产品描述。
* **Price** 和 **Currency**。
* **Remarks** — 规格和属性，例如 *Color: Red, Year: 2023, Aluminium*。

把区分相似商品的细节——型号年份、颜色、尺寸、存储容量——写进名称或 remarks。这样当客户问得具体时，AI 能选中确切的型号；当客户问得不具体时，AI 会追问他们指的是哪一款。

## 导入你的价格表

目录较大时，点击 **Import CSV/Excel**，上传你现成的文件——从 POS 导出的、或用电子表格维护的 CSV / Excel (.xlsx) 价格表。无需先重新排版：

1. **Choose file** — 如果从零开始，可点击 **Download example CSV**。

2. **匹配列。**文件中的每一列都会匹配到一个产品字段——**Product name**、**SKU / item code**、**Price**、**Currency**、**Description**、**Remarks**。匹配会自动帮你猜好；未匹配的列会设为 **Add to remarks**，数据不会丢失；不需要的列可以设为 **Skip this column**。

   ![将文件列匹配到产品字段](../../.gitbook/assets/guides/product-import-mapping.jpg)

3. **Preview changes。**在任何改动发生之前，你会清楚看到这次上传将做什么。

   ![预览上传将带来的变化](../../.gitbook/assets/guides/product-import-preview.jpg)

4. **Apply changes。**导入在后台进行——完成后会收到通知，例如 *Product import finished: 24 added, 3 updated, 1 removed.*

价格可以保留文件里原本的格式（例如 *RM 3,299.00*）——导入时会自动整理。

## 保持目录同步

你的文件就是唯一依据。价格变动或商品增减时，只需再次上传同一文件的最新版本：

* 目录中已有的产品会**原地更新**。
* **文件里没有的产品会被移除**——预览会在你确认前逐个列出它们的名称。
* 在你点击 **Apply changes** 之前，什么都不会改变。

两个让同步更可靠的小贴士：

* **加一列 SKU / item code。**SKU 是重新上传时识别已改名产品的依据。没有 SKU 时，产品按名称完全一致来匹配。
* **保持名称唯一**（或使用 SKU）。如果两行同名且没有 SKU，只有第一行会被导入——预览会在 *row(s) can't be imported* 下标出其余行及其行号，方便你修正文件。

## 在流程中推荐产品

你完全不需要改动流程——目录建好后，客户随时问到产品，智能体都会作答，然后继续原来的流程。

想在特定时刻推荐——比如刚问完客户想找什么之后——可以打开流程设计器，选中该步骤，在步骤的 **Tool** 区域把 **Tool type** 设为 **Product**。该步骤随后会从你的产品目录实时推荐：真实的名称和价格，基于客户的需要。也可以把 **Search from variable** 设为流程收集的某个变量（例如 *product\_need*）；留空则根据客户最新的消息搜索。

注意：AI 需要一个 OpenAI API 密钥（在 **Settings → Integrations → AI Providers** 下添加）才能搜索并使用你的目录。

## 相关

* [管理 AI 知识](/flow-agents/managing-ai-knowledge)
* [搭建对话流程](/flow-agents/building-the-conversation-flow)
* [Flow 智能体与 AI 知识](/flow-agents/flow-agents-ai-knowledge)

---
Source: https://help.mampuai.com/zh/flow-agents/product-catalogue-and-recommendations