UiPath Documentation
agents
latest
false
重要 :
新发布内容的本地化可能需要 1-2 周的时间才能完成。

智能体用户指南

上次更新日期 2026年5月15日

管理 UiPath 智能体

Automation Cloud 中的“智能体”页面是所有 UiPath 智能体的集中注册和观测中心。它用于监控性能,测试对话行为,管理共享资源,并保持已部署生态系统中的可见性。

您可以在一个位置:

  • 实时监控已部署的智能体并查看性能指标。
  • 在部署之前和之后测试对话智能体。
  • 调查和解决智能体故障或运行状况降级的情况。
  • 从 UiPath Marketplace 访问和部署智能体模板。
  • 管理上下文锚定索引。

该集中化中心可对所有智能体运行时进行实时监控,并在发现错误、运行状况评分下降和运行时评估分数偏低时发出警示。

术语

  • 智能体实例是正在运行的业务流程中的单个已部署智能体,在 BPMN 中表示为任务,是智能体 runtime 的实时执行,可以对特定触发器、队列或其他工作流条件做出响应。
  • 智能体实例管理表示与监控、维护、改进和终止智能体以及智能体作业相关的任务集。

关键功能

以下是 Automation CloudTM 中重新设计的“智能体”页面的关键功能:

  • 使用 BPMN 工作流进行实时智能体监控。
  • 通过 BPMN 定义的事件进行错误处理和恢复。
  • 智能体与人工操作员之间的 runtime 智能体协调。
  • 通过决策网关进行合并和共识处理。
  • 基于多个指标的性能分析和优化。
  • 监管和合规性检查,确保遵守企业规则。

概述

概述”选项卡高度概括了智能体生态系统的摘要,将运营洞察、性能指标和消耗量分析整合到一个统一视图中。它起命令中心的作用,用于了解智能体在您组织中的性能及其资源消耗效率。

性能洞察

该选项卡汇总所有已部署智能体的 runtime 数据,以帮助您监控性能趋势并发现优化机会。关键指标包括:

  • 作业总数:跟踪已完成的智能体执行总数,提供活动和采用情况的衡量指标。
  • 成功率:衡量智能体成功运行的百分比,以帮助您评估可靠性,并检测智能体配置中反复出现的错误或不稳定问题。
  • 平均响应时间:表示您的智能体能够完成任务的速度,使您能够大规模监控延迟和效率。
  • Agent Unit 消耗量:量化所有智能体的总单元使用量,以便更好地进行预测、预算编制和资源分配。

监控和反馈分析

该选项卡还显示了您的环境中的消耗量和反馈趋势:

  • Agent Unit 消耗报告显示最活跃或成本最高的智能体,有助于确定调整或资源分配的优先级。
  • 反馈摘要突出显示了用户交互次数最多或性能评分最高的智能体,帮助团队专注于改善用户体验和影响。

筛选和基于时间的分析

管理员可以分析各个维度的数据,例如智能体类型、部署状态或时间范围,以识别定义的运营周期(例如,每天、每周或每月视图)内的异常并评估趋势。使用这些筛选条件,可以进行针对性分析并简化报告。

  • 管理已部署的智能体并监控其性能。
  • 管理和监控您的早期体验版智能体。

已部署的智能体

已部署的智能体选项卡提供所有智能体类型中已部署的所有智能体的综合视图,以及实时性能、运行状况和反馈指标。它起主工作区的作用,用于监控运营效率、诊断问题并确保已部署的智能体提供一致的高质量结果。

统一的智能体可见性

此视图汇总了租户中所有的生产就绪型智能体,无论其类型如何,从而使管理员和开发者能够快速评估运营状态和近期的活动。每张智能体卡片都将智能体类型(对话式、自主式或编码式)显示为徽章,同时显示关键运营指标:

  • 成功率 – 成功运行的百分比,有助于您识别降级或性能不佳的智能体。
  • 平均响应时间 – 衡量最近作业的执行速度和效率。
  • 反馈量 – 为智能体收集的用户或系统评估数量。
  • 运行状况指标 – 反映整体性能趋势和 Runtime 稳定性的可视化提示(例如,“运行正常”、“已降级”)。

智能体可以按状态、文件夹或时间范围进行筛选。使用类型筛选器将视图范围缩小至特定的智能体类型:对话式自主式编码式

运营洞察和性能跟踪

该选项卡提供除简单 runtime 状态以外的上下文分析。您可以探索:

  • 活跃作业和已完成的作业 – 单独的时间线可以跟踪实时执行和已完成的运行,有助于识别工作负载峰值和瓶颈。
  • 错误和延迟模式 – 性能图表显示执行错误、首次响应时间和延迟百分比,使团队能够微调响应速度。
  • 反馈趋势 – 聚合情感分析(积极与消极)显示了智能体质量如何随时间而变化,以及哪些更新会影响用户满意度。

