# 代理视图
<a name="agent-view"></a>

*代理视图*为账户代理提供了精心设计的控制面板。您可以查看托管在 Amazon 原生服务（例如：AgentCore Runtime、Lambda 或 Amazon EC2）上的代理数据。该视图还会显示向 CloudWatch 发送遥测数据的代理。

**概述**

指标和控制面板会显示源自采样代理跨度的数据。有关代理跨度的信息，请参阅 [Spans](https://docs.amazonaws.cn/bedrock-agentcore/latest/devguide/observability-telemetry.html#agent_spans)。

支持以下代理指标：
+ 代理/端点 – 已完成埋点并上报跨度数据的代理及别名数量
+ 会话数：由已埋点且生成跨度的代理所创建的会话总量。会话类似于对话，包含完整的上下文信息
+ 追踪数：由已埋点且生成跨度的代理所创建的追踪总量。每次追踪代表会话中的一个独立请求-响应周期
+ 错误率：代理交互过程中出现错误的百分比
+ 节流率：代理交互中被限制的百分比

选择**查看详情**，以图表形式查看代理指标。

![\[代理视图\]](http://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/images/GenAI_AgentCoreGraphs.png)


**运行时指标**

Runtime 指标和控制面板会显示 Runtime 基础组件中的数据。通过该基础组件，您可以在 Amazon Bedrock AgentCore 运行时环境中托管代理。有关更多信息，请参阅 [Creating an AgentCore Runtime](https://docs.amazonaws.cn/bedrock-agentcore/latest/devguide/agents-runtime-create.html)。

AgentCore Runtime 支持以下指标
+ 运行时代理/别名数：追踪托管在 AgentCore Runtime 上的代理和别名数量
+ 运行时会话数：追踪在 AgentCore Runtime 中运行的代理创建的会话数量。会话类似于对话，包含整个交互流程的完整上下文。该指标可用于监控平台整体使用情况、容量规划及用户参与模式分析
+ 运行时调用数：向数据面板 API 发出的请求总数。无论请求有效载荷或响应状态如何，每个 API 调用都计为一次调用
+ 运行时错误数：系统错误及用户错误数量。有关系统错误及用户错误的定义，请参阅 [AgentCore provided runtime metrics](https://docs.amazonaws.cn/bedrock-agentcore/latest/devguide/observability-runtime-metrics.html)
+ 运行时节流数：因超出允许的 TPS（每秒事务数）而受服务节流的请求数量。这些请求会返回 throttlingException，HTTP 状态码为 429。监控该指标有助于判断是否需要调整服务配额或优化请求模式

在默认控制面板中查看指标随时间的变化趋势。展开**查看详情**即可显示指标图表。

![\[运行时视图\]](http://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/images/GenAI_Runtime.png)


**座席**

代理是指从应用程序采集并发送监控数据的组件。代理列表会显示账户中配置的所有代理。这些代理可以托管在 Amazon 原生服务（例如：AgentCore Runtime、Lambda 或 Amazon EC2）上。该列表还会展示其他已埋点并向 CloudWatch 发送遥测数据的代理。

您可以使用**筛选代理**，查找要深入解析的特定代理；也可以使用列名对代理排序，快速定位所需代理。点击齿轮图标可显示或隐藏附加列。

![\[运行时代理视图\]](http://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/images/GenAI_agents.png)


点击代理名称前的展开图标，可查看该代理的详情。

![\[运行时代理概览\]](http://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/images/GenAI_agentsdetails_new.png)


**代理详情 – 概览**

“概览”选项卡会显示代理指标的自动控制面板。这些指标来自采样跨度和运行时指标（如果代理使用 AgentCore Runtime）。

**评估器**控制面板包含从已启用评估功能的跨度数据中提炼的见解信息。
+ 评估器分数最大差值 – 根据选定的时间范围，展示自上一统计周期以来分数变化幅度最大的代理评估器。
+ 评估配置指标 – 展示代理评估器的运行状态指标，包括评估执行次数及出现的错误数量。

如需通过 Amazon Bedrock AgentCore 控制台编辑评估配置，单击**评估器**列或**评估配置**列中的链接即可。如需查看评估器结果，单击**平均分数**列中的分数值。如需查看某一代理的所有评估记录，选择**评估**选项卡。有关更多信息，请参阅 [代理详情 – 评估](session-traces-evaluations.md)。

**代理指标**控制面板包含基于采样跨度生成的指标：
+ 会话和追踪数：该代理的会话和追踪总量
+ FM 令牌使用量：基础模型令牌总消耗量。可按特定基础模型筛选图表数据
+ 系统及客户端错误数：请求处理期间的系统错误总量。较高的服务端错误率可能表明存在需排查的基础设施问题或服务问题。客户端错误是指无效请求导致的错误。较高的服务端错误率可能表明请求格式或权限存在问题
+ 按跨度统计的错误率和延迟：按特定跨度统计的错误率及延迟。请注意，一个跨度可能出现在多个代理中
+ 节流数：因超出允许的 TPS（每秒事务数）而受服务节流的请求数量
+ 入站身份验证授权和访问令牌调用 – 代理处理的入站认证请求数量，含外部客户端或服务发起的授权校验及访问令牌验证请求
+ 出站身份验证使用分布 – 代理发起出站认证时采用的身份验证方式分布情况，展示代理访问外部服务时所使用各类身份验证机制的调用频次及类型

**运行时指标**控制面板包含 AgentCore Runtime 自动生成的指标：
+ 运行时会话及调用数：统计该代理在 Runtime 托管期间生成的会话及调用总量
+ 运行时延迟：托管在 Runtime 上的代理发出的请求延迟
+ 运行时节流数：因超出允许的 TPS（每秒事务数）而受服务节流的请求数量