创建流

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

要与代理协同工作，Power Automate 流需要以下流触发器和响应操作：

当您从 Copilot Studio 创建流时，会为您添加所需的流触发器和响应操作。您可以修改现有流，以便用于代理，方法是将其更新为使用这些触发器和操作。

重要提示

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

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

先决条件

转到代理的主题页面。
打开要调用流的主题。
选择任意节点下方的添加节点图标，并选择添加操作。
在基本操作标签中，选择 新建 Power Automate 流。

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

现在向流中添加操作。在本例中，您添加了一个从 MSN Weather 获取当前天气预报的操作。
选择流的名称，并将其替换为“获取天气预报”。
选择从 Copilot 运行流的流触发器，并添加以下输入参数：
- 城市（文本）
- 邮政编码（数字）
选择流触发器从 Copilot 运行流下方的添加图标。
在添加操作中搜索“MSN 天气”，然后选择获取今天预报操作。
在获取今天预报面板的位置框中输入斜线（/），选择 插入动态内容，然后选择城市输入参数。
以同样方式添加邮政编码输入参数。
在回复助手操作中，添加以下输出参数和变量：

输出参数类型变量

day_summary 文本日间摘要

location 文本地点

chance_of_rain 数字日间降雨概率
保存并发布流。
返回 Copilot Studio 中的主题，按照从主题调用流中的说明操作。

在受支持的经过身份验证的代理中，可以将云端流配置为在作为生成式业务流程计划的一部分运行或从主题调用时使用用户凭据。在受支持的渠道中使用流不需要在代理中进行任何特殊配置。客户可以在使用代理时管理其连接。

使用客户管理的密钥 (CMK) 的环境中的云端流尚不能使用客户凭据作为生成式业务流程计划的一部分或从主题运行。确保将 CMK 环境中的云端流的仅运行设置设为特定连接，而不是由仅运行用户提供。

如果具有不同触发器的流希望与代理一起使用，则可以将该流更改为使用从 Copilot 运行流触发器和响应 Copilot 响应操作，并确保它位于与自定义代理相同的环境中的解决方案中。

如果流尚未包含所需的流触发器和回复作，则必须先添加它们，然后才能将流用于代理。

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

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

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

转到 Power Automate。
转到解决方案，然后选择现有解决方案或为您的流创建解决方案。
如果要创建新的解决方案：
1. 选择新建解决方案。
2. 为新解决方案命名，在发布商字段中选择 CDS 默认发布商，输入版本号。
3. 选择创建。
如果要将流添加到现有解决方案中，请选择所需的解决方案，然后选择编辑。
选择添加现有项>自动化>云端流。

出现添加现有流面板。
选择您的流，然后选择添加。