前提条件
Weave で OTEL トレースを設定する
TracerProvider と OTLPSpanExporter を使用して OTEL を設定します。エクスポーターには、認証とプロジェクト識別に必要な正しいエンドポイントと HTTP ヘッダーを設定してください。
APIキーやプロジェクト情報などの機密性の高い環境変数は、環境ファイル (たとえば .env) に保存し、os.environ を使って読み込んでください。こうすることで、認証情報を安全に保ち、コードベースに含めずに済みます。
必須設定
- エンドポイント:
https://trace.wandb.ai/otel/v1/traces - ヘッダー:
Authorization: W&B APIキーを使用するBasic認証。project_id: W&B の entity とプロジェクト名 (例:myteam/myproject)。
設定例
tracer_provider を利用できます。
OTEL で PydanticAI エージェントをトレースする
InstrumentationSettings オブジェクトを Agent コンストラクタに渡します。これにより、すべてのエージェントとツールの call が、OTEL の設定に従ってトレースされます。
次の例では、トレースを有効にした基本的なエージェントを作成する方法を示します。重要な step は、エージェントの初期化時に instrument 引数を設定することです。

OTEL で PydanticAI のツールをトレースする
@agent.tool_plain でデコレートされた関数) を呼び出すと、ツールの inputs、outputs、そしてモデルの推論を含むやり取り全体が Weave でキャプチャされ、可視化されます。
次の例では、system prompt とツールを備えた エージェント を作成する方法を示します。トレースは エージェント とツールの両方で自動的に有効になります。

デフォルトですべてのエージェントにインストルメンテーションを適用する
Agent.instrument_all() method を使用します。これにより、instrument パラメーターを明示的に指定していないエージェントに対して、デフォルトの InstrumentationSettings インスタンスが設定されます。