Skip to main content
本指南将向您展示如何在 LangSmith 中追踪 Google Agent Development Kit (ADK) 代理。您将为 ADK 应用配置自动追踪,以捕获代理调用、工具调用和 LLM 交互。

安装

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

设置

设置您的 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 模型的请求和响应
  • 多代理工作流:来自顺序和并行代理组合的追踪

自定义元数据和标签

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

多代理工作流

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