メインコンテンツへスキップ
Google の Agent Development Kit (ADK) は、エージェントの構築とオーケストレーションのための、柔軟でモデル非依存のフレームワークです。Gemini 向けに最適化されていますが、ADK はあらゆるモデルをサポートしており、シンプルなタスクから複雑なマルチエージェント ワークフローまで対応します。Weave は、ADK で構築されたエージェントを自動的にトレースし、各エージェント呼び出し、サブエージェントへのハンドオフ、モデルの Call、ツール呼び出しを含むデータを取得します。Weave は、取得したデータを project の Agents ビューに表示します。

Weave で Google ADK エージェントをトレースする

Weave SDK は Google ADK for Python を自動的にパッチするため、最小限の設定で ADK エージェントのトレースを取得できます。このガイドでは、Weave を初期化したうえで、Google ADK で構築したマルチターンのリサーチエージェントを実行し、セッション全体にわたるすべてのエージェント呼び出し、モデルの Call、ツール呼び出しを Weave で取得する方法を説明します。

前提条件

  • WANDB_API_KEY 環境変数として設定された W&B アカウントと APIキー
  • Gemini 用の Google APIキー
  • Python 3.10+。

パッケージをインストールする

開発用の環境に、次のパッケージをインストールします。これらのパッケージに、Weave SDK、Google ADK フレームワーク、およびサンプルツールで使用する HTTP クライアントが含まれます。

コードで Weave を初期化する

weave.init をprojectに追加し、W&B のチーム名とproject名を指定してから、通常どおりエージェントを構築します。次のコードでは、gemini-2.5-flashwikipedia_search ツールを使用する research_assistant エージェントを作成し、Weave でトレースを取得しながら、1 つの ADK セッション内で 3 つの質問を実行します。
この例では、1 つの ADK セッション内で 3 つのターンを実行します。最初の 2 つのターンでは Wikipedia のルックアップがトリガーされ、3 つ目のターンではそれまでの会話コンテキストを使用して、ツール呼び出しなしで要約を生成します。

Agents ビューでエージェントのトレースを確認する

スクリプトの実行後、weave.init() によって project へのリンクが出力されます。Agents ビューを開くと、次の内容を確認できます。
  • 会話のターンを含むセッション。
  • 各ターンは invoke_agent span として表示され、その子要素として chatexecute_tool がネストされています。
  • 各ステップでの入力全体、モデル、出力、トークン使用量、ツールの実行結果。
Weave で Agents データを表示する方法の詳細については、エージェントのアクティビティを表示するを参照してください。