AI 搜索
AI 搜索能理解用日常语言写出的查询:“100 欧元以内的防水跑鞋,不要 Contoso”“送给跑步爱好者的礼物”“装 15 英寸笔记本的包”。AI 把查询解析为目录筛选条件——分类、品牌、属性、价格和排除项,商品搜索再按这些筛选条件显示商品。商品上方会显示简短的 AI 建议和细化标签:“更便宜”“女款”“换个颜色”。普通结果照常立即显示,解析完成后由 AI 结果替换。如果 AI 没有响应,则保留普通结果。
AI 搜索是商品搜索的一部分:需要追踪器、商品目录以及搜索小组件或网店插件。AI 按用量从项目余额扣费,仅在付费套餐中可用,参见费用与限制。
如何启用
在网站 → 商品搜索页面的 AI 搜索区块中选择何时使用 AI。选择会立即保存。

| 模式 | AI 何时解析查询 |
|---|---|
| 关闭 | 从不:搜索照常进行 |
| 自动 | 描述性查询——三个词及以上或问句;简短查询(“跑鞋”“nike”)照常搜索 |
| 开关 | 仅在顾客点击“询问 AI”时 |
| 始终 | 每一次查询 |
在自动和开关模式下,访客会看到询问 AI按钮——位于结果排序旁边,并作为一行显示在搜索浮层中:点击后 AI 也会解析简短查询。
- 商品上方的简短 AI 回答——关于搜索到的商品的一两句话:哪些最合适、价格区间如何。如果只需要筛选条件,可以关闭。
- 检验 AI 的效果——一半访客使用普通搜索,报告比较两组的点击和购买,参见检验 AI 的效果。
检查解析
检查解析字段显示 AI 从查询中理解到的内容:搜索文本、分类、品牌、属性、价格、排除项、排序和细化建议。请像顾客那样输入查询,然后点击解析。解析与网站上一样扣费;再次解析同一查询会从缓存免费返回,结果下方显示“来自缓存,未调用模型”。
如果 AI 未在查询中找到目录中的任何内容,将按文本搜索,字段下方会给出相应提示。这说明可以在目录中补充顾客搜索的分类或属性。
顾客看到的内容
- 顾客输入查询,普通结果立即显示。
- 商品上方显示“AI 正在为您挑选商品…”。一两秒后,AI 结果替换普通结果。
- AI 的回答随模型输出逐字显示在“AI 建议”标题下。
- **AI 理解为:**标签显示已应用的筛选条件:分类、品牌、属性、价格,以及带“−”号的排除项。标签可以移除,结果会立即更新,无需调用模型。
- 细化——标签和“请细化:更便宜、换个颜色…”输入框。细化会延续上一个查询:在“Northwind 跑鞋”之后输入“更便宜”,会保留品牌并降低价格。
- 在聊天中咨询会打开带有顾客查询的网站聊天(如果已接入聊天)。
- 普通搜索会恢复普通结果,直到查询发生变化。
如果目录中没有顾客要找的商品,AI 会放宽筛选条件:先去掉属性和排除项,再去掉价格,最后按原始文本搜索。此时商品上方显示“没有完全匹配的结果,为您显示相似商品。”
如果访客自己在结果中选择了筛选条件或排序,AI 不会改写访客的选择:所选排序会应用在 AI 结果之上,而访客自己的筛选条件会恢复普通结果。
AI 如何解析查询
- 仅限目录。 AI 获取您目录中的分类、品牌和属性取值,并从中进行选择。目录中没有的内容都会被舍弃:AI 不会编造品牌或尺码。
- 语言。 查询可以使用任何语言:AI 会把搜索文本翻译成目录的语言,并用顾客的语言给出细化建议。
- 缓存。 查询的解析结果保存 7 天:同一语言的同一查询无需调用模型,免费解析。每天夜间,网站 30 天内的热门搜索会提前解析(每个项目最多 100 个查询),因此常见查询可以立即响应。
- 商品上方的回答只依据搜索到的商品卡片:名称、品牌、价格、库存和属性。包含卡片中没有的数字(价格、折扣、期限)的句子会被删除。针对同一查询和同一批商品的现成回答保存一天。
- 商品顺序保持搜索的顺序:基于点击的学习、访客兴趣和语义搜索在 AI 结果中同样生效,参见如何搜索商品。
网店插件
WooCommerce、Magento 2 插件和 1C-Bitrix 模块在商品搜索模式下,会在商店的搜索页显示 AI 结果。商店主题照常显示商品,追踪器在商品上方显示 AI 区块:建议、“AI 理解为”标签、细化和“普通搜索”。移除标签或进行细化会以新参数打开同一个搜索页。
插件最多等待解析 2.5 秒。热门查询已在夜间解析,可立即打开;新的描述性查询比平时多花 1–2 秒。如果解析未及时完成,商店显示普通结果。需要 WooCommerce 插件 1.18.0、Magento 2 插件 1.15.0 或 1C-Bitrix 模块 1.14.0 及以上版本。
自有结果页
如果结果页是您自己开发的,请通过追踪器获取 AI 结果:
const result = await cdp.searchAi(q, { perPage: 24 });
if (result.ai) {
// result.items — 商品,result.ai.understood — “AI 理解为”标签,result.ai.refinements — 细化建议,
// result.ai.relaxed — 筛选条件已放宽,result.ai.state — 供下一次查询使用的解析结果
await cdp.searchAiAnswer(q, result.items.slice(0, 6).map((item) => item.id), (text) => { answer.textContent = text; });
} else {
// 该查询不需要 AI、AI 不可用或未及时响应——请显示普通结果 cdp.search(q)
}
cdp.searchAi 的选项:previous——上一次响应的 result.ai.state,与细化短语(“更便宜”)一起传入;state——去掉已移除标签后的解析结果(无需调用模型即可返回结果);asked: true——访客点击了“询问 AI”;此外还有 sort、page、perPage。解析最多等待模型响应 8 秒。需要追踪器 1.37.0。
服务器可以使用写入密钥发起相同的请求:POST https://cdp.onetrace.pro/api/v1/search/ai;PHP SDK 中为 search()->ai()。完整的参数列表请参阅 API 参考:https://cdp.onetrace.pro/api/v1/openapi.json。
报告
AI 搜索启用期间,网站 → 商品搜索页面的搜索词报告下方会显示同一时期的 AI 搜索报告。

