了解如何通过为代理提供根据请求生成天气预报的能力来使用 Copilot Studio 云端流。 在第一个示例中,您将创建一个获取天气预报的流。 在下一个示例中,您设置了一个主题,以便调用流作为操作,这样当客户询问天气时,代理就可以用天气预报做出回应。
若要使用代理作为工具,代理流需要以下各项:
- 让 代理调用流 触发器以及 响应代理的响应作。
- 配置为实时响应,而不是异步响应。 异步响应切换必须在“响应代理作设置”中的“网络”下设置为“关闭”。
- 在 100 秒的作限制内响应代理。 优化流逻辑、查询和返回的数据量,以便典型的运行低于此 100 秒的限制。 在 响应 Copilot 作继续运行到流运行持续时间限制为 30 天之后,可以放置需要运行更长时间的作。
从 Copilot Studio 创建代理流时,会为你添加所需的流触发器和响应作。 您可以修改现有流,以便用于代理,方法是使其使用此触发器和响应操作。
先决条件
- 使用包含 Copilot Studio 中流使用的许可证访问 Copilot Studio。
创建可与代理一起使用的流
转到代理的主题页面。
打开要调用流的主题。
选择任何节点下方的 “添加节点 ”图标
,然后选择 “添加工具”。在 “基本工具 ”选项卡上,选择“ 新建代理流”。
此时会打开 “流 ”页,并在代理流设计器中打开初学者流模板进行编辑。
现在向流中添加操作。 在本例中,您添加了一个从 MSN Weather 获取当前天气预报的操作。
选择流的名称,并将其替换为“获取天气预报”。
选择 代理调用流触发器时 ,并添加以下输入参数:
- 城市(文本)
- 邮政编码(数字)
选择代理调用流触发器时下方的“添加”图标。
在添加操作中搜索“MSN 天气”,然后选择获取今天预报操作。
在获取今天预报面板的位置框中输入斜线(
/),选择 插入动态内容,然后选择城市输入参数。以同样方式添加邮政编码输入参数。
在 “响应代理 ”作中,添加以下输出参数和变量:
输出参数 类型 变量 day_summary文本 日间摘要 location文本 地点 chance_of_rain数字 日间降雨概率
保存并发布流。 成功创建流时会显示一条通知。
选择 “返回代理”以 返回到 Copilot Studio 中的主题。
若要继续,请按照 从代理调用代理流中的说明进行作。
管理流使用的连接
在受支持的经过身份验证的代理中,可以将云端流配置为在作为生成式业务流程计划的一部分运行或从主题调用时使用用户凭据。 在受支持的渠道中使用流不需要在代理中进行任何特殊配置。 客户可以在使用代理时管理其连接。
使用 客户管理的密钥 (CMK) 的环境中的云端流尚不能使用客户凭据作为生成式业务流程计划的一部分或从主题运行。 确保将 CMK 环境中的云端流的仅运行设置设为特定连接,而不是由仅运行用户提供。