Skip to main content
トレースすることができます Google Agent Development Kit (ADK) エージェントとツールの呼び出しをWeaveで OpenTelemetry (OTEL)を使用して。ADKは、AIエージェントを開発・デプロイするための柔軟でモジュール式のフレームワークです。GeminiとGoogleエコシステムに最適化されていますが、ADKはモデルに依存せず、デプロイにも依存しません。単純なタスクから複雑なワークフローまで、エージェントアーキテクチャの作成、デプロイ、オーケストレーションのためのツールを提供します。 このガイドでは、OTELを使用してADKエージェントとツールの呼び出しをトレースし、それらのトレースをWeaveで可視化する方法を説明します。必要な依存関係のインストール方法、OTELトレーサーをWeaveにデータを送信するように構成する方法、およびADKエージェントとツールを計測する方法について学びます。
WeaveでのOTELトレースの詳細については、Send OTEL Traces to Weaveをご覧ください。

前提条件

  1. 必要な依存関係をインストールします:
  2. あなたのGoogle API keyを環境変数として設定します:
  3. WeaveでOTELトレースを構成する

WeaveでOTELトレースを構成する

ADKからWeaveにトレースを送信するには、OTELをTracerProviderOTLPSpanExporterで構成します。エクスポーターを認証とプロジェクト識別のための正しいエンドポイントとHTTPヘッダーに設定します。
APIキーやプロジェクト情報などの機密性の高い環境変数は、環境ファイル(例:.env)に保存し、os.environを使用してロードすることをお勧めします。これにより、認証情報を安全に保ち、コードベースから分離できます。

必要な構成

  • Endpoint: https://trace.wandb.ai/otel/v1/traces
  • Headers:
    • Authorization:W&B APIキーを使用した基本認証
    • project_id:あなたのW&Bエンティティ/プロジェクト名(例:myteam/myproject

ADKからWeaveにOTELトレースを送信する

以下のコードスニペットは、OTLPスパンエクスポーターとトレーサープロバイダーを構成して、ADKアプリケーションからWeaveにOTELトレースを送信する方法を示しています。
WeaveがADKを適切にトレースするようにするには、グローバルトレーサープロバイダーを前にコード内でADKコンポーネントを使用するように設定します。

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

トレーサープロバイダーを設定した後、自動トレースを使用してADKエージェントを作成して実行できます。次の例は、ツールを持つ単純なLLMエージェントを作成し、インメモリランナーで実行する方法を示しています:
すべてのエージェント操作は自動的にトレースされ、Weaveに送信されるため、実行フローを視覚化できます。モデル呼び出し、推論ステップ、ツールの呼び出しを表示できます。 A trace visualization of an ADK agent

OTELでADKツールをトレースする

ADKでツールを定義して使用すると、これらのツール呼び出しもトレースに記録されます。OTEL統合は、エージェントの推論プロセスと個々のツール実行の両方を自動的に計測し、エージェントの動作の包括的なビューを提供します。 複数のツールを使用した例を以下に示します:
A trace visualization of ADK tool calls

ワークフローエージェントの操作

ADKはさまざまなworkflow agentsをより複雑なシナリオ向けに提供しています。ワークフローエージェントは通常のLLMエージェントと同様にトレースできます。以下はSequentialAgentを使用した例です:
このワークフローエージェントトレースは、両方のエージェントの順次実行をWeaveに表示し、マルチエージェントシステムを通じてデータがどのように流れるかの可視性を提供します。 A trace visualization of a Sequential workflow agent

詳細情報