Node AI SDKリリースノート
@amplitude/aiのリリースノート。エンジニアリングの変更履歴の詳細については、GitHub上のAmplitude-AI-Node CHANGELOGを参照してください。Python SDKについては、Python AI SDKリリースノートを参照してください。
0.24.1
2026年10月26日リリース。
修正
- 構造化されたコンテンツチャネル内のシリアル化されたJSONオブジェクトと配列に数値と有効なJSONエスケープを保持します。 組み込みのリダクションは、デコードされた文字列値とキーをスキャンし、認識された電話番号、カード、SSNフィールドの下にある数値をマスクし、その他の数値トークンをそのまま保持します。1つの秘匿化されたキーに統合される個別の元のキーは、シリアル化されたドキュメントをフェイルクローズさせます。
0.24.0
リリース:2026年10月。
機能
- インラインメッセージ添付ファイルにオプションの
$agent_artifactTypeScript型を追加し、ランタイムキャプチャを変更したり、アーティファクトスキーマを検証したりすることなく、型推論を改善します。 - エージェントの委任を通じてマルチエージェントのリネージュを保存し、あるエージェントが別のエージェントに委任したときに、完全なエージェントのチェーンが記録されるようにします。
- 明示的なユーザーロールを使用して作成したスパン
[Agent] Sourceに設定します。これは、プロバイダー発信のユーザーメッセージが追跡される方法と一致します。
修正
- 回帰後、ツールとスパンの入力と出力、およびAIとユーザーのメッセージ添付ファイルのアーティファクトキャプチャを復元します。
- アーティファクトのプライバシーを強化: サポートされていないMathMLスナップショットを拒否し、CSSの引用漏洩を閉じ、静的アーティファクトテキストの可視性を制限します。これにより、コンテンツがアクティブなコンテンツモードの外に表示されないようになります。Raw HTMLアーティファクトのスナップショットはプロデューサーが所有しています。既存のコンテンツキャプチャ設定、ベストエフォート方式の文字列墨消し、サイズ制限が適用されます。
- LangChainの会話では、以前のすべてのターンを再記録するのではなく、新しいユーザーのターンのみを記録し、
[Agent] User Messageイベントの重複を防ぎます。 - OTLPリプレイスクリプトにおいて、エンベロープが未加工の
resourceSpansペイロードの場合、フラグで削除できないコンテンツをサイレントに含めるのではなく、転送の前に--metadata-onlyを拒否するように修正します。
0.23.0
リリース:2026年10月。 公開ガイドURLでは、現在、mainをトラッキングするようになっているため、以降のSDKリリースでは新しいリンクは必要ありません。 このリリースでは、AWS Strandsガイド、HTTP、OpenTelemetry、Batch、S3、ウェアハウスインポートのプライバシー契約が追加され、[Agent] Session Endオプションであり推奨であることが記載されています。
0.22.0
リリース:2026年10月。
機能
- レビューモード(
reviewMode: true)を追加します。SDKは、各post-redactionイベントを記録し、Amplitudeに送信することなく、サニタイズされた転送前のアップロードプレビューを印刷します。getReviewTraffic()を使用してプレビューをご覧ください。ゼロコードのインストルメンテーションについては、AMPLITUDE_AI_REVIEW=trueを設定します。プロンプトとメッセージのコンテンツはそのまま保持されます。エンベロープAPIキーは[REDACTED]です。AMPLITUDE_AI_DEBUGではレビューモードは有効になりません。
const ai = new AmplitudeAI({
apiKey: process.env.AMPLITUDE_AI_API_KEY!,
config: new AIConfig({ reviewMode: true }),
});
// Exercise a representative session, then:
await ai.flush();
console.log(ai.getReviewTraffic());
0.21.0
リリース:2026年10月。 このリリースでは、プライバシー処理、プロバイダーラッパー、MCPサーバー、CLIツール、リリースパイプラインが強化されます。 Amplitudeは、すべてのユーザーにアップグレードを推奨します:npm install @amplitude/ai@^0.21.0。
挙動の変更
tool()はアクティブなコンテンツモードを継承しています。デコレータ、セッションのAmplitudeAIクライアント、またはToolCallTracker.setAmplitude()からのプライバシー設定がない場合、メタデータのみを送信します。ツールの入力と出力をキャプチャするには、privacyConfigを渡します。customRedactionFnがスローした場合、SDKは影響を受けるコンテンツを破棄します。設定のビルド時に無効なcustomRedactionPatternsがConfigurationErrorをスローします。wrap()は、渡したOpenAI、Azure OpenAI、またはAnthropicクライアントをその場でインストルメントするため、baseURL、fetch、ヘッダー、およびタイムアウト値が維持されます。Request options(signal、timeout、headersなど)はプロバイダーに渡されます。pushContext(ctx, fn)は、fn実行中のみコンテキストを設定します。コールバックなしでpushContext(ctx)を呼び出すことは引き続き可能ですが、HTTP サーバーではコンテキストが同じ接続上の後のリクエストに引き継がれる可能性があるため非推奨となっており、警告が1回出力されます。pushContext(ctx, fn)、runWithContext()、またはsession.run()のいずれかを使用してください。amplitude-ai-instrument起動するプロセスのみをインストルメントします。子ノードプロセスもインストルメントするには、AMPLITUDE_AI_INSTRUMENT_CHILDREN=trueを設定します。- MCP
scan_projectツールは、クライアントのMCPルート、またはサーバーの作業ディレクトリのみを読み取ります。他のディレクトリを許可するには、AMPLITUDE_AI_MCP_ROOTSにリストします。 - MCPサーバーは、バンドルされたコピーの代わりに、インストール済みの
@modelcontextprotocol/sdkおよびzodを使用し、これらが欠落している場合は何をインストールすべきかを通知します。 - ピアの依存関係範囲には上限があります:
@amplitude/analytics-node、@opentelemetry/api、およびtiktokenは2未満、@opentelemetry/sdk-trace-baseは3未満です。 - Docsとバンドルされているガイドは、スコープ付きパッケージからコマンドを実行し
npx -y -p @amplitude/ai <command>、インストール済みのパッケージから連携スクリプトを実行します(例:node node_modules/@amplitude/ai/docs/integrations/check-agent-events.mjs)。ガイドURLは、mainではなくリリースタグを指します。 patch()の場合、OpenAIおよびAnthropicの呼び出しはSDK独自の型を返します。create()はAPIPromiseを返すため、.withResponse()と.asResponse()が機能し、ストリームはSDKのStreamであるため、.tee()と.toReadableStream()が機能します。- セッション内のパッチ適用済みプロバイダー呼び出しは、別のインスタンスが呼び出した場合でも、セッションを所有する
AmplitudeAIインスタンスに移動しますpatch()。
修正
- トラッキングエラーは、ラッピングされたプロバイダー呼び出しには影響を与えません。
- 各
AmplitudeAIインスタンスは独自のクライアントとコンテキストの伝搬を保持し、連携は実行ごとにIDを解決します。 伝搬されたコンテキストはリクエストヘッダーでのみ送信されます。有効なHTTPヘッダー値でないIDは、リクエストに失敗するのではなく、除外されます。 - デバッグログではメッセージのコンテンツを省略し、警告ではユーザーIDを省略します。 添付ファイルとメッセージラベルは墨塗り(非表示化)されます。
- OpenTelemetryのスパンマッピングを修正しました。
- オフライン評価のアップロードにはHTTPSが必要で、タイムアウトを使用します。 フラッシュにはタイムアウト制限があります。
- このパッケージにはオプションの依存関係がバンドルされなくなったため、出荷されるファイル数は約半分です。
ai.flush({ timeoutMs })はタイムアウト後に待機を停止し、エラーなしで解決します。ai.flush()オプションなしの状態は変更されません。enableOtel()とAmplitudeAgentExporterの両方が確認するスパンは一度だけ記録されます。amplitude-ai-instrumentは、起動したアプリにstopシグナルを転送し、アプリの終了コードを使用して終了します。 それはnode_modules/.bin/<launcher>を、tsxやnodemonといったものと同様に、ランチャー自体のように扱います。amplitude-ai-doctorは、不正な形式のpackage.jsonをクラッシュではなく失敗したチェックとして報告します。- MCPサーバーは、コードスニペットでより多くのキー形式をマスクし、すべてのツール引数のサイズを制限します。
0.20.1
2026年10月7日リリース。
修正
@google/genaiは、@google/generative-aiなどのオプションのピア依存関係になりました。GoogleGenAIラッパーはすでにそれを要求しています。- バンドルされているREADMEとエージェントガイドでは、組み込みシグナルを
[Agent] Session Recordのプロパティとして、またカスタム評価者を[Agent] Evaluator Resultイベントとして記述するようになりました。また、廃止されたイベントも表示されなくなりました。 - プロバイダーマトリクスに、Gemini、Azure OpenAI、Bedrockのキャッシュトークン統計情報が表示されます。 Mistralのみがこれらをレポートしません。
- バンドルされている
amplitude-ai.mdガイドでは、正しいtrackToolCallオプション、inputおよびoutputを使用しています。
0.20.0
2026年10月6日リリース。 このリリースには、npmに公開されていない0.19.0の変更点も含まれています。
機能
[Agent] Ingestion Pathおよび[Agent] SourceのPROP_INGESTION_PATHおよびPROP_SOURCE定数。amplitude-ai-register-catalogは、SDKがすでに送信した[Agent] Git SHA、[Agent] Git Ref、[Agent] Git Repo、および[Agent] Provider Request IDを登録するようになりました。
修正
- Geminiの呼び出しは、現在
[Agent] Provider Request IDで記録されています。 - SDKは、ルーターが選択したモデルでFireworksルーター呼び出しの価格を設定するため、これ以上
[Agent] Cost USDを失うことはありません。 amplitude-ai-register-catalogは[Agent] Enrichment Cost USDを登録しなくなりました。これはAmplitudeが送信しなくなったためです。- SDKは
@pydantic/genai-pricesを^0.1.3にピン留めしているため、将来のメジャーバージョンで黙ってコストを削減することはできません。
0.18.0
リリース日:2026年9月24日。
機能
- すべての追跡イベントは現在
[Agent] Content Mode(full、metadata_only、またはcustomer_enriched)を保持しているため、Amplitudeは、意図的なメタデータのみのセッションと、インストルメンテーションがメッセージテキストを削除したセッションを判別できます。 MockAmplitudeAI.summary()ユーザーメッセージのコンテンツが空の場合、metadata_onlyおよびcustomer_enrichedモードを除き、失敗するようになりました。
0.17.0
2026年9月19日リリース。
破壊的な変更
amplitude-ai-register-catalogは認証情報を引数として受け入れなくなりました。 スクリプトの実行時に環境からAMPLITUDE_API_KEYおよびAMPLITUDE_SECRET_KEYを読み取ります。スクリプトをファイルに書き込み(npx -y -p @amplitude/ai amplitude-ai-register-catalog > register.sh使用)、内容を確認してから、両方の変数をエクスポートした状態でbash register.shを実行します。
機能
- OpenRouter、LiteLLM、Requestyのゲートウェイのレシピ。 ゲートウェイを参照してください。
- LangChainハンドラは、チャットモデルの
[Agent] User Messageを追跡します。 - OpenTelemetryのエクスポータは
privacyConfig、allowedScopes、およびblockedScopesを受け入れます。
修正
- SDKがモデルの価格を調べられない場合、
$0を記録する代わりに[Agent] Cost USDを省略するようになりました。
これは役に立ちましたか?
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.