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 コーディング エージェントに貼り付けます。 エージェントはガイドを取得し、ジョブを構築し、ドライ実行から始めます。
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。このジョブは、それらのスレッドを使用せずにスキップし、カウントします。
引き継がれるもの
| データ | 繰り越します |
|---|---|
| セッションのグループ化 | はい、1つのLangSmithスレッドが1つのセッションになります |
| モデルとプロバイダー | はい |
| トークン | はい |
| コスト | はい、LangSmithのコスト値。 Amplitudeはそれを再計算しません。 |
| ツール呼び出し | はい |
| LangSmithのフィードバック | いいえ、ジョブでそれをScoresにマップしない限り、 |
| 実験 | はい、ルート実行のextra.metadataにバリアントが記録されている場合。どのキーがそれを保持しているかをコーディングエージェントに伝えます。 |
鮮度と制限
- 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.