Weave で Google ADK エージェントをトレースする
- Python
- TypeScript
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 を初期化する
- Python
- TypeScript
CoreWeave Forge のチーム名とプロジェクト名を指定して この例では、単一の ADK セッションで 3 つのターンを実行します。最初の 2 つのターンでは Wikipedia のルックアップが実行され、3 つ目では前の会話のコンテキストを使用して、ツール呼び出しなしで要約を生成します。
weave.init を project に追加し、通常どおりエージェントを構築します。次のコードでは、gemini-2.5-flash と wikipedia_search ツールを使用する research_assistant エージェントを作成し、単一の ADK セッションで 3 つの質問を実行します。その間、Weave がトレースを取得します。Agents ビューでエージェントのトレースを確認する
スクリプトを実行すると、weave.init() によって project へのリンクが出力されます。Agents ビューを開くと、次の内容を確認できます。
- 会話のターンを含むセッション
invoke_agentスパンとしてレンダリングされた各ターン (子としてchatとexecute_toolがネストされます)- 各ステップの入力、モデル、出力、トークン使用量、ツール結果の全容