AI 搜索栏

概述

AI 搜索栏是一款用于您网站的独立搜索组件。访客用自己的话输入，停顿时匹配结果就会出现在搜索栏下方：来自实时数据源的产品以带图片和价格的卡片形式展示，来自知识库的页面则带有标题、简短预览和链接。由于它按语义而非仅按精确关键词搜索，即使访客输入的是一段描述，也能找到正确的条目。

它与您的聊天机器人使用同一个知识库，因此无需额外索引或维护。两个组件相互独立：可以只用搜索栏、只用聊天组件，或在同一页面上同时使用两者。

添加到您的网站

AI 搜索框需要 Standard 或更高套餐。低于该套餐时，搜索框仍会出现在网站上，但永远不会返回结果，所以如果没有任何反应，请先检查你的套餐。

你的挂件 ID 显示在控制台的“AI 搜索框”页面上。

最简单：替换你已有的搜索框

如果你的网站已经有搜索 - Shopify 主题自带的搜索、WordPress 搜索表单，或你自己做的 - 就不用放置任何东西，也不用改主题。在 script 标签上加 data-replace，挂件会找到现有的搜索表单，把它隐藏，并出现在完全相同的位置：

这段脚本放在页面任何位置都可以，所以任何能往页头或页脚添加代码的插件都行。不选结果直接按 Enter 仍会打开你原来的搜索结果页，访客熟悉的用法不会失效。如果在特殊主题上自动识别选错了元素，用 CSS 选择器代替 auto，例如 data-replace=".header-search"。若没有任何匹配，挂件不会改动你的页面。

自己放置

如果你还没有搜索框，或者想放在特定位置，就把这两行贴到希望搜索框出现的地方，例如页头 Logo 旁边。搜索框会填满所在元素的宽度，所以通常需要编辑主题模板。

如果哪里不工作

• 完全没有出现搜索框。检查脚本里的挂件 ID 是否与控制台“AI 搜索框”页面上的一致，以及代码是否确实在已发布的页面上，而不是只在草稿或预览里。
• 搜索框出现了但从不返回结果。几乎都是套餐问题：搜索需要 Standard 及以上。每月 AI 回复额度用完时也是同样的表现。
• 只出现页面，没有商品。商品来自实时数据源。在“AI 搜索框”页面连接一个，并确认该页上的数据源勾选框已勾上。
• 不管搜什么都没有结果。你的知识库可能还是空的。先抓取网站或在控制台添加内容，然后再试。
• data-replace 没找到你的搜索框。有些主题把搜索藏在按钮或弹窗后面。用目标元素的 CSS 选择器代替 auto，并在普通浏览器窗口而不是主题编辑器里查看页面。

搜索来源

控制面板中 AI 搜索栏页面上的两个复选框控制搜索可以使用的内容：网站页面（已抓取的页面和添加的 URL）和您的实时数据源。两者默认均已开启。数据源不限于产品 - 您在其中索引的任何内容，例如文章或列表信息，都可以作为结果出现。更改会立即在您的网站上生效。

产品结果需要连接数据源。两种都可以：Standard 计划及以上的实时数据源，以及 Pro 的实时数据源 Max。没有数据源时搜索照常可用，只是仅返回您的网站页面，控制面板页面会将数据源标记为未连接，让您知道为什么没有产品出现。

搜索分析

控制面板中的 AI 搜索栏页面显示最近 30 天的搜索情况：一共搜索了多少次、多少次没有结果、访客打开结果的频率有多高。两个表格分别列出最常见的搜索和没有结果的搜索。第二个表格更有用，因为它准确地告诉您访客期待什么却找不到什么。

记录默认开启，您可以在同一页面上用一个复选框关闭它。关闭后将完全不存储任何搜索文本，表格也会停止更新，而搜索本身仍与之前完全一样正常工作。

您在控制面板页面上进行的搜索永远不会计入统计。使用零留存模式的网站完全不记录搜索文字；如果您设置了数据保留策略，搜索记录会按照与对话相同的时间表删除。

