对自定义助手使用操作(预览)

您可以通过添加一个或多个操作来扩展助手的功能。 您的助手使用操作来自动响应用户,方法是使用生成式操作,或者您可以在主题中明确调用。

[本文为预发布文档,可能会发生变化。]

核心操作类型

如果您打开生成式模式,您的助手会自动选择最合适的操作或主题,在运行时回复用户。

在经典模式下,助手只能使用主题来回复用户。 但是,您仍然可以将您的助手设计为从主题中显式调用操作。

操作基于以下核心操作类型之一:

  • 预生成连接器操作
  • 自定义连接器操作
  • Power Automate 云端流
  • AI Builder 提示
  • Bot Framework 技能

重要提示

您不能将在 Copilot Studio 中创建的对话操作用作自定义助手的操作。

每个核心操作都有描述其目的的附加信息,允许助手使用生成式人工智能生成问题。 这些问题是填写执行操作所需的输入所必需的。 因此,您不需要手动创建问题节点来收集所有需要的输入,例如流上的输入。 输入在运行时为您处理。

操作可以使用操作的结果生成对用户查询的上下文回复。 或者,您可以为该操作显式创作回复。

小费

当使用操作生成的问题时,通知用户一些对话可能是由人工智能生成的。

例如,在开始对话系统主题中添加一条额外消息。 此主题决定了新对话开始时向用户显示的消息。

添加操作

  1. 在左侧导航窗格中选择助手,然后从列表中选择您的助手,即可打开您的自定义助手。

  2. 选择操作查看助手的操作。

  3. 选择+ 添加操作

  4. 选择操作(预览)向导中,搜索并选择您要使用的操作。

    显示的默认列表在您的环境中有 Power Automate 个可用的流和自定义连接器。 此列表包括常用的预生成连接器和在您的助手中注册的 Bot Framework 技能。

    打开操作类型筛选器时操作向导第一页的屏幕截图。

    重要提示

    一些从 AI 插件创建的操作,比如动态提示和那些基于 Dataverse API 的操作,需要身份验证

    连接页面的屏幕截图。

    根据操作的不同,您的连接会自动配置,如示例所示。 或者,如果向导中给出了说明,您需要配置连接。 成功配置连接后,选择下一步

    连接页面上操作向导第一页的屏幕截图。

  5. 如果需要,查看并更改您的插件操作配置。 选择完成将操作添加到您的助手。

    选择下一步

调用操作

如果您启用了生成操作,您的操作会自动调用以响应相关的用户查询。

或者,您可以从主题中显式调用操作

测试您的操作

调用操作

您的助手根据名称和描述选择并运行您的操作。 您可以创作高质量的描述,使用专用跟踪模式查看您的助手从生成式操作页面中选择了哪些操作。

或者,如果您向主题添加了操作,您可以通过输入类似于该主题的触发短语之一的消息来测试。

在这张截图中,您可以看到一个正在对天气操作进行测试:

正在测试的操作的屏幕截图。

或者,如果您向主题添加了操作,您可以通过使用合适的触发短语触发您的主题来进行测试。

为操作配置输入和输出

对您的操作配置进行更改

有许多方法可以配置您的操作。 在操作向导的最后一步,称为查看并完成,您可以通过单击相应部分旁边的编辑来更改操作的配置。

操作详细信息

您可以在此配置操作的详细信息,包括操作的模型显示名称模型描述。 通常,名称和描述是根据您选择的操作预先填充的。

每个输入的显示名称描述属性有助于助手理解输入的目的,向用户提出适当的问题,并识别用户回复中的正确值。 例如,以下是 MSN Weather 连接器的位置输入参数的默认名称和描述。

  • 名称:位置
  • 描述:位置搜索查询。 有效输入包括城市、地区、州、国家/地区、地标、邮政编码、纬度和经度

当向用户询问位置时,助手会发出类似于您想查看哪个位置的天气?您可以输入城市、地区、州、国家/地区、地标或邮政编码。

根据所收集的输入,您可以将标识为选项更改为特定的实体类型,这有助于助手从用户的响应中准确提取值。