这些洞察有助于诊断系统性问题,验证新部署并确定优化工作的优先级。

备注:

当为追踪记录启用 CMK 加密时,实例管理图表将不可用。 由于追踪记录属性在 Insights 中加密,因此无法查询,导致生成这些图表所需的分析无法运行。

使用和消耗分析

仪表板突出显示了智能体与其环境的交互方式及其资源消耗方式:

  • Agent Unit 使用量 – 跟踪总消耗量,并识别成本或资源利用率方面的异常值。
  • 调用最多的功能 – 列出智能体运行中最常用的操作(工具、活动或索引),帮助团队了解行为模式和常见依赖项。

详细的智能体 runtime 视图

选择单个智能体会打开详细的分析工作区,其中包含:

  • 映射智能体逻辑、工具和记忆源的 runtime 图。
  • 运行状况分数可视化内容,用于评估提示设计、工具集成和评估覆盖范围。
  • 执行追踪记录,提供每次运行的细粒度可见性(输入、输出、错误和时间详情),使开发者能够重建和调试智能体的推理流程。

智能体实例视图提供单次智能体执行的完全可观察性,提供单次运行中的完整决策、操作和性能指标追踪记录。

了解追踪视图

追踪视图将智能体逻辑的图形表示与时序一致的执行数据相结合,使您能够查看每个步骤的流程和结果。画布显示了代表主要智能体组件(如模型和工具)的节点,这些节点按顺序连接。

打开智能体运行的“追踪”视图后,请按照以下步骤与追踪数据交互并对其进行调查:

  1. 预览节点信息。 将鼠标悬停在画布上的任何节点上以查看工具提示,包括:
    • 执行状态(成功、重试或失败)
    • 开始和结束时间戳
    • 输入和输出数据的预览 这有助于快速了解每个步骤发生的情况,而无需打开全部详细信息。
  2. 查看节点的完整详细信息。选择任何节点以打开详情面板,其中包括:
    • 完整的输入和输出有效负载 (JSON)
    • 执行日志或错误消息(如适用)
    • Runtime 指标,例如延迟和令牌使用情况
    • 配置参数(如有)
  3. 在相关步骤之间浏览,以了解信息在智能体中的流动方式:
    • 选择已连接的节点,以向上游或下游移动。
    • 这有助于您追踪一个步骤的决策、输入和输出如何影响下一个步骤。
  4. 使用“ 执行追踪 ”面板。 此面板显示智能体运行期间按时间顺序排列的所有记录操作列表。
    • 选择追踪日志中的一个行,在画布上高亮显示相应节点。
    • 同样,在画布上选择一个节点,会自动高亮显示追踪日志中的相关行。

草稿智能体

草稿智能体”选项卡包含未发布的智能体或正在开发的智能体。

每个草稿都以卡片的形式显示,其中包含:

  • 智能体名称(或“无标题”,如果尚未重命名)。
  • 上次更新的时间戳。
  • 用于在 Studio Web 中重新打开草稿以便进一步编辑的快速链接。

草稿智能体可以恢复、编辑或在最终确定后发布。

上下文锚定索引

“上下文锚定索引”选项卡使您能够监控索引的状态和运行状况,并在租户级别跟踪其摄取进度。

索引监控”部分提供以下指标的图形化洞察:

  • 查询:追踪在选定时间间隔内对索引执行的查询数量。
  • 索引作业:显示已完成的摄取作业数量。 如果在所选时间段内未运行任何作业,则会显示一个占位符图形。

索引”表列出了租户内的所有可用索引。有关索引的更详细信息,请在表格中选择索引。各个视图提供以下信息:

  • 索引名称、文件夹和来源
  • 健康状态,指示索引是“健康”还是“降级”
  • 存储大小、摄取状态、上次同步和上次查询时间戳

从表格中选择索引以打开其详细信息页面。“索引详细信息”视图提供:

  • 在所选时间间隔内的查询。
  • 显示总体健康分数和两个组成标准的健康图表。
  • 摄取历史记录、列表已完成、失败、跳过或已删除的同步运行。

使用此视图来调查降级的索引,查看摄取可靠性,或查看索引的上次查询时间。

索引运行状况分数

“索运行状况”可帮助您监控上下文锚定索引的状况,并识别可能需要维护或清理的索引。 它提供了一个自动化的客观分数,显示每个索引的性能以及使用频率。

每个索引都根据两个条件收到运行状况分数:

  • 摄取可靠性 – 在最近一次摄取运行期间处理文档的成功程度。
  • 利用率 – 索引最近被查询的情况。

综合分数可帮助您确定索引是否处于健康状态并提供价值(总分高于 75%),或降级(总分低于 75%)。 每次成功摄取或查询后,分数会自动更新。

