You need to enable JavaScript to run this app.
文档中心
Viking AI 搜索

Viking AI 搜索

复制全文
下载 pdf
最佳实践
基于 Viking AI 搜索构建“专家级”电商导购 Agent 最佳实践
复制全文
下载 pdf
基于 Viking AI 搜索构建“专家级”电商导购 Agent 最佳实践

说明

  • 本文档旨在为电商行业的业务、产品、运营及技术团队提供一份详尽的 Viking AI 搜索 AI 导购助手 落地实践指南。我们将结合电商导购场景下的具体需求,系统性地介绍从数据处理、体验配置到智能对话助手搭建的全流程最佳实践。
  • 了解更多 Viking AI 搜索产品能力,请参见:Viking AI 搜索,企业搜推问一体化智能引擎

一、业务背景:从“关键词搜索”到“场景化智能导购”

在当前的电商环境中,消费者的购物行为已发生深刻变化。用户不再仅仅满足于通过明确的关键词寻找商品,而是越来越多地倾向于在特定场景下,通过更自然、更口语化的方式表达自己的需求。例如:

  • 场景化购物:“下周要去海边度假,求推荐一套适合拍照的防晒服穿搭。”
  • 多条件检索:“想找一款适合送给女朋友的生日礼物,预算200 左右,她喜欢粉色,最好是裙子。”
  • 图文混合检索:“有没有类似这种法式复古风格的裙子?”(并附上一张图片)

利用 Viking AI 搜索就可以帮您快速打造一个能够理解自然语言、解析图片、并结合用户偏好进行智能推荐与对话的 “电商导购助手”,​从而更好的提升用户体验,提升转化率

二、前期数据准备

高质量、结构合理的数据是搭建一切智能导购体验的基础。Viking AI 搜索会深度解析您提供的每一个字段,构建丰富的语义和图片索引,建议您充分做好数据准备工作。

数据字段选择:从“有什么”到“怎么用”

说明

字段选择策略:​不要直接全量导入数据库字段。应以“用户视角”为核心,而非简单的“存档需求”。
筛选标准: 仅保留用户在搜索、筛选和决策时真正关注的信息(如核心规格、品牌、功能)。
清理噪声: 剔除冗长的 HTML 代码、重复或低价值数据**。**

以下是一份通用的电商行业核心字段表,建议包含以下关键信息,会对整体效果有帮助,如果缺失一些字段也不用担心,可以按您业务已有字段筛选后,上传就好。
⚠️您的实际字段名称无需与此完全一致,Viking AI 搜索在导入时会自动进行语义映射

字段名(示例)

用途与说明

字段属性建议

数据配置(详见步骤二说明)

item_id

商品唯一标识 (必填)。用于唯一确定一个商品,是数据更新、行为关联、点击上报的唯一凭证。可以是 SKU ID 或 Product ID。

唯一标识

title

商品标题。最核心的文本信息,是文本语义召回的主要信息源。

标题

用于文搜

content

商品详情/描述。包含商品的详细介绍、营销文案、材质、风格、设计理念、适用场景、适用人群等非结构化文本。这是 AI 理解商品的关键,内容越丰富,语义召回效果越好。

用于文搜

images

商品图片 URL 列表。包含主图、细节图、场景图、模特上身图等。这是实现多模态搜索(以图搜图、文搜图)的基础。请务必提供可公网访问的图片链接。
为保证向量化效果,建议图片清晰、主体突出。图片尺寸建议不低于 300x300 像素,大小控制在 5MB 以内。过大或过小的图片会影响处理效率和效果。

图片链接

用于文搜,用于图搜

category

类目。可以有多个类目字段。如 "女装/连衣裙/长袖连衣裙",用于筛选和统计。

分类/类目

用于文搜,用于过滤

brand

品牌。需要上传明文的品牌名称,而不是品牌对应的数字码。这样模型才能理解并应用到用户query匹配中。另外用户很可能在对话中想了解某个品牌,所以该字段也建议设为分类/类目属性,供模型更好的检索。

分类/类目

用于文搜,用于过滤

price

