前提条件
-
必要な依存関係をインストールします。
-
OpenAI APIキー (または他のモデルプロバイダーのキー) を環境変数に設定します。
- 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 トレースを送信する方法を示します。OTEL で Agno エージェントをトレースする
トレーサープロバイダーを設定すると、自動トレースを有効にした状態で Agno エージェントを作成して実行できます。以降のエージェントのアクティビティを Weave ですべて取得できるように、エージェントを作成する前に Agno をインストルメントしてください。次の例では、ツールを使用するエージェントを作成する方法を示します。
OTEL を使用して Agno のツールをトレースする
Agno でツールを定義して使用すると、それらのツール呼び出しもトレースに取得されます。OTEL インテグレーションはエージェントの推論プロセスと個々のツール実行の両方を自動的にインストルメントするため、エージェントの動作を包括的に把握できます。 以下は、複数のツールを使用する例です。
OTEL でマルチエージェントのチームをトレースする
Agno のマルチエージェントアーキテクチャを使うと、互いに連携しながらコンテキストを共有するエージェントのチームを作成できます。Weave は、こうしたチーム内のやり取りもすべてトレースします。
推論エージェントを使用する
Agno には推論機能が組み込まれており、エージェントは問題を段階的に処理できます。こうした推論プロセスもトレースで取得されます。
メモリとナレッジを扱う
Agno のエージェントはメモリを保持し、ナレッジベースにアクセスできるため、複数のやり取りにわたってコンテキストを維持できます。これらの操作も Weave でトレースされます。