进行 API 调用 步骤允许对话智能机器人使用 REST API 请求从外部系统(例如 Shopify 或 Salesforce)抓取数据。
在本配方中,您将创建一个智能机器人回答,用于检索终端用户提供的某个位置的天气数据。回答从 OpenWeather API获取数据。您可以以此配方中创建的回答流程为起点,自行创建由 API 提供技术支持的回答。
任务 1:正在检查您的设置
要完成此配方,您需要:
- 带有已发布对话智能机器人的 Zendesk 帐户。如果需要,您可以先使用 沙盒测试环境 对智能机器人进行测试,然后再用于生产环境。
要在 Web 和移动消息传送渠道中设置对话智能 机器人,请参阅使用适用于您的 Web 和移动渠道的对话智能机器人。有关在沙盒环境中使用消息传送的信息,请参阅在沙盒环境中 使用消息传送。
-
OpenWeather 帐户的 API 密钥。此配方中使用的 API 在 OpenWeather 的免费服务模式中可用。
要注册免费的 OpenWeather 帐户,请 查阅 openweathermap.org上的 Create New Account(创建新帐户)页面。登录后,您可以在您的 OpenWeather 帐户页面获取一个 API 密钥。
要激活 OpenWeather API 密钥,您必须验证您的帐户电邮地址。验证后,激活 API 密钥最多可能需要两小时。如需更多信息,请 查阅 openweathermap.org上的常见问题解答。
任务 2:创建 API 连接
首先,创建一个 API 连接以存储您的 OpenWeather API 密钥。您的对话智能机器人可使用此连接来对对 OpenWeather API 的调用进行身份验证。
- 在管理中心,单击侧栏中的应用和整合 (
),然后选择连接 > 连接。
- 单击创建连接。
- 选择 API 密钥 身份验证类型。
- 输入 openweather_api_key 作为 连接名称。
- 输入 x-api-key 作为 标头名称。
- 输入您的 OpenWeather API 密钥作为 值。
- 输入 api.openweathermap.org 作为 允许的域名。
- 单击保存以创建连接。
任务 3:创建自定义工单字段
任务 4:建立智能机器人回答
本部分将引导您完成创建回复、设置其意向,以及在智能机器人生成器中添加回复的步骤。这涉及以下步骤:
第 1 步:创建回复
使用智能机器人生成器为对话智能机器人创建回复。
- 在管理中心,单击侧栏中的渠道 (
),然后选择智能机器人和自行程序 > 智能机器人。
- 单击管理智能机器人。
- 单击您要处理的智能机器人。
- 在答案标签上,单击 创建答案。
第 2 步:设置答案的意向
设置回复的意向和训练短语。包括用于在对话中触发回复的短语和字词。
- 在智能机器人编辑页面的“答案”标签上,单击创建答案。
- 单击自行创建回复,然后单击下一步。
- 输入 获取天气 作为答案的 意向。
- 在 训练短语下,输入 获取天气预测 和 获取当前温度。
- 单击下一步。
回复随即在智能机器人生成器中打开,您可以在其中构建回复。
第 3 步:添加初始消息步骤
添加“ 发送消息 ”步骤以询问用户位置。这是回复流程的第一步。
- 在智能机器人生成器中,单击 添加步骤。
- 在 选择步骤下,选择 发送消息。
- 在 智能机器人消息中,输入以下文本:
What location would you like to get the weather for? Include the country code. For example: "Melbourne, AU" or "San Francisco, US"
第 4 步:询问终端用户位置
在初始消息后,添加“ 询问详情” 步骤,向终端用户显示一个基本表格。该表格包括一个用于输入 位置 工单字段值的文本框。
- 在智能机器人生成器中,单击 添加步骤 图标 (
)。
- 在 选择步骤下,选择 询问详情。
- 输入 Get location 作为 名称。
- 在 字段中,输入并选择 位置 工单字段。
第 5 步:正在检索位置的天气数据
添加一个进行 API 调用 步骤,以便从 OpenWeather API 的 当前天气数据 端点获取该位置的天气数据。
- 在智能机器人生成器中,单击 添加步骤。
- 在 选择步骤下,选择进行 API 调用。
- 输入 获取天气 作为 名称。
- 在 API 详情下,输入
https://api.openweathermap.org/data/2.5/weather?units=metric&q=
作为 端点 URL。 - 使用 添加变量 图标(
)以便将 位置 字段变量附加到 端点 URL 值。
最终的 端点 URL 值应如下所示:
- 在 身份验证中,选择 openweather_api 连接。
- 要测试 API 请求,请单击进行 API 调用。
- 在 测试数据下,输入 澳大利亚墨尔本 作为 位置。
- 单击进行 API 调用。
- 使用其默认名称保存以下变量:
- 主要 > 临时工
- 天气 > 项目 1> 描述
第 6 步:发送天气消息给终端用户
检索天气数据后,使用 发送消息 步骤用一条包含天气数据的消息进行回复。
- 在智能机器人生成器中,单击 获取天气 步骤的 API 调用成功 分支下的 添加步骤 。
- 在 选择步骤下,选择 发送消息。
- 在 智能机器人消息中,输入以下文本:
It's {{temp}}° C with {{description}} in
- 使用 添加变量 图标(
)以将 位置 字段变量附加到 智能机器人消息 值。然后添加句点 (.)。
完成的 智能机器人消息 值应如下所示:
第 7 步:添加失败消息
在“进行 API 调用” 步骤发出的请求可能会失败。例如,请求中可能包含不存在的位置。将 发送消息 步骤添加到 API 调用失败 分支。如果 OpenWeather API 调用失败,此步骤将返回一条消息。
- 在智能机器人生成器中,单击 获取天气 步骤的 API 调用失败 分支下的 添加步骤 。
- 在 选择 步骤下,选择 发送消息。
- 在智能机器人消息中,输入以下文本:
I'm sorry. I wasn't able to get weather data for
- 使用 添加变量 图标(
)以将 位置 字段变量附加到 智能机器人消息 值。然后添加句点 (.)。
完成的 智能机器人消息 值应如下所示:
第 8 步:发布已更新的智能机器人
要实时推送回复,请发布更新的智能机器人。
- 单击智能机器人生成器右上角的完成。
- 在智能机器人页面上,单击 发布智能机器人。
- 单击发布。
任务 5:测试更改
发布更改后,您可以通过询问“How's the天气?”来测试新的答案。在与已更新智能机器人的对话中。有关测试对话智能机器人的更多信息,请参阅 测试终端用户的消息传送体验。
翻译免责声明:本文章使用自动翻译软件翻译,以便您了解基本内容。 我们已采取合理措施提供准确翻译,但不保证翻译准确性
如对翻译准确性有任何疑问,请以文章的英语版本为准。