使用 Google ADK构建的观察器

确保满足下列先决条件：

• Python 3.8 已安装该版本或更高版本。

• 用于访问Gemini模型的 Google API 密钥，请参阅 Google AI Studio。

• Instana 已根据您的应用程序进行配置，请参阅 “入门指南 ”。

要为您的 Google ADK应用程序配置 Instana 可观测性，请完成以下步骤：

1. 安装 Google ADK所需的软件包：

   pip install google-adk traceloop-sdk

2. 创建一个新的 Google ADK 代理项目：

   adk create test_agent

   这将创建一个具有以下结构的项目，其中 agent.py 包含代理的核心控制逻辑：

   

3. 在 .env 文件中设置您的 Google API 密钥：

   GOOGLE_API_KEY=<your-google-api-key>

   要创建或管理您的 API 密钥，请访问 Google AI Studio。

4. 使用以下代码更新该 agent.py 文件，以创建一个采用 OpenLLMetry 监控功能的多代理应用程序：

   from google.adk.agents.llm_agent import Agent
   from traceloop.sdk import Traceloop
   
   # Initialize OpenLLMetry with app name
   Traceloop.init(app_name="multi_agent_adk_app")
   
   # Tool implementations
   def get_current_time(city: str) -> dict:
       """Returns the current time for a given city."""
       return {"city": city, "time": "10:30 AM"}
   
   def get_weather(city: str) -> dict:
       """Returns the current weather for a given city."""
       return {"city": city, "weather": "Sunny", "temperature": "30°C"}
   
   
   # Time Agent
   time_agent = Agent(
       name="time_agent",
       model="gemini-2.0-flash-exp",
       description="Provides the current time for a city.",
       instruction=(
           "You provide the current time for a given city. "
           "Use the get_current_time tool to fetch the information."
       ),
       tools=[get_current_time],
   )
   
   # Weather Agent
   weather_agent = Agent(
       name="weather_agent",
       model="gemini-2.0-flash-exp",
       description="Provides the current weather for a city.",
       instruction=(
           "You provide the current weather details for a given city. "
           "Use the get_weather tool to fetch the information."
       ),
       tools=[get_weather],
   )
   
   # Root Agent orchestrating other agents
   root_agent = Agent(
       name="root_agent",
       model="gemini-2.0-flash-exp",
       description="Orchestrates multiple agents to answer user queries.",
       instruction=(
           "You are a coordinating agent. Based on the user request, "
           "delegate tasks to the appropriate agent (time_agent or weather_agent) "
           "and combine the responses into a single answer."
       ),
       sub_agents=[time_agent, weather_agent],
   )

   此示例创建了三个代理：

   • time_agent ：提供各城市的当前时间

   • weather_agent ：提供各城市的天气信息

   • root_agent ：协调其他代理处理用户请求

5. 启动 Google ADK代理：

   adk run test_agent

   该代理将启动并等待用户输入。 你可以通过提问来与它互动，例如：“纽约的天气怎么样？” 或者“伦敦现在几点了？”

6. 在 Instana 中查看数据。

   运行应用程序并与代理进行交互后，数据将显示在 Instana 的Gen AI可观测性仪表盘中：

   

   

   仪表盘显示：

   • 代理协调流程

   • 工具调用（get_current_time、get_weather）

   • LLM 与 Gemini 模型的交互

   • 响应时间和令牌使用情况

对于“轨迹未显示”或“连接错误”等常见问题，请参阅 “故障排除 ”。

• 探索 Instana 支持的其他AI代理框架

• 了解您的 LLM 使用费用的计算方式

• 为您的 Google ADK 工作流设置提醒