使用变量作为输入和输出参数在智能体流和 Copilot Studio 智能体之间传递信息。
重要
代理在一次操作中最多只能从数据流中接收 1 MB 的数据。 但是,智能体可以发送的变量数量或数据量没有限制。
在此示例中,您将创建一个具有输入参数的流,并将其作为输出参数返回给智能体。
先决条件
- 了解如何在 Copilot Studio 编辑界面中创建流
支持的参数类型
Copilot Studio 智能体支持以下类型的智能体流输入/输出参数:
- 编号
- 字符串
- 布尔
不支持以下数据类型:
- 对象
- 日期
- 时间戳
- 列表 [字符串]
- 列表 [编号]
- 列表 [布尔值]
- 列表 [对象]
- 列表 [日期]
- 列表 [时间戳]
创建主题和流程
转到智能体的主题页面。
创建一个名为回应消息的新主题。
添加触发短语echo。
添加一个问题节点,输入消息“告诉我一些事,我会回复您”。
对于识别,选择用户的完整响应。
对于将用户响应另存为,将变量重命名为 userResponse。
在问题节点下选择
添加节点图标 ,然后选择添加工具。在基本操作选项卡中,选择新建智能体流。 代理流设计器选项卡将在此时打开,其中包含由代理调用的代理流的起始模板。 该流包含两个操作:当智能体调用流和响应智能体。
选择发布在修改前保存流。 成功创建流后,将显示一条通知。
选择返回客服以返回当前主题。 一个新的操作节点已添加到主题中,用于流程。
选择保存完成将流程添加为智能体工具的操作。
编辑流程详情
在包含流程的操作节点上,选择查看流程详情链接返回智能体流程界面。
在流的概述选项卡中,编辑流的详细信息,将名称替换为回显参数。 选择保存。
返回设计器选项卡。
向流添加输入参数
选择当智能体调用流的流触发器,并选择添加输入。
选择文本并输入名称String_Input。
向流添加输出参数
选择响应智能体响应操作,并选择添加输出。
选择文本,输入名称 String_Output。
对于值,在框中输入斜线(
/),选择插入动态内容,然后选择 字符串_Input 变量。选择保存草稿和发布。 Copilot Studio 会在智能体流发布时通知您。
选择返回代理以返回代理主题编辑器。 新的操作流已添加到主题中。
从主题调用流
选择新的操作节点。
将流输入参数设置为问题节点中的输出变量:字符串_Input(字符串)的值来自 userResponse 变量。
添加消息节点。
选择插入变量,然后选择 字符串_Output。
选择保存。
测试您的代理。