Skip to main content
OpenTelemetry (OTEL) を使用すると、Agno のエージェントとツール呼び出しを Weave でトレースできます。Agno は、共有メモリ、ナレッジ、推論を備えたマルチエージェントシステムを構築するための Python フレームワークです。軽量でモデルに依存しない設計となっており、テキスト、画像、オーディオ、動画の処理を含むマルチモーダル機能をサポートしています。 このガイドでは、OTEL を使用して Agno のエージェントとツール呼び出しをトレースし、そのトレースを Weave で可視化する方法を説明します。必要な依存関係のインストール方法、Weave にデータを送信する OTEL トレーサーの設定方法、Agno のエージェントとツールをインストルメントする方法を紹介します。
Weave での OTEL トレースの詳細については、Send OTEL Traces to Weave を参照してください。

前提条件

  1. 必要な依存関係をインストールします。
  2. OpenAI APIキー (または他のモデルプロバイダーのキー) を環境変数に設定します。
  3. Weave で OTEL トレースを設定します。

Weave で OTEL トレースを設定する

Agno から Weave にトレースを送信するには、TracerProvider と OTLPSpanExporter を使用して OTEL を設定します。エクスポーターには、正しいエンドポイントと、認証および project の識別に必要な HTTP ヘッダーを設定してください。
APIキーや project 情報などの機密性の高い環境変数は、環境ファイル (例: .env) に保存し、os.environ を使用して読み込んでください。これにより、認証情報を安全に管理し、コードベースに含めずに済みます。

必須の設定

次のエンドポイントとヘッダーで OTLP エクスポーターを設定します。
  • エンドポイント: https://trace.wandb.ai/otel/v1/traces
  • ヘッダー:
    • Authorization: W&B APIキーを使用した Basic 認証。
    • project_id: W&B の entity/プロジェクト名 (例: myteam/myproject) 。

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

前提条件を満たすと、Agno から Weave に OTEL トレースを送信できます。次のコードスニペットでは、OTLP スパンエクスポーターとトレーサープロバイダーを設定し、Agno アプリケーションから Weave に OTEL トレースを送信する方法を示します。
Weave で Agno を正しくトレースするには、コード内で Agno のコンポーネントを使用する前に、グローバルトレーサープロバイダーを設定してください。

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

トレーサープロバイダーを設定すると、自動トレースを有効にした状態で Agno エージェントを作成して実行できます。以降のエージェントのアクティビティを Weave ですべて取得できるように、エージェントを作成する前に Agno をインストルメントしてください。次の例では、ツールを使用するエージェントを作成する方法を示します。
Weave はエージェントのすべての操作を自動的にトレースするため、実行フロー、モデルの Call、推論ステップ、ツール invocation を可視化できます。
Agno エージェントのトレースを可視化した画面

OTEL を使用して Agno のツールをトレースする

Agno でツールを定義して使用すると、それらのツール呼び出しもトレースに取得されます。OTEL インテグレーションはエージェントの推論プロセスと個々のツール実行の両方を自動的にインストルメントするため、エージェントの動作を包括的に把握できます。 以下は、複数のツールを使用する例です。
Agno のツール呼び出しのトレース可視化

OTEL でマルチエージェントのチームをトレースする

Agno のマルチエージェントアーキテクチャを使うと、互いに連携しながらコンテキストを共有するエージェントのチームを作成できます。Weave は、こうしたチーム内のやり取りもすべてトレースします。
このマルチエージェントのトレースは、Weave 上での各エージェント間の連携を示しています。これにより、エージェントチーム内でタスクがどのように分配され、実行されているかを可視化できます。
Agno のマルチエージェントチームのトレースの可視化

推論エージェントを使用する

Agno には推論機能が組み込まれており、エージェントは問題を段階的に処理できます。こうした推論プロセスもトレースで取得されます。
トレースには推論ステップが表示され、エージェントが複雑な問題をどのように分解し、どのように意思決定を行うかを確認できます。
Agno の推論エージェントのトレース可視化

メモリとナレッジを扱う

Agno のエージェントはメモリを保持し、ナレッジベースにアクセスできるため、複数のやり取りにわたってコンテキストを維持できます。これらの操作も Weave でトレースされます。
Agno のメモリ使用量を示すトレースの可視化
会話履歴の保存や取得などのメモリ操作は、トレースに表示されます。

詳細情報

最終更新日 2026年9月30日