Langfuseの会話をエージェント分析にインポートする
Langfuse連携では、Langfuseがすでに追跡しているエージェントの会話(過去の会話を含む)が、エージェント分析に転送されます。インフラストラクチャ内のスケジュール済みジョブが、確定済みのLangfuseセッションをobservations APIから取得し、それを[Agent]イベントにマップしてAmplitude HTTP APIに送信します。次にAmplitudeは、セッション、ターン、ツール呼び出しを構築し、組み込みのシグナルを実行します。
アプリがすでにOpenTelemetryを出力している場合は、このジョブを実行するのではなく、AmplitudeをLangfuseと一緒に2番目のOTLPエクスポータとして追加できます。OpenTelemetryトレースをエージェント分析に送信するを参照してください。この連携を使用して、履歴など、Langfuseにあるすでに存在するものを転送できます。
AIコーディングエージェントを使用した設定(推奨)
このプロンプトを、Cursor、Claude Code、Windsurf、GitHub Copilot、CodexなどのAIコーディングエージェントに貼り付けてください。エージェントはガイドを取得し、ジョブを構築して、ドライランから開始します。
Connect our Langfuse sessions to Amplitude Agent Analytics.
Fetch https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/langfuse.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がどのフィールドに保持されているかなど)を尋ねます。 その変更を確認し、「開始(Get started)」の手順に従って検証してください。
必要な対応
- 実行:スケジュールに従ったTypeScriptジョブ(例:1時間ごと)。実行の間にウォーターマークを保存します。
- 必要なものは、Langfuseの公開キーとシークレットキー、Langfuseホスト(EU、US、Japan、HIPAA、またはセルフホスト型)、AmplitudeプロジェクトのAPIキーです。 セルフホスト型のLangfuse v3にはv2 observations APIがないため、v4にアップグレードしてください。
- アプリで設定する必要のあるもの:そのトレース上の
sessionIdおよびuserId。このジョブは、それらがないセッションをスキップし、カウントします。
引き継がれる内容
| データ | 引き継ぎの有無 |
|---|---|
| セッションのグループ化 | はい、1つのLangfuseセッションが1つのセッションになります |
| モデル | はい |
| トークン | はい |
| コスト | はい、Langfuseのコスト値。Amplitudeはそれを再計算しません。 |
| ツール呼び出し | はい |
| Langfuseのスコア | いいえ、ジョブでそれらをScoresにマップしない限り、 |
| 実験 | はい、トレースがmetadataバリアントを記録する場合です。どのキーがそれを保持しているかをコーディングエージェントに伝えます。 |
Langfuseがマスクしたコンテンツはマスクされたままです。
鮮度と制限
- 確定までの時間:ジョブは、新しいトレースが2時間ない場合、そのセッションを完了したものとして扱います。一部のLangfuse SDKとOTLP取り込みでは、トレースが最大15分遅れて送信されるため、これを20分未満に設定しないでください。
- 長いセッション:ジョブは、セッション内の以前のトレースを7日前までさかのぼって確認します。このジョブは、それより古いトレースをセッションから除外します。
- レート制限:Langfuseは、組織ごとに、公開APIをレート制限します。 ジョブは
429の場合に再試行し、再試行回数を使い切った場合は、ウォーターマークを進めずに停止します。 - 再送信:セッションの
[Agent] Session Endの後に送信されたイベントには、新しい組み込みシグナルの結果は作られません。Amplitudeは、再送信されたイベントを7日の期間内で重複排除します。
今すぐ始める
Langfuse連携ガイドに従ってください。 まずはドライ実行で開始し、最初の実際の実行後にライブイベントとセッションビューアをチェックします。次に、同じウィンドウを再実行して、重複がないことを確認します。
ガイドの最終確認日は2026年10月6日です。Langfuseはその所有者の商標です。Amplitudeは、Langfuseと提携していません。また、Langfuseによって承認されていません。
これは役に立ちましたか?
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.