调用操作以拉取 Dataverse for Teams 数据

已完成

通过调用操作节点,助手可以与 Power Automate 流交互。 您可以使用这些流触发自动化流程,或与 Dataverse for Teams 数据、Microsoft Lists 或其他数据源连接。

例如,Event Contacts 助手可以从 Dataverse for Teams 表中提供销售项目团队成员。 当对本团队进行更改时,您可以更新表,而不是编辑助手。

任务 1 - 创建 Dataverse for Teams 表

要创建 Dataverse for Teams 表,请按照以下步骤操作:

  1. 在助手所在团队中创建新的 Dataverse for Teams 表。 请记住,您将需要通过使用适用于 Teams 的 Power Apps 创建它。 在适用于 Teams 的 Power Apps 中,选择生成选项卡,接着选择您的团队。

  2. 为 [您的团队名称] 创建的项目下方选择查看全部,显示团队解决方案列表。 团队解决方案列表包括内置于所选团队的 Dataverse for Teams 中的所有应用、助手、云端流、表等。 如果您选择了创建事件联系人 助手的团队,您将在解决方案列表中看到该助手。

  3. 从顶部的团队解决方案功能区中,选择新建>

    已选择“新建”菜单和“表”的“生成”选项卡的屏幕截图。

    将您的新表命名为 Sales Project Team,然后选择保存。 要使用的列和数据类型如下:

    数据类型
    名称 文本
    电子邮件地址 电子邮件

    您需要将电子邮件地址 列添加到表中,然后再继续下一步。

  4. 为四个联系人中的每一个添加新行。

    名称 电子邮件地址
    Joseph Price JosephP@contoso.com
    Nathan Rigby NathanR@contoso.com
    Amber Rodriguez AmberR@contoso.com
    Monica Thomson MonicaT@contoso.com
  5. 完成后,返回适用于 Teams 的 Microsoft Copilot Studio。

任务 2 - 创建具有操作步骤的助手主题

