agents

latest

false

重要 :

新发布内容的本地化可能需要 1-2 周的时间才能完成。

智能体用户指南

上次更新日期 2025年11月12日

管理 UiPath 智能体

Automation Cloud ^TM中的“智能体”页面是所有 UiPath 智能体的集中注册表和可观察性中心。您可以使用它来监控性能、测试对话行为、管理共享资源，并维护整个已部署生态系统的可见性。

您可以从单个位置执行以下操作：

监控已部署的智能体并实时查看性能指标。
Test conversational agents before and after deployment.
调查并解决智能体事件或下降的运行状况。
前往 UiPath Marketplace 访问并部署智能体模板。
管理上下文基础索引。

术语

智能体实例是对已部署的 UiPath 智能体的单次活跃执行，表示一次运行时发生，智能体在该发生中处理输入、进行推理、执行工具，并根据其定义的逻辑和上下文生成输出。
智能体实例管理表示与监控、维护、改进和终止智能体以及智能体作业相关的任务集。

关键功能

以下是Automation Cloud ^TM中“智能体”页面的主要功能：

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

概述

概述选项卡提供了智能体生态系统的简要摘要，并将运营见解、绩效指标和消耗分析整合到一个集中视图中。它充当命令中心，用于了解智能体在您组织中的运行情况及其使用资源的效率。

性能见解

该选项卡聚合所有已部署智能体的运行时数据，以帮助您监控性能趋势和发现优化机会。关键指标包括：

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

监控和反馈分析

该选项卡还会显示整个环境中的消耗和反馈趋势：

Agent Unit 消耗报告可识别最活跃或成本最高的智能体，从而帮助确定优化或资源分配的优先级。
反馈摘要会突出显示哪些智能体获得最多的用户交互或性能评分，帮助团队专注于改善用户体验和影响。

筛选和基于时间的分析

管理员可以分析智能体类型、部署状态或时间范围等各个维度的数据，以识别异常情况并评估定义操作期间的趋势（例如，每日、每周或每月的查看次数）。这些筛选条件可实现目标明确的分析并简化报告。

已部署的智能体

“已部署的智能体”选项卡提供了当前在生产环境中处于活动状态的所有智能体的合并视图，以及实时性能、运行状况和反馈指标。它是监控运营效率、诊断问题并确保已部署的智能体交付一致的高质量结果的主要工作区。

统一智能体可见性

此视图聚合了租户中所有可生产就绪的智能体，以便管理员和开发者能够快速评估运行状态和近期活动。每张智能体卡都汇总了关键运营指标，包括：

成功率 – 成功运行的百分比，可帮助您识别降级或表现不佳的智能体。
平均响应时间 – 衡量最近作业的执行速度和效率的指标。
反馈数量 – 为智能体收集的用户或系统评估数量。
运行状况指示器 – 反映整体性能趋势和运行时稳定性的视觉提示（例如，运行状况良好、已降级）。

可按状态、类型、文件夹或时间范围筛选智能体，从而实现跨业务领域或部署环境的精确监控。

运营见解和绩效追踪

该选项卡提供的上下文分析不仅仅是简单的运行时状态。您可以探索：

活动和已完成的作业 – 单独的时间线跟踪实时执行与已完成的运行，帮助识别工作负载峰值和瓶颈。
错误和延迟模式 – 性能图表显示执行错误、首次响应时间和延迟百分位，使团队可以微调响应能力。
反馈趋势 – 汇总情感分析（正面与负面），显示智能体质量如何随时间变化，以及哪些更新会影响用户满意度。

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

使用情况和消耗分析

仪表板会突出显示智能体与环境的交互方式以及资源的消耗方式：

Agent Unit 使用情况 – 跟踪总消耗量并识别成本或资源利用率中的异常值。
调用的主要功能 – 列出智能体运行期间最常用的操作（工具、活动或索引），帮助团队了解行为模式和常见的依赖项。
最活跃的用户和工作负载 – 揭示使用集中度，明确谁或哪些流程推动了最高需求。

详细的智能体运行时视图

选择单个智能体将打开一个详细的分析工作区，其中结合了：

一个运行时图表，映射了智能体的逻辑、工具和内存来源。
用于评估提示设计、工具集成和评估覆盖率的运行状况评分可视化。
执行追踪，可对每次运行进行细化查看（输入、输出、错误和计时详细信息），从而使开发者能够重建和调试智能体的推理流程。

