说明
在当前的电商环境中,消费者的购物行为已发生深刻变化。用户不再仅仅满足于通过明确的关键词寻找商品,而是越来越多地倾向于在特定场景下,通过更自然、更口语化的方式表达自己的需求。例如:
利用 Viking AI 搜索就可以帮您快速打造一个能够理解自然语言、解析图片、并结合用户偏好进行智能推荐与对话的 “电商导购助手”,从而更好的提升用户体验,提升转化率
高质量、结构合理的数据是搭建一切智能导购体验的基础。Viking AI 搜索会深度解析您提供的每一个字段,构建丰富的语义和图片索引,建议您充分做好数据准备工作。
说明
字段选择策略:不要直接全量导入数据库字段。应以“用户视角”为核心,而非简单的“存档需求”。
筛选标准: 仅保留用户在搜索、筛选和决策时真正关注的信息(如核心规格、品牌、功能)。
清理噪声: 剔除冗长的 HTML 代码、重复或低价值数据**。**
以下是一份通用的电商行业核心字段表,建议包含以下关键信息,会对整体效果有帮助,如果缺失一些字段也不用担心,可以按您业务已有字段筛选后,上传就好。
⚠️您的实际字段名称无需与此完全一致,Viking AI 搜索在导入时会自动进行语义映射。
字段名(示例) | 用途与说明 | 字段属性建议 | 数据配置(详见步骤二说明) |
|---|---|---|---|
| 商品唯一标识 (必填)。用于唯一确定一个商品,是数据更新、行为关联、点击上报的唯一凭证。可以是 SKU ID 或 Product ID。 | 唯一标识 | |
| 商品标题。最核心的文本信息,是文本语义召回的主要信息源。 | 标题 | 用于文搜 |
| 商品详情/描述。包含商品的详细介绍、营销文案、材质、风格、设计理念、适用场景、适用人群等非结构化文本。这是 AI 理解商品的关键,内容越丰富,语义召回效果越好。 | 用于文搜 | |
| 商品图片 URL 列表。包含主图、细节图、场景图、模特上身图等。这是实现多模态搜索(以图搜图、文搜图)的基础。请务必提供可公网访问的图片链接。 | 图片链接 | 用于文搜,用于图搜 |
| 类目。可以有多个类目字段。如 "女装/连衣裙/长袖连衣裙",用于筛选和统计。 | 分类/类目 | 用于文搜,用于过滤 |
| 品牌。需要上传明文的品牌名称,而不是品牌对应的数字码。这样模型才能理解并应用到用户query匹配中。另外用户很可能在对话中想了解某个品牌,所以该字段也建议设为分类/类目属性,供模型更好的检索。 | 分类/类目 | 用于文搜,用于过滤 |
| 价格。用于筛选(如“500-1000元的手机”)和排序(如“价格从低到高”)。 | 用于过滤 | |
| 商品标签。如“显瘦”、“新品”、“设计师款”、“夏季热卖”等,是 | 用于文搜、用于过滤 | |
| 商品状态。如 "上架" (in_stock)、"下架" (out_of_stock),主要用于搜索时过滤掉不可售商品。 | 用于过滤 | |
| 商品更新时间。 商品上架时间或者更新时间,可以满足用户对“最新商品”等时间语义的解析 | 上新时间 | 用于过滤 |
在正式全量导入数据前,建议先用50-100 条有代表性的数据进行“跑通”测试,验证整个流程(字段配置、导入、索引构建、基础搜索)是否顺畅。
规范类型 | 具体说明 |
|---|---|
嵌套结构限制 | 系统支持最深 3 层的嵌套对象。过滤字段只能在 第 1 和第 2 层。第 3 层不支持过滤。如果您的 SKU 数据结构过于复杂,请在导入前进行扁平化处理。 |
数据类型一致性 | 同一数据集内,同名字段的类型必须严格一致(不能第一条数据 price 是 Int,第二条是 String),否则会导致索引构建失败。 |
参考火山引擎快速入门流程,我们将复杂的 AI 导购助手构建简化为四个核心步骤。
登录 Viking AI 搜索控制台,点击 “创建应用”。系统提供了预置的行业模版(如电商、内容社区等)。对于导购场景,务必选择**“电子商务”**行业,这将预加载适合电商场景的策略配置。填写应用名称后,即可进入下一步“数据集创建和导入”。
说明
title, content, tags)都应设为可被搜索。category, status, brand,以及数值类型的 price。完成上述步骤后,这时候您已经完成了搜索和问答能力的初始化构建,接下来主要是进行“体验调优”阶段。对话助手的底层能力依赖搜索返回的结果,配置一个好的电商导购助手,通常您需要同时调整搜索策略和对话问答策略。
说明
核心建议:不要追求一成不变的“模板化”配置。电商的不同细分行业(如服饰、3C、生鲜)、不同的商品规模,其最佳搜索策略都可能存在差异。比如美妆行业可能更看重 “新品” 和 “品牌”,而 3C 数码行业可能更看重 “参数匹配” 和 “价格”。因此,我们强烈推荐您将体验配置视为一个持续迭代的过程,并通过线上体验和用户反馈来评估和选择最优策略。
以下是电商导购场景中最常用的一些体验配置能力,您可以结合业务需求进行配置:
您可以根据一系列条件,动态地提升或降低特定商品的排序权重
常见应用场景:
product_rating 大于4.5(假设满分为5)的商品更高的排序权重。publish_time 在最近 7 天内的商品给予更高的排序权重。tags 包含“大促”或属于特定活动 ID 的商品进行提权。stock 大于 0 的商品进行提权,或对 stock 等于 0 的商品进行降权。以“优质商品提权”为例:
除了默认的相关性排序外,您还可以自主设置排序方式,比如:
sales_volume 字段降序排列。publish_time 字段降序排列,即“新品优先”。以“价格排序”为例:
如需了解更多搜索配置详情,请查阅官方文档:快速创建一个 Viking AI 搜索应用。
Viking AI 搜索通过 对话 Agent,将强大的 多模态搜索、个性化推荐与大语言模型(LLM)的对话能力封装在一起,让您能快速构建一个会聊天、懂商品、能引导的智能导购助手。在对话场景,我们建议您进行以下策略配置
您可以为您的导购助手设定一个独特的“身份及人设”。这虽然不直接改变搜索召回的商品,但极大地影响着用户体验和品牌感知。
Prompt 示例:
专业导购顾问(默认示例)
作为一个值得信赖的搜索助手,你需要保持严谨、客观的立场,致力于提供具有洞察力的内容推荐和详尽的信息解答。无论用户的查询多么复杂或细致,你都会竭尽全力,以高效和友好的态度协助用户找到所需。
时尚穿搭专家(风格化示例)
你是 {品牌名} 的电商时尚导购助手 {助手名称} ,是用户的「穿搭伙伴」和「风格顾问」。 你对 服装、配饰、面料、版型、流行趋势和穿搭场景 有很高的鉴赏能力,擅长将时尚变得好理解、好选择、好上身。 你性格开朗、热情、有审美判断力,善于共情用户的真实需求,既懂潮流,也懂日常。你不是只推商品,而是帮用户把“穿什么”这件事想清楚。 你的目标是:让用户买得安心、穿得好看、少踩雷,让每一次购物都更轻松、更有风格、更有被理解的感觉。
设定导购助手回答的结构、文风和语言。比如推荐商品原则、数量、范围、回答方式等,建议结合业务诉求进一步优化。
Prompt 示例:
专业导购顾问(默认示例)
清晰为先: 撰写清晰、有效且引人入胜的内容。 直截了当的语言:使用直接、明了的语言。避免使用行话、过于冗长的解释或口头禅式的填充词。 语气: 适当地保持热情、生动、富有同理心且不带偏见的语气。 逻辑清晰且结构化的回复:善用加粗、列表、段落来突出重点。长回复必须有清晰的结构层次,将过于复杂的内容提供简要准确的总结。”
结合具体业务策略(功能化)
一、商品推荐原则 每次推荐 最多精选 4 个商品,优先选择最符合用户核心需求的款式。 推荐的商品可能来自 同一商品的不同 SKU(如颜色、尺码、版型)。 对同一商品的不同规格 进行合并介绍与总结说明。 避免对同款商品的重复、冗余描述。 推荐时需说明: 适合的穿着场景。 风格特点与搭配建议。 版型 / 面料 / 实穿优势。 二、对话与表达风格 语气要求: 热情、生动、自然。 富有同理心与理解力。 不评判、不标签化用户的身材、审美或选择。 表达方式: 善用 加粗、列表、分段 突出重点。 长回复必须具备 清晰的结构层次。 当信息较复杂时,提供 简要、准确的总结,帮助用户快速决策 三、需求理解与延展 在推荐商品前: 仔细分析用户的提问或上传的图片。 判断其核心诉求与真实场景(如通勤、约会、出游、日常)。 在每次推荐后: 合理猜测用户的后续需求。 如:是否需要完整搭配。 是否在意显瘦、显高、好打理。 是否需要不同风格或颜色的备选。 通过自然引导,帮助用户继续探索更适合自己的穿搭选择。 四、无法完全满足需求时的处理方式 当当前商品无法完全满足用户需求时: 以 委婉、诚恳 的方式说明限制。 优先推荐: 同品类的替代方案(如不同颜色、版型、风格)。 相近风格或相近场景的商品。 始终以「尽量接近用户需求」为目标,避免简单拒绝或生硬转向。 五、核心目标 帮助用户: 更清楚自己适合什么。 更少试错、更快决策。 买到真正“会穿、常穿、好搭”的衣服。”
开场白是用户与助手交互的第一个触点,直接决定了用户的参与意愿。一个好的开场,能够有效降低用户的决策门槛,提升交互率。建议您按照业务策略,配置一个好的开场白,Viking AI 搜索提供三种可配置的开场模式:
纯文本开场
开场推荐问题
开场推荐商品:个性化推荐开场
除了商品库,您的企业通常可能还有大量非结构化的文档类知识,如“售后政策”、“退换货流程”、“尺码对照表”、“会员权益说明”等。通过知识库接些功能,您可以将这些文档上传,让导购助手也具备回答这类问题的能力。
配置流程:
为了提升多轮对话率,避免“一问一答”式的尬聊,强烈建议开启追问建议功能。
API 参数:在调用 ChatSearch 接口时,设置 enable_suggestion=true。
效果:当 AI 助手回答完一轮问题后,会根据上下文自动生成 3 个相关的追问建议气泡。如右图。
这个小功能极大地降低了用户的输入成本,能有效引导对话向更深层次发展,从而挖掘出用户更精确的需求。
问答能力整体配置也可参考如下视频指引:
当您在控制台完成体验配置后,如果您希望为其导入更多数据(例如导入完整数据或进行增量更新),请按以下步骤操作
在这里,您会看到系统提供的两种主要数据导入方式(通过 API 导入和导入本地JSONL文件),可用于后续的数据添加。
为了将构建好的能力集成到您的 App 、小程序或网页中,Viking AI 搜索 提供了标准的 API。以下是该接口的调用概要。
session_id(由前端生成和维护)以及一些固定参数(如 user_id)打包,发送给您的业务后端。/chat_search 接口的 POST 请求。API Key 进行鉴权。/chat_search 接口的响应。/chat_search 接口会陆续返回一系列 JSON 数据块。每个数据块都描述了 AI 助手当前的工作步骤(step),可能是 "意图识别"、"工具调用"(并附带搜索到的商品 payload)、"生成回答"(并附带一小段文本 content)。payload 中的商品列表,并将其渲染成用户可见的、可点击的商品卡片(包含图片、标题、价格、购买按钮等)。说明
为什么需要业务后端中转?
虽然前端可以直接调用 Viking AI 搜索 API,但我们强烈建议通过您的业务后端进行一层封装和转发。这样做有几个核心好处:
API Key 直接暴露在前端代码中。详细 API 接入指引请查看 ChatSearch - 对话搜索--全域AI搜索-火山引擎
在落地 AI 导购助手的过程中,我们总结了一些客户常见的配置问题和误区。提前了解并规避这些问题,能让您的接入过程更加顺畅。
常见问题 | 详细描述与影响 | 优化建议 |
|---|---|---|
数据源 URL 无法访问 | 导入的商品数据中, | 在数据导入前,务必编写脚本批量检查所有图片 URL 的公网可访问性,并剔除无效链接。 |
数据 Schema 不一致 | 同一个 JSONL 文件中,不同行的数据结构不一致。例如, | 严格统一数据类型。在数据导出环节就应强制约束 Schema。使用数据校验工具(如 |
图片质量问题 | 提供的图片尺寸过小(如小于 100x100 像素)、清晰度低,或包含大量与商品无关的干扰性水印。这会严重影响图片特征提取的质量,降低多模态搜索的准确率。 | 建议使用不小于 300x300 像素、清晰、无遮挡的主图或场景图。如果可能,提供多张不同角度的图片。 |
索引未完成就测试 | 导入大量数据后,索引构建需要一定时间。在此期间进行搜索测试,可能会得到不完整甚至空的结果,从而误判系统效果。 | 在控制台密切关注索引构建的状态。务必等到索引状态显示为“配置已生效”后,再开始全面的搜索体验测试。 |
过滤字段未标记 | 希望按品牌进行筛选,但在字段配置时忘记将 | 在数据准备阶段,就应规划好哪些字段未来可能用于筛选,并在配置时逐一确认,确保已勾选“用于过滤”。 |
分类/类目字段标记不全 | 在此产品中,分类/类目 是一个更广泛的概念,指商品的重要的可枚举值的字段,这些字段可以被模型自动推导成 符合用户意图的过滤条件。 | 常规理解的分类 |
有大字段 | 如果有特别长的字段导入,大幅增加了模型输入的信息量,整体接口耗时会增加,甚至因超时而返回失败。 | 具体分析大字段,看是否字段里的信息都有搜索价值。建议把没有价值的信息过滤掉,只上传有价值的信息。 |
最后,需要再次强调,Viking AI 搜索的最佳实践并非一成不变的教条,不同电商行业,甚至同一行业的不同发展阶段,对搜索的侧重点都有所不同,成功的电商导购助手,是优质数据、灵活策略和持续优化共同作用的结果。
说明