价格。用于筛选(如“500-1000元的手机”)和排序(如“价格从低到高”)。

用于过滤

tags

商品标签。如“显瘦”、“新品”、“设计师款”、“夏季热卖”等,是 titlecontent 的有效补充,非常适合用于语义召回和筛选。

用于文搜、用于过滤

status

商品状态。如 "上架" (in_stock)、"下架" (out_of_stock),主要用于搜索时过滤掉不可售商品。

用于过滤

publish_time

商品更新时间。 商品上架时间或者更新时间,可以满足用户对“最新商品”等时间语义的解析

上新时间

用于过滤

样例数据

在正式全量导入数据前,建议先用50-100 条有代表性的数据进行“跑通”测试,验证整个流程(字段配置、导入、索引构建、基础搜索)是否顺畅。

电商产品数据示例.jsonl
未知大小

其他数据规范与建议:

规范类型

具体说明

嵌套结构限制

系统支持最深 3 层的嵌套对象。过滤字段只能在 第 1 和第 2 层。第 3 层不支持过滤。如果您的 SKU 数据结构过于复杂,请在导入前进行扁平化处理。

数据类型一致性

同一数据集内,同名字段的类型必须严格一致(不能第一条数据 price 是 Int,第二条是 String),否则会导致索引构建失败。

三、四步轻松搭建 AI 导购助手

参考火山引擎快速入门流程,我们将复杂的 AI 导购助手构建简化为四个核心步骤。

步骤一:创建应用

登录 Viking AI 搜索控制台,点击 “创建应用”。系统提供了预置的行业模版(如电商、内容社区等)。对于导购场景,务必选择**“电子商务”​**行业,这将预加载适合电商场景的策略配置。填写应用名称后,即可进入下一步“数据集创建和导入”。

步骤二:控制台导入数据样例和配置

  1. 新建图文数据集,选择商品标签,导入样例数据,可以导入先前准备好的 JSONL 格式文件。
  2. 字段属性与索引配置,大模型会自动扫描样例数据,推断字段类型、含义和配置方式,您可以手动校准,这直接决定了搜索效果,从而间接影响导购场景效果。
  3. 数据导入后,系统会开始进行大模型数据解析和索引构建(需要一定时间,请您耐心等待),完成后数据集状态会显示**“配置已生效”**,此时您可以到“体验配置”界面进行多模态搜索和对话式问答体验

说明

数据配置参考:

  • 唯一标识必须指定一个。这是整个系统的“身份证”,所有数据更新和关联都依赖此 ID。
  • 用于文搜:勾选此项后,搜索时使用字段内容中的语义信息和关键词信息与用户查询语句匹配,支持文本。通常所有包含丰富语义信息的字段(如 title, content, tags)都应设为可被搜索。
  • 用于图搜:​如果您要实现以图搜图的效果,建议对应商品的图片字段同时勾选用于文搜和用于图搜,这样系统会对图片进行向量化和 VLM 理解。
  • 用于过滤:勾选此项后,该字段才能在搜索时作为过滤条件。适合那些具有明确、可枚举值的字段,如 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 搜索应用

对话问答( AI 导购助手)配置

Viking AI 搜索通过 对话 Agent,将强大的 多模态搜索、个性化推荐与大语言模型(LLM)的对话能力封装在一起,让您能快速构建一个会聊天、懂商品、能引导的智能导购助手。在对话场景,我们建议您进行以下策略配置

角色设定

您可以为您的导购助手设定一个独特的“身份及人设”。这虽然不直接改变搜索召回的商品,但极大地影响着用户体验和品牌感知。
Prompt 示例:

专业导购顾问(默认示例)

作为一个值得信赖的搜索助手,你需要保持严谨、客观的立场,致力于提供具有洞察力的内容推荐和详尽的信息解答。无论用户的查询多么复杂或细致,你都会竭尽全力,以高效和友好的态度协助用户找到所需。

时尚穿搭专家(风格化示例)