每 15 分钟为所有租户重新计算一次索引运行状况,仅适用于已完成摄取作业的索引。 在运行状况评分开始之前,新索引在创建后有 24 小时的宽限期。

下表格介绍了如何计算每个运行状况条件并对其进行加权,以确定索引的总体运行状况分数。

条件指标公式注意
提取可靠性上次摄取的Success率100 × (1 - 失败文档数 / 总文档数)跳过和删除的文档被排除在外。 如果在 24 小时内未完成任何摄取,则分数 = 0。
利用率自上次查询以来的天数(最多 90 天)100 × (1 - 天数自最后查询 / 90)24 小时未进行任何查询,分数 = 0。
总体运行状况两个指标的平均值(摄取可靠性 + 利用率)仅当两个组件分数都存在时,才会计算。

您可以在两个位置查看健康状态:

  • “上下文锚定索引”列表 – “行状况”列显示彩色指示器(绿色表示“运行状况”,红色表示“降级”)。 将鼠标悬停在其上,将显示每个维度的详细信息(摄取可靠性和利用率)。
  • “索引详细信息”视图 – 专用“运行状况”图表显示总分和组件指标。 您还可以跟踪摄取历史记录,并在可靠性较低时调查问题。

“反馈”选项卡(预览版)

“反馈”选项卡提供了一个集中视图,用于查看智能体追踪并捕获反馈,帮助持续提高智能体的可靠性。它将 Runtime 分析与反馈驱动的情景记忆相联系,让智能体能够逐步优化其决策,而无需重写提示词。

反馈在两个方面发挥着相辅相成的作用:

  • Runtime 分析和诊断:查看已完成的智能体运行,以了解行为,找出问题,并批注特定决策或输出。
  • 输入情景记忆:高质量的反馈可以提升为情景记忆,使智能体能够重复成功行为,并避免在未来的运行中出现错误行为。

反馈概览

页面顶部部分提供了汇总见解:

  • 反馈最多的智能体显示哪些智能体收到的正面和负面反馈最多。
  • 一段时间内的反馈将反馈趋势可视化,帮助您将行为变化与性能提升或下降相关联。
  • 时间范围筛选器用于将分析范围缩小到最近的运行或历史运行。

图 3. 智能体实例管理中的“反馈”选项卡

向智能体运行添加反馈

要提供反馈:

  1. 从“反馈”页面中选择“添加反馈”
  2. 从已执行作业列表中选择智能体 Runtime 作业。
  3. 查看追踪,并将反馈附加到相关跨度。

防护机制

防护栏选项卡集中显示已部署智能体的防护栏活动,帮助运营商确保智能体可靠、安全地运行,同时符合组织策略。它将运行时防护栏数据集中显示在一处,从配置覆盖范围到执行结果,一览无遗。

此选项卡围绕三个阶段进行组织:

  • 配置防护栏 — 为您的智能体添加智能体级、LLM 级或工具级防护栏。
  • 监控 — 在运行时查看防护栏活动,跟踪防护栏触发的频率以及它们强制执行的操作。
  • 微调防护栏 — 利用评估数据持续对防护栏行为进行测试、调整和优化。

智能体防护机制使用情况

此饼图基于执行数据,展示了您租户中已配置防护栏与未配置防护栏的智能体所占的比例。至少运行过一次的智能体才会反映在此图表中。利用此视图,您可以评估已部署智能体生态系统中的监管覆盖范围,并确定可能需要配置防护栏的智能体。

调用次数最多的操作

此堆叠条形图显示了在您的智能体中强制实施的防护栏操作的数量及细分。每个条形代表一个已部署的智能体,并按操作类型进行划分:阻止、升级和筛选。利用筛选器,您可以显示防护栏调用总数排名前 5 或前 10 的智能体,这与“智能体”页面上的其他监控图表保持一致。

防护机制详细信息

下表列出了所有已部署的智能体及其防护栏活动。您可以筛选表格,以显示配置防护栏的智能体、未配置防护栏的智能体或所有智能体。利用时间范围筛选器,您可以将数据的作用域限定在选定时段。

描述
防护机制数量为智能体配置的防护栏数量。
最新防护机制在智能体执行期间最近一次触发的防护栏的名称。
防护机制类型防护栏的类型分类。
范围防护栏适用的级别:智能体、LLM 或工具。
执行阶段防护栏是在智能体、工具或 LLM 执行之前还是之后运行:执行前或执行后。
最新操作最近一次触发的防护栏强制执行的操作:升级、记录、筛选或阻止。
操作结果最近一次强制执行操作的结果:继续、拒绝、记录、筛选或阻止。

此页面有帮助吗?

连接

需要帮助? 支持

想要了解详细内容? UiPath Academy

有问题? UiPath 论坛

保持更新