Skip to main content
Google の Agent Development Kit (ADK) は、エージェントの構築とオーケストレーションに使用する、柔軟でモデルに依存しないフレームワークです。Gemini 向けに最適化されていますが、ADK はあらゆるモデルをサポートし、単純なタスクから複雑なマルチエージェントのワークフローまで対応します。Weave は、ADK で構築されたエージェントを自動的にトレースし、各エージェントの invocation、サブエージェントへの引き継ぎ、モデルの Call、ツール呼び出しを記録します。Weave は、取得したデータを project の Agents ビューに表示します。

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

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

前提条件

  • CoreWeave Forge アカウントと、WANDB_API_KEY 環境変数に設定した APIキー。
  • Gemini 用の Google APIキー。
  • Python 3.10 以降。

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

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

コード内で Weave を初期化する

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

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

スクリプトを実行すると、weave.init() によって project へのリンクが出力されます。Agents ビューを開くと、次の内容を確認できます。
  • 会話のターンを含むセッション
  • invoke_agent スパンとしてレンダリングされた各ターン (子として chat と execute_tool がネストされます)
  • 各ステップの入力、モデル、出力、トークン使用量、ツール結果の全容
Weave で Agents データを表示する方法の詳細については、エージェントのアクティビティを表示するを参照してください。
最終更新日 2026年9月30日