你是 {品牌名} 的电商时尚导购助手 {助手名称} ,是用户的「穿搭伙伴」和「风格顾问」。
你对 服装、配饰、面料、版型、流行趋势和穿搭场景 有很高的鉴赏能力,擅长将时尚变得好理解、好选择、好上身。
你性格开朗、热情、有审美判断力,善于共情用户的真实需求,既懂潮流,也懂日常。你不是只推商品,而是帮用户把“穿什么”这件事想清楚。
你的目标是:让用户买得安心、穿得好看、少踩雷,让每一次购物都更轻松、更有风格、更有被理解的感觉。

回答风格设定

设定导购助手回答的结构、文风和语言。比如推荐商品原则、数量、范围、回答方式等,建议结合业务诉求进一步优化。
Prompt 示例:

专业导购顾问(默认示例)

清晰为先: 撰写清晰、有效且引人入胜的内容。
直截了当的语言:使用直接、明了的语言。避免使用行话、过于冗长的解释或口头禅式的填充词。
语气: 适当地保持热情、生动、富有同理心且不带偏见的语气。
逻辑清晰且结构化的回复:善用加粗、列表、段落来突出重点。长回复必须有清晰的结构层次,将过于复杂的内容提供简要准确的总结。”

结合具体业务策略(功能化)

一、商品推荐原则
每次推荐 最多精选 4 个商品,优先选择最符合用户核心需求的款式。
推荐的商品可能来自 同一商品的不同 SKU(如颜色、尺码、版型)。
对同一商品的不同规格 进行合并介绍与总结说明。
避免对同款商品的重复、冗余描述。
推荐时需说明:
适合的穿着场景。
风格特点与搭配建议。
版型 / 面料 / 实穿优势。
二、对话与表达风格
语气要求:
热情、生动、自然。
富有同理心与理解力。
不评判、不标签化用户的身材、审美或选择。
表达方式:
善用 加粗、列表、分段 突出重点。
长回复必须具备 清晰的结构层次。
当信息较复杂时,提供 简要、准确的总结,帮助用户快速决策
三、需求理解与延展
在推荐商品前:
仔细分析用户的提问或上传的图片。
判断其核心诉求与真实场景(如通勤、约会、出游、日常)。
在每次推荐后:
合理猜测用户的后续需求。
如:是否需要完整搭配。
是否在意显瘦、显高、好打理。
是否需要不同风格或颜色的备选。
通过自然引导,帮助用户继续探索更适合自己的穿搭选择。
四、无法完全满足需求时的处理方式
当当前商品无法完全满足用户需求时:
以 委婉、诚恳 的方式说明限制。
优先推荐:
同品类的替代方案(如不同颜色、版型、风格)。
相近风格或相近场景的商品。
始终以「尽量接近用户需求」为目标,避免简单拒绝或生硬转向。
五、核心目标
帮助用户:
更清楚自己适合什么。
更少试错、更快决策。
买到真正“会穿、常穿、好搭”的衣服。”

对话开场配置:交互的第一印象

开场白是用户与助手交互的第一个触点,直接决定了用户的参与意愿。一个好的开场,能够有效降低用户的决策门槛,提升交互率。建议您按照业务策略,配置一个好的开场白,Viking AI 搜索提供三种可配置的开场模式:
纯文本开场

  • 适用场景:最简单、直接的启动方式。
  • 示例话术:“您好!我是您的专属 AI 导购,想找点什么?可以随时向我提问哦~”

开场推荐问题

  • 适用场景:当您希望主动引导用户探索时,通过提供几个热门或有趣的问题“气泡”,降低用户的输入门槛。
  • 问题来源:​系统会在您配置好问答场景的第二天,自动生产相关推荐问题,同时您也可以结合业务运营需求自定义开场问题
  • 自定义问题配置示例:如:“推荐一些适合春节的穿搭”

开场推荐商品:个性化推荐开场

  • 适用场景:实现主动营销和“千人千面”的极致个性化体验。
  • 前置依赖:必须已接入用户的行为数据,并配置好推荐场景(如“猜你喜欢”),推荐配置请查看配置个性化推荐章节
  • 配置示例:开启“开场推荐物品”,并选择关联的首页推荐场景

