本指南向您展示如何在 LangSmith 中追踪 Google Agent Development Kit (ADK) 智能体。您将为您的 ADK 应用程序配置自动追踪,以捕获智能体调用、工具调用和 LLM 交互。
本指南涵盖 ADK 的标准执行路径(文本智能体、工具和多智能体工作流)。要追踪使用 ADK 的 Runner.run_live 流式循环的 Gemini Live 语音智能体,请参阅追踪 Gemini Live 应用程序。

安装

使用您偏好的包管理器安装所需的软件包:

设置

设置您的 API 密钥:
要创建 Google API 密钥,请参考 Google AI Studio。

配置追踪

要追踪 ADK 智能体,请使用 LangSmith SDK 中的 configure_google_adk()。在创建任何 ADK 智能体之前,在您的应用程序启动时调用一次此函数:
该函数接受以下可选参数:
  • project_name:用于发送追踪数据的 LangSmith 项目。默认使用 LANGSMITH_PROJECT 环境变量。
  • name:根追踪的名称。默认为 "google_adk.session"。
  • metadata:用于提供额外上下文的键值对字典。
  • tags:用于分类追踪的字符串列表。

示例

此示例创建了一个带有工具的天气智能体,然后在启用追踪的情况下运行它:

在 LangSmith 中查看追踪

运行您的应用程序后,您可以在 LangSmith UI 中查看追踪,这些追踪包括:
  • 智能体调用:通过您的 ADK 智能体的完整流程
  • 工具调用:智能体进行的单个函数调用
  • LLM 交互:来自 Gemini 模型的请求和响应
  • 多智能体工作流:来自顺序和并行智能体组合的追踪

自定义元数据和标签

在配置追踪时添加元数据和标签,以便对追踪进行分类和过滤:

多智能体工作流

该集成会自动追踪多智能体工作流,包括顺序和并行智能体组合: