通过

创建流

  • 项目

通过为代理提供根据要求生成天气预报的能力，了解如何使用云端流 Copilot Studio 。 在这第一个示例中，您将创建一个提取天气预报的流。 在下一个示例中，您将 流作为主题 中的操作调用，以便代理可以在客户询问天气时响应天气预报。

要使用代理， Power Automate 流需要特定的流扳机键和回复操作。

  • 流触发：从助手运行流

    “从助手运行流”触发器的屏幕截图。

  • 回复操作：回复助手

    “回复助手”回复操作的屏幕截图。

当您 创建流 时 Copilot Studio，将为您添加扳机键和操作。 您可以通过 将现有流程更改为使用这些操作来修改现有流程 以用于代理。

重要提示

要在自定义代理中使用 Copilot Studio云端流，流必须：

  • 让从助手运行流触发。
  • 位于与代理位于同一环境的解决方案中。 可以将 现有流添加到解决方案 中，以便在将操作添加到您的代理时可用。
  • 在100秒的操作限制内，返回与回复 Copilot 操作同步的回复。 为避免超时，请优化流逻辑、查询和返回的数据量，以便典型运行低于此限制。 需要运行更长时间的操作可以放在回复助手操作之后，以继续最长执行流运行持续时间限制，通常为 30 天。

先决条件

创建用于代理的流

  1. 转到 代理的 Topics（主题 ）页面。

  2. 打开要从中调用流的主题。

  3. 选择现有节点下的添加节点 (+) 添加新节点。

  4. 在节点选择窗口中，选择调用操作、基本操作，然后选择创建流。

    “调用操作”菜单中“创建流”选项的屏幕截图。

    Power Automate 门户将在新选项卡中打开，起始流模板也会同时打开，供您进行编辑。 门户将以与代理相同的环境打开，并使用相同的用户凭据。

    从 Copilot Studio 调用的 Power Automate 流模板的屏幕截图。

    小费

    重命名节点，使其更容易识别。 选择节点的名称字段以直接更新名称，或者选择节点的更多图标 (…)，然后从菜单中选择重命名。 您也可以在代码编辑器中重命名节点。

    无法重命名触发器节点和转到步骤节点。

    节点名称最长可达 500 个字符。

现在向流中添加操作。 在本例中，您添加了一个从 MSN Weather 获取当前天气预报的操作。

  1. 选择流的名称，将其重命名为获取天气预报。

    选定流名称的屏幕截图。

  2. 将以下输入参数添加到从助手运行流触发器中：

    • 城市（文本）
    • 邮政编码（数字）

    Power Automate 流的输入参数的屏幕截图。

  3. 选择添加操作，在从助手运行流流触发器下创建一个新操作。

    “添加流操作”按钮的屏幕截图。

  4. 搜索 MSN 天气，然后选择获取今天预报操作。

    MSN 天气连接器下的“获取今天预报”操作的屏幕截图。

  5. 在获取今天预报操作中，在位置框中，选择添加动态内容，然后选择城市和邮政编码。

    添加到“获取今天预报”操作的变量的屏幕截图

  6. 在回复助手操作中，添加以下输出参数和变量：

    输出参数 类型​​ 变量
    day_summary String 日间摘要
    location String 地点
    chance_of_rain 数字 日间降雨概率

    添加到流响应操作的动态输出变量的屏幕截图。

  7. 选择保存。

管理流使用的连接

在受支持的经过身份验证的代理中，可以将 云端流配置为在作为生成编排计划的一部分运行或从主题调用时使用用户凭证 。 如果您在支持的渠道中使用流，则无需在代理对话框中进行特殊配置，并且用户将能够 在使用代理时管理其连接 。

使用 客户管理的密钥（CMK） 的环境中的云端流尚不能作为生成编排计划的一部分或主题使用最终用户凭证运行。 确保将 CMK 环境中的云端流的仅运行设置设为特定连接，而不是由仅运行用户提供。

修改现有流以与代理一起使用

如果您的流具有不同扳机键，并且希望将其与代理一起使用，则可以更改流以使用 Run a flow from Copilot 扳机键（运行从 # 和 Respond to Copilot 回复操作，并确保它位于与自定义代理具有相同环境的解决方案中。

  1. 转到 Power Automate 门户网站，使用右上角的环境选择器选择存储您的流的环境。

  2. 导航至左侧的我的流，并搜索该流。

  3. 选择该流。

    默认解决方案中“获取天气预报”流的屏幕截图。

添加助手触发器和回复操作

如果您的流尚未包含 Copilot 扳机键和回复操作，则必须先添加它们，然后才能将流与代理一起使用。

  1. 选择新建步骤。

  2. 搜索助手，然后选择从助手运行流。

  3. 选择新建步骤。

  4. 搜索助手连接器并选择回复助手。 回复操作可以在流中的多个分支使用，但每次使用时必须有相同的输出。

  5. 保存并发布流。

确保回复操作设置为实时返回

要在代理中使用的流必须实时或 同步返回值。 在后台运行或异步运行的流，当您的代理尝试运行它们时，可能会导致错误。 代理不会运行流，而是说“发生了意外的事情。 我们正在调查。 错误代码：3000。”

当您从 Copilot Studio 创建流时，默认关闭异步响应。 如果修改了已打开异步回复的现有流，请按照以下步骤检查设置并确保其已关闭：

  1. 打开您的流 并找到 Respond to Copilot 操作。

  2. 选择设置选项卡。

  3. 将异步响应设置为关，然后选择完成。

    异步响应切换的屏幕截图。

将流添加到解决方案中

要可供代理使用，流必须存储在同一环境的解决方案 中 Power Platform 。 如果流在解决方案中，则解决方案磁贴将显示在流的详细信息页面上，其中列出了流所在的解决方案。 可以将流添加到 默认解决方案 中以用于代理，也可以使用以下步骤移动到其他解决方案中：

  1. 转到 Power Automate 门户。

  2. 转到解决方案，然后选择现有解决方案或为您的流创建解决方案。

    要创建解决方案，选择新建解决方案。

    “新建解决方案”按钮的屏幕截图。

    为新解决方案命名，在发布商字段中选择 CDS 默认发布商，输入版本号，然后选择创建。

    解决方案属性的屏幕截图。

  3. 在解决方案选项卡上，转到要使用的解决方案。 选择添加现有向解决方案添加流。

    “添加现有”按钮的屏幕截图。

  4. 在添加现有流页中，选择从解决方案选项卡，选择您的流，然后选择添加。

    解决方案中现有流列表的屏幕截图。

    要将流从我的流选项卡移到解决方案，选择外部解决方案，然后选择添加将您的流添加到解决方案。

    解决方案外部的现有流列表的屏幕截图。

相关内容