创建 Apex 智能体操作
学习目标
完成本单元后，您将能够：
- 创建 Apex 智能体操作。
- 向主题添加智能体操作。
- 测试智能体操作。
备注
用中文（简体）学习？在中文（简体）Trailhead Playground 中开始挑战，用括号中提供的译文完成挑战。仅复制并粘贴英文值，因为挑战验证基于英文数据。如果在中文（简体）组织中没有成功通过挑战，我们建议您 (1) 将区域设置切换为美国，(2) 按此处说明将语言切换为英文，(3) 再次单击“检查挑战”按钮。
查看 Trailhead 本地化语言徽章详细了解如何利用 Trailhead 译文。
构建 Apex 智能体操作
现在，Apex 已准备就绪，将其添加到操作。您将会看到在 Apex 中的参数是如何自动转移到操作。
- 单击 Setup（设置）
，然后选择 Setup（设置）。
- 在 Setup（设置）的 Quick Find（快速查找）框中，搜索并选择 Agentforce Assets（Agentforce 资产）。
- 单击 Actions（操作）选项卡。
- 单击 New Agent Action（新建智能体操作）。
- 对于 Reference Action Type（参考操作类型），请选择 Apex。
- 对于 Reference Action Category（参考操作类别），选择 Invocable Method（可调用方法）。
- 对于 Reference Action（参考操作），选择 Check Weather（查看天气）。这就是可调用方法。
- 对于 Agent Action Label（智能体操作标签），保留预填充内容，即 Check Weather（查看天气），这是从可调用方法标签参数中获取的。
- 对于 Agent Action API name（智能体操作 API 名称），保留系统自动生成的预填充内容 Check_Weather。
- 单击下一步。
接下来的步骤是配置 Agent Action（智能体操作）。此时您便能体会到在 Apex 中设置参数的优势所在。
- 对于 Agent Action Instructions（智能体操作指令），保留由 Apex 可调用方法描述参数提供的预填充内容。
- 取消勾选 Show loading text for this action（显示正在为此操作加载文本）。
- 对于 Input（输入），注意，已预填充 dateToCheck。
- 对于 Instructions（指令），注意，已预填充 Apex 可调用变量描述参数。您还可以根据需要对这些指令进行更新或补充。
- 对于 Data Type（数据类型），已预填充 Apex 数据类型。
- 如果必要参数设置为 true，则默认会将必填输入设为已选中。
- 勾选 Collect data from user（从用户处收集数据）。
- 对于 Outputs（输出），有三个值是从 Apex 可调用变量中获取的，即 maxTemperature、minTemperature 和 temperatureDescription。每项 Instructions（指令）已根据相应的描述参数和 Data Type（数据类型）进行预填充。
- 对于第三个输出 temperatureDescription，勾选 Show in conversation（在对话中显示）。
- 单击完成。
好极了！操作已完成。现在您已经了解了将 Apex 添加到操作中的步骤。而且您也更好地理解了 Apex 参数的工作原理，这有助于您构建操作。接下来，我们会将 Check Weather Agent Action（查看天气智能体操作）添加到主题并进行测试。
更新主题
- 单击 Setup（设置）
，然后选择 Setup（设置）。
- 在 Setup（设置）的 Quick Find（快速查找）框中，搜索并选择 Agentforce Agents（Agentforce 智能体）。
- 选择 Einstein Copilot 或 Agentforce (Default)（Agentforce（默认））。
- 单击 Open in Builder（在生成器中打开）。
- 确保代理已停用。
- 选择 MigrationDefaultTopic。
- 单击 This Topic’s Actions（该主题的操作）。
- 单击 New（新建），然后选择 Add from Asset Library（从资产库添加）。
- 勾选 Check Weather（查看天气）操作框，然后单击 Finish（完成）。
- 刷新您的浏览器窗口，然后选择 MigrationDefaultTopic。
- 单击 This Topic’s Actions（该主题的操作），验证 Check Weather（查看天气）操作仍在列表中。如果不是，重复执行步骤 8 至 11。在我们的实践环境中，有时添加的操作在首次保存后不会与主题关联。
- 单击 Activate（激活）。备注：如果显示 Configuration Issues Detected（检测到配置问题）弹出窗口，单击 Ignore & Activate（忽略并激活）。
我们来查看天气
- 仍在 Agentforce Builder（Agentforce 生成器）中时，在 Conversation Preview（对话预览）中输入
Check the weather for tomorrow（查看明日天气）。
- 查看智能体执行的步骤，并注意它选择了 Check Weather（查看天气）操作来完成请求。
- 想要查看下周的天气预报吗？输入
Check the weather for next week（查看下周天气）。
- 再看一遍步骤。智能体发送了一周中每天的日期以构建响应。
干得漂亮！您已经朝着充分利用组织现有的 Apex 功能并将其提供给 AI 智能体使用迈出了重要一步。您学习了一些最佳实践，以及如何设置参数以充分发挥智能体的作用。