Braintrustの会話をエージェント分析にインポートする

Braintrust連携により、Braintrustがすでにエージェント分析に記録しているエージェントの会話(過去の会話を含む)が転送されます。インフラストラクチャ内のスケジュール済みジョブによって、Braintrustプロジェクトログに対してSQLが実行され、やり取りが途絶えた会話を見つけ出し、それらを[Agent]イベントにマップし、Amplitude HTTP APIに送信します。Amplitudeは次に、セッション、ターン、ツール呼び出しを構築し、組み込みのシグナルを実行します。

アプリがすでにOpenTelemetryを出力している場合は、このジョブを実行するのではなく、Amplitudeを2番目のOTLPエクスポータとして追加できます。OpenTelemetryトレースをエージェント分析に送信するを参照してください。大量の場合は、BraintrustはSQLを使用したポーリングよりも、S3エクスポートを推奨します。 このジョブは、中程度のボリュームとバックフィルに適しています。

AIコーディングエージェントを使用した設定(推奨)

このプロンプトを、Cursor、Claude Code、Windsurf、GitHub Copilot、CodexなどのAIコーディングエージェントに貼り付けます。エージェントはガイドを取得し、ジョブを構築し、ドライ実行から始めます。

text
Connect our Braintrust project logs to Amplitude Agent Analytics.
Fetch https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/braintrust.md
If @amplitude/ai is installed, the same file is under node_modules/@amplitude/ai/docs/integrations/.
Follow links in the guide. If your source isn't listed, start at https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/README.md
Follow "Part 2: Coding agent procedure". Start with a dry run.

エージェントは停止し、推測できない値(ユーザーIDがどのフィールドに保持されているかなど)を尋ねます。 変更を確認し、今すぐ始めるの手順に従って検証します。

これが意味すること

  • 実行内容:TypeScriptジョブをスケジュールに従って実行します(例:1時間ごと)。実行の間にウォーターマークを保存します。
  • 必要なものは、Braintrust APIキー、プロジェクトID、AmplitudeプロジェクトのAPIキーです。 BraintrustのEU地域については、EU API URLを設定します。
  • Braintrustには組み込みの会話IDがないため、アプリはspanメタデータ内の会話IDとユーザーIDを記録する必要があります。 会話IDキーにサブフィールドインデックスを追加します。そうしないと、ジョブのクエリがタイムアウトします。 このジョブは、これらのIDのない会話をスキップし、その数をカウントします。

引き継がれるもの

データの最新性と制限

  • Settle time: このジョブは、新しいアクティビティなしで2時間経過した後、会話を終了したとみなします。
  • 更新の遅延: 各実行では、過去7日間に更新された会話も取得します(1回の実行につき最大500件)。
  • レート制限:Braintrustでは、スタータープランとプロプランの場合、組織ごとに1分あたり約20件のクエリを実行できます。ジョブはリクエストの合間に待機し、429の場合には再試行します。
  • リテンション:SQLクエリには、デフォルトでスターターでは14日間のログ、Proでは30日間のログが表示されるため、バックフィルはそれまでの期間にしか及びません。
  • 再送信:セッションの[Agent] Session Endの後に送信されたイベントには、新しい組み込みシグナルの結果は作られません。Amplitudeは、再送されたイベントを7日間の期間内に重複排除します。

今すぐ始める

Braintrust連携ガイドに従ってください。 まずはドライ実行で開始し、最初の実際の実行後にライブイベントとセッションビューアをチェックします。次に、同じウィンドウを再実行して、重複がないことを確認します。

ガイドの最終確認日は2026年10月6日です。 Braintrustは、その所有者の商標です。 AmplitudeはBraintrustと提携しておらず、Braintrustによって承認されていません。

これは役に立ちましたか?

For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

このページでは