添加输入和输出变量

重要提示

继在生成式人工智能的重大投资和跨 Microsoft Copilot 的增强集成之后,Power Virtual Agents 功能和特性现已成为 Microsoft Copilot Studio 的一部分

在我们更新文档和培训内容时,一些文章和截图可能会参考 Power Virtual Agents。

使用变量作为输入和输出参数在 Power Automate 流和 Microsoft Copilot Studio 助手之间传递信息。

重要提示

助手在一次操作中最多只能从数据流中接收 1 MB 的数据。 然而,助手可以发送的数据量或传递的变量数量没有限制。

在本例中,您将创建一个带有输入参数的流,并将其作为输出参数返回给助手。

先决条件

  • 了解如何从 Copilot Studio 创作画布创建流

支持的参数类型

助手可以使用以下类型的 Power Automate 流输入和输出:

  • 数字
  • String
  • 布尔型

不支持以下类型:

  • Object
  • Date
  • 时间戳
  • 列表 [字符串]
  • 列表 [数字]
  • 列表 [布尔值]
  • 列表 [对象]
  • 列表 [日期]
  • 列表 [时间戳]

创建主题和流

  1. 请转到您的助手的主题页面

  2. 创建一个名为回应消息的新主题。

  3. 添加触发短语回应

  4. 添加一个问题节点,输入消息告诉我一些事,我会回复您

  5. 对于标识,选择用户的完整响应

  6. 对于将响应另存为,选择铅笔图标,将变量重命名为 userResponse

    问题节点的屏幕截图。

  7. 在创作画布上,选择添加节点 (+)。 选择调用操作,然后选择创建流

  8. 在 Power Automate 门户中,将流命名为回应参数

向流添加输入参数

  1. Microsoft Copilot Studio 流触发器中,选择添加输入

    Microsoft Copilot Studio 流触发器的屏幕截图,突出显示“添加输入”。

  2. 选择文本,输入名称 String_Input

    流触发器输入的屏幕截图。

向流添加输出参数

  1. 将值返回 Microsoft Copilot Studio 响应操作中,选择添加输出

    流响应操作的屏幕截图,突出显示“添加输出”。

  2. 选择文本,输入名称 String_Output

    响应操作输出的屏幕截图。

  3. 对于 String_Output 值,选择 String_Input 变量。

    选择作为输出参数值的输入参数的屏幕截图。

  4. 选择保存

选择助手主题中的变量

  1. 在 Microsoft Copilot Studio 创作画布上,选择添加节点 (+),然后选择调用操作

  2. 选择您之前创建的流回应参数

  3. 对于 String_Input(text) 从以下位置获取值,选择 userResponse

  4. 添加消息节点。 选择插入变量,然后选择 String_Output

    回应参数流的操作节点的屏幕截图。

  5. 测试助手面板中测试您的主题。

    助手对话截图。

可以选择使用文字值作为输入参数

或者,您可以直接在“从以下位置获取值”框中键入值,而不是使用变量作为操作的输入参数。

作为输入参数传递的文字值的屏幕截图。

使用变量