查看代理活动

创建代理是一个反复的过程。 它涉及了解代理的工作原理、进行更改和查看结果,以便生成更好的代理。 Copilot Studio 的活动跟踪提供可视化映射,显示智能体在会话中的输入、决定和输出顺序,让您可以发现问题和改进机会。

每个会话都会生成一个活动图,从代理开始对话或被外部事件触发时开始。 每个活动都由一个节点在图中表示。

活动跟踪有两种形式:

Note

仅适用于启用了生成编排功能的代理。

仅显示你个人与代理的交互,以及代理使用你的凭据进行身份验证的记录。 代理必须使用 集成的Microsoft身份验证 来标识交互。

测试期间实时活动映射

当您在测试窗格中向代理提出问题时,活动地图会显示所生成的规划的可视化表示方式。 地图强调错误,例如动作的输入或输出参数缺失或无效,并展示每个步骤的执行时间。 您还可以验证代理发送或接收的信息是否正确。

若要使活动地图在测试窗格中向代理发送查询时自动显示,请选择 更多选项...),然后切换测试 时显示活动地图

活动图按钮屏幕截图,可选择默认显示。

在这里,用户问道:“明天加拿大多伦多的天气会怎样?您可以看到选择响应的作以及输入和输出。

跟踪模式的屏幕截图,显示了如何呈现计划的示例。

测试事件触发器

测试事件触发器时,触发有效载荷会以消息形式出现在测试聊天中。 该消息仅在 Copilot Studio 中可见,用于测试目的。 代理用户看不到。 您可以使用有效负载消息了解触发器何时以及向代理发送哪些信息和指令。

主题间跟踪

测试代理时,可以使用在主题之间进行跟踪的选项。 启用跟踪功能后,当主题作为计划的一部分被触发时,主题内的节点会随着节点的执行显示在活动图上,让您可以监控对话流。

主题间跟踪选项的屏幕截图。

Note

某个主题内的生成式业务流程活动未显示在活动地图中。

历史活动

每次智能体开始会话(包括在 Copilot Studio 中启动的测试会话)时,活动都会实时记录在活动页面。 转到活动页面:

  • 查看您的代理在会话期间做出的交互和决策
  • 找出代理的行为与您的目标不符的地方
  • 查看代理完成每个活动所需的时间
  • 查找错误详情

历史智能体活动适用于:

Note

制作者必须有 Microsoft Exchange 许可证和收件箱才能查看智能体的历史活动。 数据存储使用 Microsoft 365 服务存储,服务不受 Azure 数据条款和承诺的约束。 相反,此功能由 Microsoft 365 服务提供支持,并存储在最终用户的 Exchange 邮箱地理区域的位置。 Microsoft 365 条款和数据驻留承诺约束历史活动数据。

管理员应使用 Power Platform 管理中心 关闭由 Microsoft 365 存储的数据。 关闭此设置会停止 Microsoft 365 中未来的数据存储。 根据Microsoft 365 的数据保留策略集删除或清除存储在 Microsoft 365 中的现有数据。

更多信息请参阅管理由 Microsoft 365 服务提供支持的活动数据

进入活动页面查看:

  • 会话列表及其详细信息
  • 会话中发生的活动步骤

会话列表

会话是一个代理交互单位,涉及与用户的对话、注册和响应事件,或者这些活动的组合。

在会话列表中,可以看到:

  • 名称:与代理交互的用户的名称。 如果会话不涉及用户,例如当代理执行作而不进行人工提示时,该用户将显示为 “自动”。
  • 渠道:发生交互的渠道。 在智能体测试窗格中发生的会话带有 Copilot Studio 图标。
  • 日期:会话的第一次交互开始的时间。
  • 已完成的步骤数:代理在会话期间完成的步骤数。
  • 最后一步:会话中完成的最后一步。

查看会话活动

“活动” 选项卡中,您可以在可视活动映射或对话脚本和可视活动映射中查看会话中的活动。 默认情况下,将显示 “脚本 + 地图 ”视图。

  1. 若要查看会话的活动,请选择该会话。

    • 若要同时查看脚本和活动映射,请选择 查看 ,然后选择 脚本 + 地图视图
    • 要仅查看活动图,请选择 视图 ,然后选择 地图视图

    在不同视图之间进行选择的屏幕截图。

  2. 要返回会话列表,请选择“返回” 图标。

“脚本 + 地图”视图显示会话期间与代理发生的对话以及可视化活动地图。 脚本记录了用户输入、触发器有效载荷和代理响应。 您可以使用脚本查看代理如何回应与用户的对话。 您还可以查看代理从事件触发器接收到的触发器有效载荷信息。

固定或取消固定会话活动

“活动” 选项卡中,您可以将重要会话固定到会话列表的顶部以便于访问,或者在不再需要它们时取消固定它们。

  • 若要固定会话活动,请将鼠标悬停在会话活动上,然后选择名称旁边的固定 图标。
  • 若要取消固定会话活动,请将鼠标悬停在固定的会话活动上,然后选择名称旁边的“取消固定 ”图标。

查看活动映射中的所有代理活动

“地图”视图是会话期间发生的输入、决策和反应流的可视化表示。 代理、用户或触发器对 节点执行的每个活动。 查看活动映射时,选择一个节点以查看该活动的输入、决策和输出的详细信息。

下图是选择知识节点时看到的一个示例。 它显示:

  • 智能体用于搜索知识源的查询。 它可以不同于用户编写的查询,也可以不同于触发器提供的输入。
  • 基于知识源创建的智能体的响应。
  • 代理引用的源。
  • 其他进行搜索但未用于创建响应的源。 代理搜索了这些源,但没有找到与查询相关的信息。

知识节点的详细信息。

在此示例中,您可以看到 明天获取预测 的动作节点的详细信息,其中包括输入和输出:

成功会话的活动映射的屏幕截图。

选择 “编辑” 以查看和更改与所选活动关联的配置。

理由

理由为智能体决定如何调用特定工具提供说明。 AI 按需生成理由,并基于智能体元数据和活动。 为已完成状态知识源或连接器显示理由。 选择显示理由以显示理由。

突出显示理由输出的活动地图的屏幕截图。

查看智能体活动时,可以使用理由更好地了解智能体选择调用特定工具或填写参数的原因。 它有助于对智能体行为进行故障排除。 但是,由于理由是使用 AI 生成的,因此它有可能不准确,在查看提供的理由时,必须使用最佳判断。

代理状态

下表提供有关智能体在其操作期间可能遇到的各种状态的信息。

国家 条件 适用于
完成 无错误。 最后一条消息不是管理连接对话框。 当对话发起者的已定义步骤计划处于已完成状态时,聊天将完成。 对话可能会进入和退出完成状态。 使用操作的自主智能体或对话智能体
不完整 如果出现问题(其中一个步骤失败),或者所有步骤都处于临终状态,并且并非所有步骤都已完成,则处于未完成状态。 使用操作的自主智能体或对话智能体
已失败 如果所有活动都失败,则处于失败状态。 使用操作的自主智能体或对话智能体
正在进行中 至少一个已定义步骤尚未完成,仍在进行中。 使用操作的自主智能体或对话智能体
正在等待用户 智能体已响应,正在等待用户继续对话。 最后一步需要人工输入。 使用操作的自主智能体或对话智能体
已创建 对话刚开始。 使用操作的自主智能体或对话智能体
已取消 取消任何剩余的动态计划并清空对话堆栈。

发送反馈

若您对提升智能体质量有建议,请通过点赞/点踩按钮在活动选项卡中提交反馈。

发送反馈选项的屏幕截图。