Skip to main content
L’Agent Development Kit (ADK) de Google est un framework flexible et indépendant du modèle, conçu pour créer et orchestrer des agents. Bien qu’optimisé pour Gemini, ADK prend en charge n’importe quel modèle, aussi bien pour des tâches simples que pour des flux de travail multi-agents complexes. CoreWeave Agent Lens trace automatiquement les agents créés avec ADK, notamment chaque appel d’agent, chaque transfert vers un sous-agent, chaque appel de modèle et chaque appel d’outil. Agent Lens affiche les données capturées dans l’onglet Conversations de votre projet.
This integration uses the Weights & Biases Weave SDK (weave), because the CoreWeave Forge SDK doesn’t support this framework yet. Traces you send with Weave appear in Agent Lens, because both products share the same trace data.

Tracer des agents Google ADK avec Agent Lens

Le SDK Weave patche automatiquement Google ADK pour Python, ce qui vous permet de capturer les traces de vos agents ADK avec une configuration minimale. Ce guide explique comment initialiser Weave, puis exécuter un agent de recherche créé avec Google ADK et fonctionnant sur plusieurs tours de conversation, afin qu’Agent Lens capture chaque appel d’agent, chaque appel de modèle et chaque appel d’outil tout au long de la session.

Prérequis

  • Un compte CoreWeave Forge et une clé API définie dans la variable d’environnement WANDB_API_KEY.
  • Une clé API Google pour Gemini.
  • Python 3.10 ou version ultérieure.

Installer les paquets

Installez les paquets suivants dans votre environnement de développement. Ils fournissent le SDK Weave, le framework Google ADK et le client HTTP utilisé par l’outil de l’exemple.

Initialiser Agent Lens dans votre code

Ajoutez weave.init au projet en indiquant les noms de votre équipe et de votre projet Forge, puis créez un agent comme vous le feriez habituellement. Le code suivant crée un agent research_assistant qui utilise gemini-3.6-flash et un outil wikipedia_search, puis lui soumet trois questions au cours d’une même session ADK, pendant qu’Agent Lens capture la trace.
L’exemple exécute trois tours de conversation dans une seule session ADK. Les deux premiers tours déclenchent des recherches sur Wikipédia, et le troisième s’appuie sur le contexte de la conversation précédente pour produire une synthèse sans appel d’outil.Chaque tour transmet le même session_id. ADK définit gen_ai.conversation.id à partir de cette session, si bien qu’Agent Lens affiche les trois tours comme une seule conversation dans l’onglet Conversations. Si vous créez plutôt une session par tour, chaque tour apparaît comme une conversation distincte.

View your traces in Agent Lens

After the script runs, weave.init() prints a link to your project in Weave. The same traces appear in Agent Lens, because both products share the same trace data. To view them in Agent Lens:
  1. Navigate to CoreWeave Forge and select Agent Lens from the product menu.
  2. Select your project.
  3. In the Agent Lens side menu, select Conversations, and then select your conversation.
Each turn renders as an invoke_agent span with nested chat and execute_tool spans. Each span shows its input, model, output, token usage, and tool results. For more information, see View agent activity.
Dernière modification le 30 septembre 2026