要添加操作,请按照以下步骤操作:

  1. 在适用于 Teams 的 Microsoft Copilot Studio 中,从功能区中选择助手选项卡,然后找到/选择您的 Event Contacts 助手以将其打开。

  2. 转到您的主题列表。

  3. 通过从“主题”功能区中选择新建主题>从空白开始,创建新主题。 在功能区中选择详细信息,为主题命名。 在名称字段中输入“Sales Project Team”。

  4. 选择触发短语并输入以下各项,每次输入后按 +

    sales project team

    sales project info

    sales team info

    sales project members

    sales project info

  5. 在创作画布的消息节点中,输入:

    Let me look up the Sales Project Team!

    包含名称和触发短语的设置的屏幕截图。

  6. 现在,选择功能区中的保存按钮,保存您的主题。 当您切换到 Power Automate 创建流时,此时尚未保存的任何更改都可能丢失。

  7. 消息节点后添加新节点,然后选择调用操作 > 创建流。 Copilot Studio 可能会显示一个选项框,提醒您在离开之前保存主题。 如果您已保存,请选择离开。 此操作将在 Copilot Studio 中打开 Power Automate 工作室。

    有一些常用模板可供直接选择。 每个模板都允许您在触发流时将信息传递到流。 完成流后,可将信息传回助手。 如果要查看更多模板选项,您可以选择查看更多模板。 一些值得注意的模板包括:

    Power Virtual Agents 流模板 - 本模板仅具有接收信息和将信息发送到助手的步骤。

    向 Teams 渠道发送消息 - 从助手触发 Teams 消息。

    向 Teams 渠道发送自适应卡片 - 触发自适应卡片以向 Teams 渠道提供信息。

  8. 选择名为 Power Virtual Agents 流模板的模板。 当您这样做时,您的触发器将为 Power Virtual Agents,并且其下方有一个名为将值返回到 Power Virtual Agents 的步骤。

  9. 将此流重命名为 Get Sales Team Members

  10. 创建变量,以保留要重新提供给助手的信息。 在触发器和返回值步骤之间,将光标移动到箭头处并选择当鼠标悬停在该空间时显示的插入新步骤图标,然后选择添加操作

  11. 在搜索框中,输入“变量”,然后在操作下,选择初始化变量

  12. 名称输入“varContactInfo”,然后为类型选择字符串。 将保留为空。

  13. 现在,我们需要一个步骤来从 Teams 访问 Dataverse 中的数据。 在您的新初始化变量步骤下,选择插入新步骤图标,然后选择添加操作。 搜索 Microsoft Dataverse 连接器,然后选择列出行作为触发器。

  14. 针对表名称,从下拉列表中选择 Sales Project Team。 (您可以在输入字段中输入“sales”来快速筛选列表。)

    列出行操作将所有表行拉取到数组中。 数组就是表。 若要将数据添加到我们的字符串变量,您需要遍历表的每一行并将每一行数据添加到您的 varContactInfo 变量中。 通过此方式,可以将此数据传回 Power Virtual Agents。

  15. 列出行后选择插入新步骤图标。 选择添加操作

  16. 在搜索框中,输入控制,然后在操作下,选择应用到每一个

  17. 从先前的步骤中选择一个输出字段中,选择它以添加动态内容。 然后从 Dataverse 列出行操作下选择

  18. 应用到每一个步骤中选择添加操作以继续。

  19. 选择并操作搜索框中,输入变量,然后在操作下,选择追加到字符串变量

  20. 追加到数组变量步骤中,针对名称选择 varContactInfo

  21. 针对,我们将创建一个包含每个人的姓名和电子邮件的多行项目符号列表(作为字符串数据)。 Power Automate 在设置文本格式时使用 Markdown 语法。 要指示 Markdown 中的项目符号列表,您要在行的开头使用星号字符 *。 (要了解有关 Markdown 的详细信息,请参阅本模块末尾的“总结”部分)。

    文本框中:

    1. 输入星号 *,然后添加一个空格。

    2. 在动态内容列出行下,选择 Name,然后添加一个空格。

    3. 在动态内容列出行下,选择 Email Address

    4. Enter 以开始一个新行。

    这一步就完成了。

  22. 选择位于流末尾的将值返回到 Microsoft Copilot Studio 步骤,然后选择 + 添加输入

  23. 选择文本作为输出的类型。

  24. 输入标题文本框中,输入 ContactData

  25. 对于输入要响应的值字段,选择输入字段,然后选择变量部分下的 varContactInfo

    您的流现在应如下图所示:

    Get Sales Team Members 流的屏幕截图。

  26. 在 Power Automate 功能区中选择保存,完成流的编辑。 Power Automate 自动运行流检查器以查找问题。 您可能会看到有关“...OData 筛选器查询...”的警告,但该警告可以忽略。 您可以使用 OData 筛选器来限制列出行步骤拉取回的数据,但我们的数据源中只有几行,因此不需要筛选器。 选择关闭以退出 Power Automate 并返回到助手编辑器。

  27. 返回到 Copilot 聊天机器人编辑器,查看您的操作步骤。 您应该会看到刚刚创建的流:Get Sales Team Members 作为操作,并且您创建的 ContactData 字符串变量列为输出。

  28. 在“操作”节点后添加显示消息步骤。

  29. 单击文本框以显示菜单。 在插入变量 {X} 下选择 ContactData。

  30. 在主题编辑功能区中选择保存,等待主题保存。 如果“测试机器人”窗格不可见,则选择“测试机器人”菜单选项。

  31. 测试聊天机器人面板的顶部,确保主题间跟踪选项已打开。

  32. 输入触发短语之一以测试您的 Sales Project Team 聊天机器人。 您的测试聊天机器人将提供一个项目编号列表,其中包含 Sales Project Team 的四个成员姓名和电子邮件地址。

    “Sales Project Team”主题的屏幕截图。

恭喜! 现在,您已经为 Copilot 聊天机器人提供了一种方法来通过集成的 Power Automate 流获取数据表中的信息。