默认情况下,每个输入都设置为动态填充最佳选项。 助手尝试从可用的上下文中填充值,例如从用户的消息中提取值。 如果没有找到合适的值,它会生成一个问题,要求用户输入一个值。 您可以用一个值覆盖输入,而不是询问用户。 要覆盖,请更改助手将如何填充此输入?下拉至设置为值,然后输入一个值。 该值可以是文字值、现有变量或 Power Fx 公式。

操作配置输入部分的屏幕截图。

要控制助手在询问值或验证用户答案时的行为,您可以为输入配置附加设置

输出

默认情况下,您的操作被配置为根据用户的查询和操作结果,自动为用户生成上下文回复。 例如,如果用户问,“伦敦现在的温度是多少?”,使用 GPT 生成上下文回复,例如“伦敦的当前温度是 9 摄氏度”。

或者,您可以选择为您的操作创建一个特定的回复。 与确认编辑器一样,您可以使用变量选择器从操作中插入对输出变量的引用,如下例所示。

变量选择器打开时输出回复编辑器的屏幕截图。

从主题中调用操作

您可以从主题中显式调用操作,类似于调用其他操作类型,比如 Power Automate 流。 根据您的用例,您可以将流作为一个更广泛的主题的一部分,使用更多的节点。 或者,就像在天气的例子中,向主题添加一个操作节点可能就是您所需要的。

要从主题中调用操作:

  1. 在 Copilot Studio 中,转到您要编辑的助手的主题页面。

  2. 创建一个新主题,然后将其命名为获取天气

  3. 添加以下触发短语

    • 是否下雨
    • 今日预报
    • 获取天气
    • 天气情况

    新主题中触发短语的屏幕截图。

  4. 选择添加节点+),然后选择调用操作。 切换到插件操作(预览)选项卡,然后选择您之前创建的操作,获取天气预报

    打开新节点菜单并选择天气操作的屏幕截图。

  5. 您的插件操作(预览)节点现已添加到您的主题中。

    主题中新操作节点的截图。

  6. 选择保存

从主题调用操作时覆盖输入

默认情况下,当您的操作运行时,您的助手会为用户生成问题以填充所需的输入。 但是,您可能希望覆盖一个或多个输入,并提供一个显式值,而不是询问用户。 您可以在输入部分的插件操作配置中进行覆盖。 或者,您可以仅在从特定主题使用操作时覆盖值:

  1. 在节点上选择设置值,并选择您想要覆盖的输入。

    可被覆盖的输入列表的屏幕截图。

  2. 对于输入,通过键入值、选择变量或使用公式来输入值。

    单位输入已被覆盖的屏幕截图。

现在该输入已被覆盖,助手不会要求用户输入值。

为 AI 操作启用身份验证

一些操作,当基于 AI 操作创建时,需要身份验证才能正确运行,例如动态提示或其他调用 Dataverse API 的操作。

操作总是在最终用户上下文中的 Microsoft Copilot 运行时中运行,除非启用了身份验证,否则无法运行。 支持两种类型的身份验证方法:

  1. 转到连接器操作属性。

  2. 最终用户验证下,选择助手创作者验证

  3. 在助手测试窗格或所需渠道中发布并测试体验。

    设置连接器设置的屏幕截图。

使用具有最终用户凭据的流操作

流操作可以配置为使用最终用户凭据。 如果您在受支持的渠道中使用流,则无需在助手对话框中进行特殊配置,最终用户能够在提供的体验中管理其针对给定流的连接

对基于库中插件的操作进行身份验证

当基于 AI 插件创建时,操作需要身份验证才能正确工作。 这在基于提示或其他调用 Dataverse API 的操作中最为常见。 基于插件的操作始终在最终用户上下文中运行,除非启用身份验证,否则无法运行。 支持两种类型的身份验证方法:

  • 集成式身份验证(Teams 和 Power Apps):如果您想将您的助手发布到 Teams 渠道,可以使用此身份验证方法。 这种方法也适用于任何 Power Platform 应用程序中嵌入的助手,这些应用程序使用 PPAPI 标准构建的令牌。

  • 手动身份验证(第三方助手):此身份验证方法需要设置 Microsoft Entra ID 连接。

要创建手动身份验证连接:

  1. 设置一个 Microsoft Entra ID 应用程序

  2. 在您的 Copilot Studio 助手上设置手动身份验证

  3. 允许您的应用使用委托来代表用户获取令牌。 确保添加任何必要的范围。

    身份验证设置