<div></div>
Google 搜索 Discourse AI
要设置一个带有 Discourse AI 插件的 Google 搜索机器人，您需要配置一个 Google 可编程搜索引擎和自定义搜索 API 密钥。您使用的任何 AI 模型都需要使用此搜索工具来返回 Google 搜索结果。当您为 Discourse 插件设置 AI 服务时，例如如果您正在使用 OpenAI API GPT 或 Anthropic Claude，并且您想使用一个助手机器人来执行 Google 搜索，您将需要配置一个可编程搜索引擎来搜索 Google，并为您的研究机器人提供一个 API 密钥来访问搜索引擎并返回结果。
引言：Google Cloud、可编程搜索引擎和自定义搜索 API
可编程搜索引擎（或自定义搜索引擎）是一项免费的搜索引擎服务，任何人都可以将其设置在自己的网站上，并由搜索引擎 ID（或 CX 编号）标识。自定义搜索 API 密钥用于向搜索引擎发出 API 请求，API 密钥是从Google Cloud 控制台管理的。因此，您需要设置一个 Google Cloud 帐户 - 注册帐户需要信用卡，但自定义搜索 API 每天提供 100 次免费搜索查询，之后才需要付费（额外的请求费用为每 1000 次查询 5 美元，每天最多 10,000 次查询，但您需要购买更多用量）。请参阅如何管理结算。
您还应该在 Google Cloud 项目下设置您的密钥，最好是为搜索密钥指定一个新项目（以便于跟踪）。请注意，Google Cloud 对项目数量和附加到结算帐户的项目数量都有配额，并且在创建 API 密钥后，可以将项目添加到结算帐户。
清单
- 设置 Google Cloud 帐户
- 为您的自定义搜索 API 密钥创建一个项目
- 将项目连接到结算帐户
- 创建 API 密钥
- 配置自定义搜索的 API 密钥
- 设置 Google 可编程搜索引擎
- 在 Discourse AI 设置中保存自定义搜索 API 密钥和自定义搜索 ID
步骤 1：在 Google Cloud 中设置项目
在设置自定义搜索引擎和 API 密钥之前，请在 Google Cloud 中设置一个项目。
前往您（或您的组织）的 Google Cloud 管理界面，并确保您位于父组织中（您可以在 Google Cloud 徽标旁边的顶部字段中看到它）。
如果您还没有要使用的项目，则必须为您的搜索引擎创建一个项目 - 在页面顶部附近有一个用于选择或创建新项目的链接。
填写“创建新项目”页面（确保在适当的下拉字段中选择了您的组织）。
为了管理项目的结算，您需要在 Google Cloud 结算中为项目设置一个结算帐户，前提是您的组织已配置了结算。您（或您的结算帐户管理员）可以在创建密钥后稍后执行此操作。请注意，根据您组织的 Google Cloud 帐户，项目和结算项目都有配额。
要为您的项目启用结算，请转到 Google Cloud 导航菜单中的“结算”选项卡，然后链接一个结算帐户，或从结算项目页面启用项目的结算。
步骤 2：创建 API 密钥
要从 Google Cloud 控制台创建 API 密钥，请转到 Google Cloud 控制台中的“API 和服务”选项卡以及您新项目的凭据设置。 （不用担心“配置同意屏幕”消息）。点击页面顶部的“+ 创建凭据”链接，然后从下拉选项中选择“API 密钥”。
将为您创建一个新的 API 密钥。将其复制并保存在安全的地方，例如密码保险库应用程序。不要共享密钥。
这就是您需要在 Discourse AI 设置中为 ai_google_custom_search_api_key 输入的 Google 自定义搜索 API 密钥。
现在，您应该会在 API 密钥列表中看到新创建的密钥。点击最右侧“操作”列中的 3 个点，然后选择“编辑 API 密钥”。
这将打开 API 密钥凭据配置页面，您可以在此处将 API 密钥的名称编辑为更合适的名称。（您也可以查看/复制您的 API 密钥或在必要时重新生成它）。然后转到底部的“API 限制”部分，选择“限制密钥”，然后选择“自定义搜索 API”。点击“确定”然后保存您的 API 密钥。
如果您没有看到任何限制，您可能需要在 API 库中启用 API 服务。搜索“google custom search api”然后选择它。在这里，您将看到自定义搜索 API 的详细信息，包括定价和更多文档链接 - 点击链接以启用 API。
新的 API 密钥现在将列出其新名称，并带有绿色的复选标记，表示它仅限于自定义搜索 API JSON 请求。
步骤 3：创建可编程搜索引擎
要为您的 API 密钥创建要使用的搜索引擎，请转到 Google 可编程搜索引擎页面，如果您尚未登录，请点击“开始使用”（登录或创建您的帐户）。登录后，转到搜索引擎控制台页面。您所有现有的可编程搜索引擎都将在此处列出。
点击“添加”按钮（或“创建您的第一个搜索引擎！”链接）以打开新搜索引擎页面。为其命名并根据需要填写字段。
点击“创建”按钮，您的新搜索引擎将被创建。该页面将提供一个复制搜索脚本的选项，如果您想在某个 Web 界面中使用搜索框，但这在这里不是必需的，因为我们只对其 API 密钥凭据感兴趣。
选择“自定义”按钮转到搜索引擎概览页面。在这里，我们可以看到 Discourse AI Google 搜索设置所需的搜索引擎 ID（CX 编号），以及一些其他可以配置的选项。（请注意，如果滚动到底部，有一个创建 API 密钥的链接 - 您不需要这样做，因为您已经在上面的步骤 2 中完成了）。
步骤 4：在 Discourse AI 插件中配置 Google 自定义搜索
复制搜索引擎 ID 号并将其与您在步骤 2 中创建的 API 密钥一起存储。转到“管理” → “站点设置”，然后在“所有站点设置”过滤器中键入“google custom search”以显示您需要的两个设置。将 API 密钥粘贴到 ai_google_custom_search_api_key 中，并将搜索引擎 ID（CX 编号）粘贴到您的 Discourse 实例的 ai_google_custom_search_cx 中，然后保存新设置。根据需要配置您的其他 AI 设置。
步骤 5：跟踪 API 搜索密钥
您可以在 Google Cloud 控制台 API 和服务详细信息中查看您的自定义搜索 API 密钥活动，也可以在“配额和系统限制”选项卡中设置配额。成本报告可以在“成本”选项卡中查看。
Discourse AI 搜索示例
这是一个使用 Google 自定义搜索的 OpenAI GPT-4 Turbo 示例，用于解释其功能和设置方法。
这是一个使用 Google 自定义搜索的 Anthropic Claude Opus 示例，用于解释“反向半人马”的含义。