| 指标 | 含义 |
|---|---|
| AI 搜索次数和占全部搜索的比例 | AI 显示了多少次结果,占网站全部搜索的多大比例 |
| 来自缓存 | 未调用模型的结果所占比例——免费且即时 |
| 解析:p50 / p95 | 一半和 95% 的搜索中,模型解析查询所需的时间 |
| 回答的首批文字 | 顾客多久后看到 AI 建议的开头 |
| 已放宽 | 没有完全匹配、AI 去掉了部分筛选条件的搜索所占比例 |
| 失败 | 模型未响应的解析;这些情况下顾客看到的是普通结果 |
| 每 1000 次搜索的费用 | 为 AI 搜索从余额中扣除的金额,折算为每 1000 次搜索 |
指标下方显示:多少次细化无需调用模型、AI 回答了多少次,以及本期扣费多少。表格列出 AI 解析过的查询,包括找到的商品数和放宽比例:放宽比例高的查询能说明商品品类还缺少什么。
检验 AI 的效果
开启检验 AI 的效果,了解 AI 是否有助于销售。本应使用 AI 的访客被平均分为两组:一组使用 AI 搜索,另一组使用普通搜索。访客始终留在自己的组中。主动点击“询问 AI”或细化查询的访客,无论在哪一组都会使用 AI。普通搜索组的搜索不按 AI 扣费。
报告中的 AI 的效果区块比较两组:
- 30 分钟内点击搜索结果——访客在该查询的结果中点击了商品的搜索所占比例;
- 搜索后 7 天内购买——同一顾客随后购买了商品的搜索所占比例。在推荐设置中设置了购买事件时显示,参见推荐与商品目录。
结论与其他变体比较相同:数据不足时,报告会如实说明;差异具有统计显著性时,会给出胜出方。如果普通搜索更好,请在检查解析字段中检查常见查询的解析。搜索结果的点击由搜索小组件记录;在插件的搜索页上,商店主题不记录点击,因此只比较购买。关闭检验后,报告显示检验运行期间的结果。
费用与限制
每次 AI 解析和回答的费用取决于模型处理的文本量(token),另加平台加价。费用从项目余额中扣除,支出项目为“AI 搜索”。从缓存获取解析、移除标签、翻页和更改排序都不调用模型,免费。模型由平台选择;解析一个查询通常不到一分钱。
- AI 搜索仅在包含商品搜索的付费套餐中可用。在试用期内、余额不足或达到支出上限时,AI 不会启用,顾客看到的是普通搜索。
- 每次向 AI 发出的请求都会在套餐的每月限额中再计一次搜索请求,参见请求限额。小组件会同时获取普通结果和 AI 结果,因此小组件中的描述性查询计为两次;在网店插件中计为一次。不需要 AI 或 AI 不可用的查询,以及效果检验中普通搜索组的搜索,不会重复计数。
- 每位访客调用模型每分钟不超过 10 次、每天不超过 100 次;超出后访客看到的是普通结果。来自缓存的回答不计入这些限制。
- 同一地址每分钟最多调用模型 30 次、每天最多 300 次(网站所有 AI 功能合计);安装插件并配置密钥的商店服务器不受此限制。网站 AI 每天最多花费多少由每日预算决定:预算用完后,午夜前使用普通搜索。