补充知识库:增强导购能力

除了商品库,您的企业通常可能还有大量非结构化的文档类知识,如“售后政策”、“退换货流程”、“尺码对照表”、“会员权益说明”等。通过知识库接些功能,您可以将这些文档上传,让导购助手也具备回答这类问题的能力。

配置流程

  1. 在控制台上传您的知识文档(支持 PDF、Word、TXT 等格式,详细支持格式见文档数据集--全域AI搜索-火山引擎)。
  2. 系统会自动对文档进行切片、向量化处理。
  3. 当用户提出“你们支持 7 天无理由退货吗?”这类非商品查询时,AI 助手会优先从上传的文档中检索相关信息,并生成精准回答。

追问建议

为了提升多轮对话率,避免“一问一答”式的尬聊,强烈建议开启追问建议功能。

API 参数:在调用 ChatSearch 接口时,设置 enable_suggestion=true
效果:当 AI 助手回答完一轮问题后,会根据上下文自动生成 3 个相关的追问建议气泡。如右图。
这个小功能极大地降低了用户的输入成本,能有效引导对话向更深层次发展,从而挖掘出用户更精确的需求。

问答能力整体配置也可参考如下视频指引:

上传全量商品数据

当您在控制台完成体验配置后,如果您希望为其导入更多数据(例如导入完整数据或进行增量更新),请按以下步骤操作

  1. 返回到您的数据集列表
  2. 找到您想要添加数据的目标数据集
  3. 点击查看进入该数据集的详情页面。
  4. 在该页面中,找到并切换到 数据导入标签页。

在这里,您会看到系统提供的两种主要数据导入方式(通过 API 导入导入本地JSONL文件),可用于后续的数据添加。

  1. 导入本地 JSONL 文件
    1. 您可以直接在控制台界面上操作,通过点击/拖拽上传文件。
  2. 通过 API 实时导入接口
    1. API 文档链接实时导入、更新物品数据--全域AI搜索-火山引擎
    2. 适用场景
      1. 实时新增物品:自动处理与索引构建。耗时几秒至几十秒(多图/视频数据处理时间较长)。
      2. 实时更新物品:支持仅更新部分字段。若仅更新过滤字段(非检索字段),秒级生效;若更新图文视频,处理时间较长。
  3. 通过 API 批量导入接口
    1. API 文档链接批量导入物品数据--全域AI搜索-火山引擎
    2. 适用场景
      1. 首次全量构建:一次性导入完整的测试或生产环境的商品/内容数据。
      2. 定期大批量更新:针对超过 10 万条数据的特定字段更新(如批量变更上下架状态)。
      3. 新增字段回填:为全量数据批量写入新增加的字段值。

集成对话 API

为了将构建好的能力集成到您的 App 、小程序或网页中,Viking AI 搜索 提供了标准的 API。以下是该接口的调用概要。

  1. 前端发起请求
    • 用户在对话框中输入问题(如“推荐几款透气的跑鞋”)或上传图片。
    • 前端应用将用户的输入内容、当前会话的 session_id(由前端生成和维护)以及一些固定参数(如 user_id)打包,发送给您的业务后端。
  2. 业务后端调用 Viking AI 搜索
    • 您的业务后端接收到前端请求后,构造一个对 Viking AI 搜索 /chat_search 接口的 POST 请求。
    • 请求体中包含了从前端获取的所有信息,并附加上您的应用 API Key 进行鉴权。
    • 关键点:业务后端需要以流式的方式接收 /chat_search 接口的响应。
  3. 处理流式响应并转发前端
    • /chat_search 接口会陆续返回一系列 JSON 数据块。每个数据块都描述了 AI 助手当前的工作步骤(step),可能是 "意图识别"、"工具调用"(并附带搜索到的商品 payload)、"生成回答"(并附带一小段文本 content)。
    • 您的业务后端需要实时解析这些数据块,并原封不动地通过流式连接转发给前端
  4. 前端渲染丰富的交互界面
    • 前端接收到从业务后端转发来的数据流。
    • 当收到文本流时,以“打字机”效果实时渲染 AI 的回复文字。
    • 当收到商品数据时,解析 payload 中的商品列表,并将其渲染成用户可见的、可点击的商品卡片(包含图片、标题、价格、购买按钮等)。
    • 当收到追问建议数据时,将其渲染成可点击的建议气泡。
    • 如此,一个包含文本、商品卡片、建议气泡的丰富交互界面就动态地呈现在用户面前了。

