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コーディングエージェントに貼り付けてください。エージェントはガイドを取得し、ジョブを構築して、ドライランから開始します。

text
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。このジョブは、それらがないセッションをスキップし、カウントします。

引き継がれる内容

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.

このページでは