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

LangSmith連携では、LangSmithがすでに追跡しているエージェントの会話(過去の会話を含む)が、エージェント分析に転送されます。インフラストラクチャ内のスケジュール済みジョブが、完了済みのLangSmithスレッドを取得し、それらを[Agent]イベントにマップし、AmplitudeのHTTP APIに送信します。Amplitudeは次に、セッション、ターン、ツール呼び出しを構築し、組み込みのシグナルを実行します。

アプリがすでにOpenTelemetryを出力している場合は、このジョブを実行するのではなく、Amplitudeを2番目のOTLPエクスポータとして追加できます。OpenTelemetryトレースをエージェント分析に送信するを参照してください。この連携を使用して、履歴を含む、LangSmithにあるすでに存在する情報を転送できます。

フォワーダーは、スレッドに対して設定された1つの[Agent] Agent IDをスタンプします。ネストされたLangSmith実行は、ツール呼び出しまたはスパンのままになります。これらは子エージェントにはならず、ジョブは[Agent] Parent Agent IDを設定しません。親子リネージュの場合は、実行中のエージェントをrunAs()でインストルメントするか、OpenTelemetryスパンでamplitude.parent.agent.idを設定します。マルチエージェントシステムのインストルメンテーションを参照してください。

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

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

text
Connect our LangSmith threads to Amplitude Agent Analytics.
Fetch https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/langsmith.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時間ごと)に従って実行します。実行の間にウォーターマークを保存します。
  • 必要なもの: LangSmith APIキー、プロジェクトID、LangSmithリージョンまたはセルフホストURL、AmplitudeプロジェクトのAPIキー。 セルフホスト版のLangSmithには、バージョン0.16以降が必要です。
  • ログする必要のあるアプリ:session_idまたはthread_idおよび実行メタデータ内のユーザーID。このジョブは、それらのスレッドを使用せずにスキップし、カウントします。

引き継がれるもの

鮮度と制限

  • Settle time: このジョブは、2 時間経過した後、新しいトレースなしでスレッドを終了したとみなします。
  • レート制限:LangSmithはAPI呼び出しを制限します。このジョブは、バックオフを伴って再試行され、Retry-Afterに従います。
  • リテンション: LangSmithはベースリテンションで14日間、延長リテンションで180日間トレースを保持するため、バックフィルはその期間までしか遡れません。
  • 再送信:セッションの[Agent] Session Endの後に送信されたイベントには、新しい組み込みシグナルの結果は作られません。Amplitudeは、7日間期間で再送信されたイベントを重複排除します。

今すぐ始める

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

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

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

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.

このページでは