说明

为什么需要业务后端中转?
虽然前端可以直接调用 Viking AI 搜索 API,但我们强烈建议通过您的业务后端进行一层封装和转发。这样做有几个核心好处:

  1. 安全:避免将您的 API Key 直接暴露在前端代码中。
  2. 鉴权与流控:您可以在业务后端实现自己的用户鉴权、请求频率控制等逻辑。
  3. 逻辑聚合:未来如果需要聚合其他内部服务(如查询订单、领取优惠券),都可以在后端统一处理,对前端保持接口的稳定性。

详细 API 接入指引请查看 ChatSearch - 对话搜索--全域AI搜索-火山引擎

常见问题与优化建议

在落地 AI 导购助手的过程中,我们总结了一些客户常见的配置问题和误区。提前了解并规避这些问题,能让您的接入过程更加顺畅。

常见问题

详细描述与影响

优化建议

数据源 URL 无法访问

导入的商品数据中,images 字段的图片 URL 是内网地址或已失效。这会导致 AI 搜索无法抓取图片,该商品将丢失所有视觉信息,无法被“以图搜图”或“文搜图”召回。

在数据导入前,务必编写脚本批量检查所有图片 URL 的公网可访问性,并剔除无效链接。

数据 Schema 不一致

同一个 JSONL 文件中,不同行的数据结构不一致。例如,price 字段有时是数字 199,有时是字符串 "199.00"。这将直接导致数据导入任务失败。

严格统一数据类型。在数据导出环节就应强制约束 Schema。使用数据校验工具(如 jsonschema)在导入前进行检查。

图片质量问题

提供的图片尺寸过小(如小于 100x100 像素)、清晰度低,或包含大量与商品无关的干扰性水印。这会严重影响图片特征提取的质量,降低多模态搜索的准确率。

建议使用不小于 300x300 像素、清晰、无遮挡的主图或场景图。如果可能,提供多张不同角度的图片。

索引未完成就测试

导入大量数据后,索引构建需要一定时间。在此期间进行搜索测试,可能会得到不完整甚至空的结果,从而误判系统效果。

在控制台密切关注索引构建的状态。务必等到索引状态显示为“配置已生效”后,再开始全面的搜索体验测试。

过滤字段未标记

希望按品牌进行筛选,但在字段配置时忘记将 brand 字段勾选为“用于过滤”。这将导致在调用 API 时,使用 brand 进行 filter 会报错或无效。

在数据准备阶段,就应规划好哪些字段未来可能用于筛选,并在配置时逐一确认,确保已勾选“用于过滤”。

分类/类目字段标记不全

在此产品中,分类/类目 是一个更广泛的概念,指商品的重要的可枚举值的字段,这些字段可以被模型自动推导成 符合用户意图的过滤条件。

常规理解的分类美妆数码可以标识为分类/类目。,若其他的维度信息也希望能在对话query中解析出来,比如解析出 用户想了解的是某个品牌的信息,也建议把品牌字段标记为分类/类目

有大字段

如果有特别长的字段导入,大幅增加了模型输入的信息量,整体接口耗时会增加,甚至因超时而返回失败。

具体分析大字段,看是否字段里的信息都有搜索价值。建议把没有价值的信息过滤掉,只上传有价值的信息。

结语:行业差异与调参建议

最后,需要再次强调,Viking AI 搜索的最佳实践并非一成不变的教条,不同电商行业,甚至同一行业的不同发展阶段,对搜索的侧重点都有所不同,成功的电商导购助手,是优质数据、灵活策略和持续优化共同作用的结果。

说明

最近更新时间:2026.04.13 22:05:03
这个页面对您有帮助吗?
有用
有用
无用
无用