获取搜索引擎标识和 API 密钥

创建 Google 可编程搜索引擎。 然后，获取其搜索引擎标识和 API 密钥。 有关详细指示信息，请参阅 Google 可编程搜索引擎文档中的 创建可编程搜索引擎。

下载 OpenAPI 规范

下载 OpenAPI 规范文件: google-custom-search-openapi.json。 您可以使用此文件将扩展添加到助手。

OpenAPI 规范定义以下方法:

• GET /customsearch/v1: 在整个 Web 上搜索内容。
• GET /customsearch/v1/siterestrict: 通过特定 Web 站点集合搜索内容。

有关端点的更多信息，请参阅 定制搜索 或 定制搜索站点受限。

端点具有相同的自变量和响应，但存在差异:

• 定制搜索站点受限 限制为搜索 10 个或更少的 Web 站点，每个 Web 站点可以具有无限数量的页面。
• 定制搜索 可以支持由 Google建立索引的任意数量的 Web 站点，但具有 每日查询限制。

对于专注于特定主题的典型助手，通常只需要搜索单个网站或几个网站即可。 定制搜索站点受限 比较适合，因为它对每天可运行的查询数没有限制。 需要搜索超过 10 个 Web 站点的助手需要改为使用 定制搜索。

创建和添加扩展

1. 在助手的“集成”页面上，单击 构建定制扩展，然后使用 OpenAPI 规范文件来构建定制扩展。 有关构建任何定制扩展的一般指示信息，请参阅 构建定制扩展。

2. 构建 Google 定制搜索扩展并将其显示在 集成 页面上之后，请单击 添加 以将其添加到助手。 使用 Google 可编程搜索引擎 API 密钥进行认证。 有关添加任何定制扩展的常规指示信息，请参阅 向助手添加扩展。

添加 Google 定制搜索入门模板工具包操作模板

1. 打开“操作”页面。

2. 如果没有任何操作，请选择 创建新操作。 如果已有一些操作，请选择 新建操作。

3. 在 创建操作上，选择 模板快速入门。

   模板快速入门 仅在英语助手中可用。

4. 在 模板快速入门上，添加 Google 定制搜索入门模板工具包。

编辑系统操作

1. 单击 由助手设置，然后打开 无匹配项 操作。

2. 删除两个缺省步骤。

3. 添加步骤。 将 然后 设置为 转至子操作，然后选择 Google 搜索 操作。

4. 如果未将客户连接到实时代理，那么您可能希望以与 无匹配项相同的方式编辑 回退 操作。

使用 Google 定制搜索扩展

向助手发出查询。 如果没有与该查询匹配的操作，那么它将使用 Google 来生成搜索结果。

限制搜索结果大小

watsonx Assistant 对包含搜索结果的上下文变量中存储的信息大小有 100 kb 限制。 如果扩展结果超过该限制，那么操作可能会失败，而不会出现任何可见的警告或错误。 通常会发生长时间延迟，然后没有响应。 Google 定制搜索扩展很少会发生此故障，但如果您搜索的站点包含 Google 定制搜索返回的大量元数据，那么可能会发生此故障。 如果您认为这可能是一个问题，请尝试在 API 测试工具 (例如 curl，Insomnia 或 Postman) 中运行查询。 检查作为搜索结果获取的数据的字节数。 如果总计为 100 kb 或接近 100 kb，那么您可能可以通过减少 num_of_results 并减少每个查询的结果，或者通过排除具有大量元数据的站点或页面来解决此问题。

有关更多信息，请参阅 IBM Watson® Discovery入门模板工具包中的 限制搜索结果大小。