准备工作
您必须满足以下要求，然后才能查看代理轨迹：
- 启用 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 代理采用非确定性推理循环来动态选择工具和执行路径，因此传统的时间点指标通常不足以用于调试。轨迹对于代理可观测性至关重要，因为它们提供了这些不可预测的交互的完整、按时间顺序排列的时间线，让您可以准确了解代理做出特定决策的原因。
探索轨迹
如需访问代理的详细执行数据，请执行以下操作：
在 Google Cloud 控制台中，前往 Agent Platform > Agent Registry 页面。
选择您的特定代理。
点击跟踪记录标签页。
借助此界面，您可以检查代理的逐步执行详情。轨迹是代理行为的真实且不可变的记录，包括模型输入、响应和工具调用。轨迹视图包含其 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 与这些安全存储的提示和响应日志之间的潜在关联。当您打开轨迹详情视图时，平台会无缝地将这些数据重新组合在一起，从而呈现代理行为的统一视图，而不会影响您的数据治理规则。
如需详细了解如何为对话数据配置存储目的地，请参阅收集和查看多模态提示和回答。