認証
- Path:
/agents/otel/v1/traces - Method:
POST - Content-Type:
application/x-protobuf - Base URL: Multi-tenant Cloud の場合は
https://trace.wandb.ai
opentelemetry-exporter-otlp-proto-http (Python) や @opentelemetry/exporter-trace-otlp-proto (TypeScript) などの protobuf HTTP exporter を使用してください。また、このエンドポイントはコンテンツエンコーディングとして gzip と deflate も受け付けます。
エンドポイントで認証するには、次のいずれかの値を使用して、OTLPSpanExporter の設定に W&B APIキー を指定します。
wandb-api-key: 値に W&B APIキーを指定します。Authorization: ユーザー名にapi、パスワードに W&B APIキーを使用する HTTP Basic 認証です。この形式は、exporter または collector が標準の Authorization ヘッダーしかサポートしていない場合に便利です。
project のルーティング
- リソース属性 (推奨) :
TracerProviderのリソースで、wandb.entityにご利用の W&B チーム名またはユーザー名を、wandb.projectにプロジェクト名を設定します。 project_idヘッダー: 値に[YOUR-TEAM]/[YOUR-PROJECT]を設定します。
Agents ビュー向けにスパンを整形する
gen_ai.operation.name を設定します。
グループ化を制御する属性が、ほかに 2 つあります。
gen_ai.conversation.id: ターンを 1 つの会話にグループ化します。会話の存続期間を通じて安定した ID を使用してください。gen_ai.agent.name: Agents タブで、会話を名前付きエージェントの下にグループ化します。
gen_ai.request.model、gen_ai.usage.input_tokens、gen_ai.usage.output_tokens など、ほかの GenAI semantic-convention 属性を指定すると、モデル名やトークン数が表示に追加されますが、これらは省略可能です。これらのスパンがマッピングされるエージェントのデータモデルについては、Trace your agents を参照してください。
環境変数のみで設定する
例: Weave SDK を使わずにエージェント スパンを送信する
invoke_agent スパン、LLM Call に対して chat スパン、ツール呼び出し に対して execute_tool スパンを送信し、その後それらを Weave Agents エンドポイントにエクスポートします。
まず、必要な依存関係をインストールします。
WANDB_API_KEY、ENTITY、PROJECT の値を設定してから実行します。
gen_ai.conversation.id を持つ invoke_agent スパンを追加で生成します。各ターンはそれぞれ独立したトレースのルートスパンであるため、ターン間で親スパンを共有する必要はありません。
アプリケーションがスパンをエクスポートしたら、Weave projectの Agents タブを開きます。