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コーディングエージェントに貼り付けます。エージェントはガイドを取得し、ジョブを構築し、ドライ実行から始めます。
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のない会話をスキップし、その数をカウントします。
引き継がれるもの
| データ | 引き継ぎの有無 |
|---|---|
| セッションのグループ化 | はい、メタデータ内の会話IDから引き継ぎます |
| モデル | はい |
| トークン | はい |
| コスト | いいえ。Braintrustログにはコストではなくトークンが記録されており、Amplitudeはコストを見積もりません。 |
| ツール呼び出し | はい |
| Braintrustスコア | いいえ、ジョブでそれらをスコア(Scores)にマップしない限り、適用されません。 |
| 実験 | はい、ルートスパンのmetadataがバリアントを記録する場合。どのキーがそれを保持しているかをコーディングエージェントに伝えます。 |
データの最新性と制限
- 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.