智能体实例视图提供对单个智能体执行情况的全面可观察性，可在单次运行中提供决策、操作和性能指标的完整追踪。

了解追踪视图

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

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

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

对话智能体

对话智能体选项卡提供了一个完整的环境，用于管理、测试和分析通过自然语言对话与用户交互的智能体。它将设计时测试、实时聊天评估、运行时见解和反馈分析相结合，可帮助团队持续提高对话性能和可靠性。

您可以直接在聊天界面中测试对话智能体。这个嵌入式 Playground 使您可以模拟现实世界的交换，并评估智能体如何处理意图识别、轮询和上下文连续性。您可以：

与智能体实时交互，发送自然语言提示并观察实时响应。
测试提示词或精心制作自定义消息，以评估所有场景的覆盖范围。
评估智能体在对话循环中应用工具、内存和模型的情况。

此测试环境有助于在部署之前验证对话逻辑，确保准确性和语气符合预期用例。

“运行时”视图提供对话智能体在生产中的执行情况、捕获实时会话、完成率和用户交互的端到端可见性。它可以跟踪响应时间、持续时间和 Agent Unit 消耗量等关键运营指标，以确保跨工作负载的性能、可扩展性和可靠性。

“追踪”视图通过映射智能体的完整推理和执行流程来实现调试和优化。您可以检查决策、工具调用、监管检查点和性能热图，以了解行为，验证逻辑并提高整体对话质量。

“反馈”视图将用户和系统评估聚合到中央仪表板中。它可以可视化情感趋势，突出显示重复出现的问题，并将反馈与单次运行相关联以获取更深入的上下文。这样可以实现迭代微调和持续质量改进。

草稿智能体

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

每个草稿都显示为一个卡片，其中包括：

智能体名称（如果尚未重命名，则为“无标题”）。
上次更新时间戳。
用于在 Studio Web 中重新打开草稿以进行进一步编辑的快速链接。

智能体草稿完成后，可以恢复、编辑或发布。

Context Grounding indexes

The Context grounding indexes tab enables you to monitor the status and health of your indexes and track their ingestion progress at the tenant level.

The Index Monitoring section provides graphical insights into the following metrics:

Queries: Tracks the number of queries performed on your indexes over a selected time interval.
Index jobs: Displays the number of completed ingestion jobs. If no jobs have run in the selected period, a placeholder graphic is shown.

The Indexes table lists all available indexes in your tenant, showing key details such as:

Index name, Folder, and Data source
Health status, indicating whether an index is Healthy or Degraded
Storage size, Ingestion status, Last sync, and Last queried timestamps

Select an index from the table to open its details page. The Index details view provides:

Queries during the selected interval.
A Health chart showing the overall health score and the two component criteria.
Ingestion history, listing completed, failed, skipped, or deleted sync runs.

Use this view to investigate degraded indexes, review ingestion reliability, or check when an index was last queried.

Index health score

The Index health helps you monitor the condition of your Context Grounding indexes and identify those that may need maintenance or cleanup. It provides an automated, objective score showing how well each index performs and how frequently it’s used.

Each index receives a health score based on two criteria:

Ingestion reliability – How successfully documents were processed during the latest ingestion run.
Utilization – How recently the index has been queried.

The combined score helps you determine whether an index is healthy and delivering value (overall score above 75%), or degraded (overall score 75% or below). The score updates automatically after each successful ingestion or query.

Figure 1. Index health score

Index health is recalculated every 15 minutes for all tenants and only applies to indexes with completed ingestion jobs. New indexes have a 24-hour grace period after creation before health scoring begins.

The following table describes how each health criterion is calculated and weighted to determine the overall index health score.

Table 1. Index health scoring criteria
条件	指标	公式	注意
Ingestion reliability	Success rate from last ingestion	100 × (1 - failed_docs / total_docs)	Skipped and deleted documents are excluded. If no ingestion is completed within 24h, score = 0.
Utilization	Days since last query (max 90 days)	100 × (1 - days_since_last_query / 90)	After 24h without any query, score = 0.
Overall health	Average of both metrics	(Ingestion Reliability + Utilization) / 2	Calculated only if both component scores exist.

You can review the health status in two places:

The Context Grounding Indexes list – The Health column shows a colored indicator (green for Healthy, red for Degraded). Hovering over it displays details for each dimension (Ingestion reliability and Utilization).
The Index details view – The dedicated Health chart displays the overall score and component metrics. You can also track ingestion history and investigate issues when reliability is low.