结果的呈现方式

控制台中 AI Search Bar 页面上的两项设置可改变搜索栏及其结果的外观。两者选择后立即保存，都无需改动代码。

商品结果详细程度

在每个商品名称下方，搜索栏可以显示数据源中描述的一行文字。这是否有帮助，完全取决于您的数据源里放了什么。写明行程天数和剩余名额的旅游数据源值得显示；而只放属性清单的数据源，读起来就像数据库导出。

所以由您决定：仅名称、一行，或两行。默认是一行，适合大多数数据源，因为足以区分两件相似商品，又不会让列表显得拥挤。这只影响商品结果；网页结果始终显示与访客搜索相匹配的文字。

搜索栏尺寸

搜索栏有三种高度：紧凑 38 像素适合窄页眉，默认 44 像素，大号 52 像素适合以搜索为核心的页面。文字大小随之变化。

宽度从不由我们设定。搜索栏始终填满您放置它的元素，因此宽度由您的版面决定。结果面板会自动与搜索栏对齐。

更改尺寸后请重新复制嵌入代码。新代码带有尺寸信息，因此页面加载时搜索栏就已正确。若不重新复制，搜索栏仍会自行调整，但要等到第一次搜索之后。

当搜索没有结果时

如果同一页面上有您的聊天小组件，那么每当搜索没有结果时，搜索栏会提议把问题交给您的助手。访客的问题会被保留，进入聊天时问题已经填好，死路便变成了一次对话。只有在聊天小组件存在时，才会出现这个选项。

选项

搜索栏会自动使用访客浏览器的语言来显示占位符、结果分组标题和加载中的文本。只有当您想使用自己的措辞时，才需要设置这些属性。

这两个标题也可以在控制台的“AI 搜索框”页面重命名，无需改代码。如果你的数据源放的是文章或房源而不是商品，这样更方便。script 标签上的属性仍然优先于控制台里的设置。

所有属性均为可选，添加在 script 标签上：

• data-placeholder="Search products..." - 空搜索栏中显示的文字
• data-accent="#0a7d4f" - 聚焦和高亮颜色，可匹配您的品牌
• data-max-results="8" - 显示多少条结果，1 到 20
• data-new-tab="true" - 在新浏览器标签页中打开结果
• data-size="sm" - 搜索栏高度：sm、md 或 lg。优先于控制台中设置的尺寸
• data-label-products="Products" - 数据源结果上方的标题，使用您的语言 - 例如数据源中是文章时可写“文章”
• data-label-pages="Pages" - 页面结果上方的标题，使用您的语言
• data-label-empty="No results found" - 无匹配结果时显示的消息
• data-label-searching="Searching..." - 结果加载时显示的文字
• data-label-ask-ai="Ask our assistant" - 把无结果的搜索交给聊天机器人的那个选项的措辞
• data-target=".my-container" - 在此元素内渲染搜索栏，而不是默认容器
• data-replace="auto" - 替换主题中已有的搜索栏，见上文说明

用量与计费

访客执行的每次搜索会占用您月度计划额度中的 1 次 AI 回复 - 与聊天机器人回复使用同一额度。搜索在访客停止输入时才触发，而不是每输入一个字母就触发。您在控制面板的 AI 搜索栏页面上执行的搜索不计入。达到月度额度后，搜索栏只是不再显示结果，直到额度重置。

须知事项

• 即使您的内容是用另一种语言编写的，访客也可以用任何语言搜索。
• 拼错的词和只打了一半的词照样能找到对的东西，比如搜索“架克”也能找到夹克。
• 产品价格会带上您的货币符号显示，符号取自您数据源中的货币。
• 同一页面的多个语言版本只会出现一次 - 与搜索语言匹配的版本优先。
• 结果打开的是您网站上的真实页面，因此搜索栏也可以作为导航使用。
• 该组件只是一个无依赖的小脚本，不会拖慢您的页面。
• 键盘操作开箱即用：方向键移动，Enter 打开，Escape 关闭。