连接您的网站
直接从您的平台读取页面、商品和订单
概述
连接网站会向 AI 提供一个对您平台的只读密钥。我们不再从外部抓取页面，而是直接向您的平台索取。
这样可以获取抓取无法触及的内容。登录之后的页面、没有任何链接指向的深层页面，以及位于机器人防护之后的网站，都能读取到。价格和库存始终保持最新，因为我们会重新读取，而不是依赖抓取当天页面上的内容。
三类数据
由您决定分享什么。每一项选择都对应助手之后能够回答的内容。
| 选择 | 它会带来什么 | 助手能回答什么 |
|---|---|---|
| 页面 | 您网站的内容，自动保持同步。 | 关于您的政策、服务、课程、指南以及其他任何文字页面的问题。 |
| 产品 | 当前价格、库存、链接和图片。 | 您卖什么、价格多少、是否有货，以及购买链接。 |
| 订单 | 为您的客户查询订单状态。 | 客户的订单在哪里、何时发出、里面有什么。 |
哪些平台可用
全部都可以。无论您的网站基于什么搭建，助手都能依据您的页面、商品和订单作答。
有些平台可以直接用 API 密钥读取。其余平台则通过抓取、商品数据源、用户上下文或您自己的自定义工具获取同样的数据。您不必自行判断属于哪一种：打开窗口，选择平台，勾选要分享的内容，系统就会显示适合您的步骤。
如何连接
- 打开您的仪表板，在“添加到知识库”旁找到连接您的网站。
- 从列表中选择您的平台。如果网站是您自己搭建的，请选择自定义 / 无 CMS。
- 勾选要分享的内容：页面、商品、订单，或任意组合。
- 点击继续。此时会显示针对您的平台和选择编写的设置步骤。
- 按照您平台后台中的步骤创建密钥。
- 把密钥粘贴到同一窗口下方的输入框中，然后点击“连接”。
点击“连接”后会发生什么
我们会先验证凭据再保存。错误的密钥绝不会被保存。
- 我们会使用您粘贴的凭据，向您的平台发出一次真实请求。
- 如果失败，错误会显示在按钮下方，输入框仍可编辑，方便您更正。
- 如果成功，我们会保存连接并开始读取您的内容。
- 随后窗口会报告结果：读取了多少条内容，或者具体出了什么问题。
保持同步
我们会按计划重新读取您的内容，因此价格变动或新页面无需您做任何事就能到达助手。
只有发生变化的内容才会重新建立索引。我们会把每一项的内容与已有内容比对，因此未改动的页面不会产生任何消耗。您也可以随时在平台自己的设置页面点击“立即同步”。
权限与访问
一个密钥能看到多少取决于平台，这个差别很重要。
Magento、Shopify、WooCommerce 和 BigCommerce 按资源授予权限。若您只勾选商品，密钥就确实只能访问商品。
WordPress 和 Moodle 不是这样。WordPress 的应用程序密码会继承创建它的账号的权限，Moodle 的令牌能看到其用户能看到的内容。没有可勾选的权限清单。请使用权限不超过您希望被回答内容的账号，并且要知道私密文章和受密码保护的文章也会被读取。
在我们这一侧，只读取内容路由，且只使用 GET。我们从不写入。
不使用 API 密钥进行连接
每一项选择也都有完全不需要密钥的途径。它们适用于任何平台，设置窗口会把它们与步骤一并列出。
| 替代 | 使用 | 它的作用 |
|---|---|---|
| 页面 | 抓取 | 我们会读取您的整个网站，并把内容保存在知识库中。 |
| 产品 | 实时数据源 | 给我们一个公开的商品数据源网址。价格和库存会从那里保持同步。 |
| 订单 | 用户上下文 或 自定义工具 | 从您的网站发送已登录客户的信息，或接入您自己的接口供助手调用。 |
断开连接
从窗口打开平台的设置页面并点击“断开连接”。这会删除已保存的凭据，并清除该密钥带入知识库的全部内容。其他来源的内容不受影响。
您也可以在自己的平台上吊销该密钥。下一次同步就会失败并报告身份验证错误，不会读取任何新内容。
故障排除
| 您看到的提示 | 通常代表什么 |
|---|---|
| 身份验证失败 | 密钥错误、已过期或被吊销。在 WordPress 上，把普通登录密码粘贴成应用程序密码时也会出现这种情况。 |
| 完成，但没有找到可读取的内容 | 凭据有效，但其背后的账号看不到任何内容。请选择一个能访问您希望被回答的页面或商品的账号。 |
| 已连接，但无法读取您的内容 | 密钥已被接受，随后读取失败。您平台返回的确切错误会与提示一同显示。 |
| 缺少某项权限 | 创建密钥时遗漏了步骤中列出的某个资源。请按窗口列出的全部权限重新创建。 |