查看代理跟踪记录

准备工作

如需查看智能体跟踪记录，您必须满足以下要求：

  • 启用 API：确保为您的 Google Cloud 项目启用以下 API：
    • Cloud Trace API
    • Cloud Logging API
    • Telemetry API
  • 配置智能体跟踪：您的智能体必须配置为将跟踪 数据发送到 Google Cloud。如需了解如何为 不同智能体类型启用跟踪，请参阅 设置跟踪。
  • 配置权限：如需查看跟踪记录和日志，您需要 提供所需权限的 IAM 角色，例如 Cloud Trace User (roles/cloudtrace.user) 和 Logs Viewer (roles/logging.viewer) 角色。如需了解详情，请参阅 Cloud Trace 访问权限控制和 Cloud Logging 访问权限控制。

分布式跟踪是一种诊断技术，用于跟踪单个请求在架构中的各种分布式服务和组件之间传递的过程。由于生成式 AI 智能体采用非确定性推理循环来动态选择工具和执行路径，因此传统的时间点指标通常不足以进行调试。跟踪记录对于智能体可观测性至关重要，因为它们提供了这些不可预测的交互的完整顺序时间轴，让您能够准确了解智能体做出特定决策的原因。

探索跟踪记录

如需访问智能体的详细执行数据，请执行以下操作：

  1. 在 Google Cloud 控制台中，前往 Agent Platform > Agent Registry 页面。

    前往 Agent Registry

  2. 选择您的特定智能体。

  3. 点击跟踪记录 标签页。

借助此界面，您可以检查智能体的分步执行详情。跟踪记录 是智能体行为的真实且不可变记录，包括模型输入、响应和工具调用。跟踪记录视图包含其 span、输入和输出以及元数据属性的有向无环图 (DAG)。

“跟踪记录”标签页提供了三种不同的视图来探索遥测数据：

  • 会话视图： 按各个用户会话对执行进行分组，让您能够分析多轮对话和智能体随时间变化的行为。
  • 跟踪记录视图： 侧重于单个端到端请求跟踪记录，表示单个执行路径。
  • Span 视图： 提供在跟踪记录中执行的各个操作（span）的精细列表，例如特定基础模型调用、API 请求或外部工具执行。

单个跟踪记录视图（会话上下文）

当您从会话视图中选择特定会话时，系统会打开“详细信息”窗格 ，左侧的列表面板会显示该多轮会话中包含的所有单个跟踪记录 。主面板会汇总整个会话的上下文，显示格式化的输入和助理消息，以及整体会话指标，例如时长、GenAI 令牌总数和持续评估得分。

单个跟踪记录视图（直接跟踪记录或 span 上下文）

或者，如果您从跟踪记录视图 中选择特定跟踪记录，或从 Span 视图中选择不同的 span，则“详细信息”窗格会直接打开该 特定执行。由于您查看的是单个操作，而不是分组的会话，因此左侧的列表面板会被隐藏，以便立即专注于检查该操作的特定延迟时间、属性和潜在错误。

数据存储和访问权限控制

为了确保安全性和合规性，Gemini Enterprise Agent Platform 将运营元数据与实际对话内容分开：

  • 执行指标和属性： 标准遥测数据（例如延迟时间、状态代码和结构化元数据）直接存储在跟踪记录 span 中。
  • 提示和响应： 潜在的敏感数据（例如用户提示和模型响应）不会存储在 span 中。相反，它们会根据您组织的配置路由到 Cloud Logging 或 Cloud Storage。这样，管理员就可以对敏感的对话数据实施精细的 Identity and Access Management (IAM) 控制。

Gemini Enterprise Agent Platform 界面会自动了解跟踪记录 span 与这些安全存储的提示和响应日志之间的底层关联。当您打开跟踪记录详细信息视图时，该平台会无缝地将这些数据重新组合在一起，呈现智能体行为的统一视图，而不会影响您的数据治理规则。

如需详细了解如何为对话数据配置存储目标， 请参阅收集和查看多模态提示和回答。

后续步骤