调用智能体流

了解如何在 Copilot Studio 中使用代理流,让代理能够按需生成天气预报。

先决条件

此示例取决于前面一个示例,在该示例中创建了获取天气预报的 代理流

如果您尚未创建天气预报流,请现在创建。

从智能体调用智能体流

下面介绍如何将天气预报流程作为工具添加到智能助手中。 此方法允许智能体编排器在需要提供天气预报时调用该流。

  1. 在 Copilot Studio 的左侧导航窗格中,选择 “代理 ”,然后选择要向其添加流的代理。

  2. 转到 “工具” 页,然后选择“ 添加工具”。

  3. 选择流程以显示所有可用的已发布流程列表。

  4. 选择之前创建的 “获取天气预报 流”。

  5. 选择 “添加并配置”。

    该流将被添加到智能体,并显示在智能体的工具列表中。 此时会打开代理使用的工具的配置窗格。 可以使用此窗格来配置代理的工具。

  6. 名称说明下,输入工具的显示名称,并提供一个清晰说明,以协助代理协调器理解何时使用此流程。 例如,“在提供的城市名称或邮政编码处获取今天的天气预报。

  7. “输入”下,选择代理填充变量值的方式。

  8. “完成”下,选择您希望代理在使用该工具后执行的操作。

  9. 完成配置后,选择“ 保存”。

从主题调用智能体流

下面介绍如何在客户询问天气时使用主题中的 动作 节点来调用流。

  1. 在 Copilot Studio 中,转到代理的主题页面。

  2. 创建一个新主题,然后将其命名为获取天气

  3. 添加以下触发短语:

    • 是否下雨
    • 今日预报
    • 获取天气
    • 天气情况

    “获取天气”主题的触发短语屏幕截图。

  4. 选择触发器节点下的添加节点图标 ,然后选择发送消息

  5. 消息节点的文本框中输入我能为您提供此帮助

  6. 选择消息节点下的添加节点图标 ,然后选择提问以添加问题节点,为消息流的第一条消息(城市)添加一个节点。

  7. 问题节点上:

    1. 在文本框中输入问题“您在哪个城市?”。
    2. 识别下,选择用户的完整响应
    3. 注意与此回复相关的变量名称,Var1。 您可以保留该名称,或将其替换为更有意义的名称,如“城市”(如有需要,请参阅重命名变量)。
  8. 以同样的方式添加另一个问题节点,以获取流中的另一条信息,即邮政编码:

    1. 在文本框中输入问题“您的邮政编码是什么?
    2. 识别下,选择编号
    3. 注意与此回复相关的变量名称,Var2。 您可以保持名称不变,也可以将其替换为更有意义的名称(例如,“ZIPcode”)。
  9. 选择邮政编码的“问题节点下的“添加节点”图标,选择“添加工具”,然后选择之前创建的流“获取天气预报”。

  10. 将流输入设置为问题节点的输出变量。 城市(字符串)的值来自 Var1(如果重命名,则来自 City),邮政编码(数字)的值来自 Var2(如果重命名,则来自 ZIPcode)。

    显示“获取天气预报”流输入和输出参数的操作节点屏幕截图。

  11. 操作节点下添加消息节点,并输入一条使用流输出信息的信息。 例如:

    “今日 location:day_summary 预告”
    “降雨概率为 chance_of_rain%”
    其中 locationday_summarychance_of_rain 是流的输出参数。

    “消息”节点的屏幕截图,其中包含使用流输出参数的消息。

  12. 选择保存

管理主题中使用的代理流

一旦有了调用流的操作节点,就可以使用节点菜单中的以下选项来管理流:

  • 删除可永久删除节点,并从主题中删除流。

  • 刷新可重新加载流,以获取您在 Power Automate 中所做的任何更改,并在主题中进行验证。 在保存主题之前,您必须解决流中的任何问题。

如果您想选择或创建不同的流,请使用更改流图标 ,当您将鼠标悬停在操作节点中的流上时,该图标就会出现。

测试流和主题

测试流及其调用的主题是一个好主意。

测试代理面板中,键入主题的触发短语之一,开始与代理对话。 当代理要求时,输入您的城市和邮政编码。 验证代理是否返回您所在城市的今天天气预报,以及消息是否符合您的预期。

测试聊天的屏幕截图,其中显示了“获取天气预报”工具中的信息。

排除代理故障

在更改主题和流时,请务必测试代理,以确保一切正常。 如果代理在对话过程中遇到问题,它会回复一条错误消息

流设计器 选项卡上的流检查器中查找大多数与流相关的问题。使用 主题检查器 确定创作画布上的问题。