Python AI SDKリリースノート
amplitude-aiのリリースノート。Node SDKについては、Node AI SDKリリースノートを参照してください。
1.18.0
リリース:2026年10月。このリリースでは、プライバシー処理、プロバイダーラッパー、MCPサーバー、CLIツール、リリースパイプラインが強化されます。 Amplitudeは、すべてのユーザーにアップグレードを推奨します:python3 -m pip install --upgrade "amplitude-ai>=1.18.0"。
挙動の変更
@toolは、アクティブなプライバシー設定を継承します。デコレータ、AmplitudeAIクライアント、またはToolCallTracker.set_amplitude()からの指定がない場合、メタデータのみを送信し、警告を一度記録します。ツールの入力と出力をキャプチャするには、privacy_config=を渡します。custom_redaction_fnが発生した場合、SDKは影響を受けるコンテンツを破棄します。custom_redaction_patternsエントリが無効の場合、SDKはエラーをログに記録し、ユーザーが修正するまでメッセージのコンテンツを保留します。wrap()渡されたクライアントを再利用するため、base_url、http_client、ヘッダー、およびタイムアウトが保持されます。wrap()に渡すクライアントオプションは、with_options()を通じて適用されます。validate=Trueは、ラップされたプロバイダーの呼び出しの中で、もはや例外を発生させません。enable_otel()は、デフォルトでは、gen_ai.*またはamplitude.*属性を持つスパンのみをマップします。HTTPやデータベースのスパンなど、他のスパンも[Agent] Spanイベントとしてマップするには、otel_span_filter="all"を渡します。- MCP
scan_projectツールは、クライアントのMCPルート、またはサーバーの作業ディレクトリのみを読み取ります。他のディレクトリを許可するには、AMPLITUDE_AI_MCP_ROOTSにリストします。 - MCP
instrument_fileツールは、bootstrap_import内のインポートステートメントのみを受け入れます。100万文字を超えるMCPツールの入力は拒否されます。 - 依存関係の範囲には上限があります(例:
fastmcp<5やstarlette<2)。 - カスタム
x-trace-id値は、Node SDKと一致する64文字に制限されています。より長い値は、インバウンドリクエストでは無視され、アウトバウンドリクエストでは送信されません。 enable_otel()では、SDK自身のスパンにおいて、セッションユーザーよりもamplitude_user_idper-callが優先されます。これは、OpenTelemetryを使用しない場合と同じです。
修正
- トラッキングエラーは、ラッピングされたプロバイダー呼び出しに影響を与えなくなり、同期ストリームはプロバイダーのストリームオブジェクトを返します。
- APIキーを持つアップロードは、設定済みのHTTPSオリジンにのみ送信され、リダイレクトに従わず、30秒後にタイムアウトします。
- PIIのマスキングは、Unicodeテキスト、アクセント文字、ギリシャ文字、またはキリル文字を使用したメール、構造化ペイロードを対象とし、パッチ適用されたGeminiおよびMistral呼び出し、およびエンリッチメントフリーテキストに適用されます。キャプチャされたコンテンツには、メディア部分は含まれません。
@observeは、@toolと同じ順序でプライバシー設定を解決するため、アクティブなセッションのコンテンツモードが適用されます。AIConfig.propagate_contextが有効になります。有効なHTTPヘッダー値でないコンテキストIDは、リクエストに失敗するのではなく、除外されます。- エラーログはメッセージのコンテンツとユーザーIDを省略し、CLIとステータス出力はキーをマスクします。
- MCPサーバーは、バナーやPyPI更新チェックなしで起動します。 CLIはインストール済みのパッケージからのみガイドを読み取り、バンドルされているドキュメントは
amplitude_ai/_docs/の下に提供されます。 enable_otel()では、セッション外のプロバイダーコールは、per-callamplitude_user_idまたはwrap(user_id=...)デフォルトを使用します。wrap(wrapped_client, amplitude=other)は、内部ラッパーのユーザーとデバイスのデフォルト値を継承しなくなりました。- LangChainとOpenAIエージェントのハンドラは、実行ごとの状態を10,000エントリに制限しているため、終了しない実行によってメモリ使用量が増加することはありません。
- すでにパッチが適用されたプロバイダーについて再度呼び出す
patch()と、警告が記録されます。最初の設定は、unpatch()を呼び出すまで有効です。 - localhostのアップロードまたはカタログエンドポイントへのリクエストは、
HTTP_PROXYおよびHTTPS_PROXYをスキップします。 - MCP
instrument_fileツールは、多数のルートハンドラを持つファイルに対して、線形時間で実行されます。 amplitude-ai-instrumentによって開始されたプロセスは、環境内にAMPLITUDE_AI_API_KEYを保持します。信頼できないサブプロセスを、その環境から除外した状態で開始します。
1.17.0
2026年10月7日リリース。
挙動の変更
- 現在、
AIConfig.redact_piiはデフォルトでTrueになります。このリリース以前は、AmplitudeAIを明示的なredact_pii設定なしで構築した場合、メッセージコンテンツは編集されずに送信されていましたが、PrivacyConfig、patch()、スタンドアロンプロバイダーのラッパー、およびNode SDKはデフォルトで既に編集済みでした。組み込みの秘匿機能は、イベントがプロセスから出力される前に、メールアドレス、電話番号、SSN、クレジットカード番号、IPアドレスを秘匿します。生のコンテンツを保持するには、AIConfig(redact_pii=False)を渡します。
修正
- PyPIページはプライベートリポジトリへのリンクを削除し、そのリンク先はAI SDKリファレンスを指しています
Documentation。 - バンドルされているエージェントガイドでは、正しいFastAPIミドルウェアのインポート
amplitude_ai.middleware.AmplitudeAIMiddlewareと、必要なamplitude_ai=およびuser_id_resolver=引数を使用しています。 - バンドルされたエージェントガイドには、Amplitudeが送信しなくなった
[Agent] Topic Classificationが記載されなくなりました。
1.16.0
2026年10月6日リリース。
機能
- イベントカタログには
[Agent] Data Quality Rationaleと[Agent] Data Quality Evidenceが追加されます。
修正
- Geminiの呼び出しは、現在記録されるようになっています
[Agent] Provider Request ID。 - SDKはルーターが選択したモデルに基づいてFireworksルーターの呼び出し料金を計算するため、
[Agent] Cost USDを失うことはなくなりました。
1.15.0
リリース日:2026年9月24日。
機能
- すべての追跡イベントには
[Agent] Content Mode(full、metadata_only、またはcustomer_enriched)が含まれるようになったため、Amplitudeは、意図的なメタデータのみのセッションと、インストルメンテーションがメッセージテキストを削除したセッションとを区別できます。 - ユーザーメッセージのコンテンツが空の場合、ローカル検証は
metadata_onlyおよびcustomer_enrichedモードを除き、失敗します。
1.14.0
2026年9月19日リリース。
破壊的な変更
- 他のローカルユーザーが
psを使用して引数を読み取ることができるため、amplitude-ai-register-catalogはシークレットキーを引数として受け入れなくなりました。stdinからシークレットを読み取るには、AMPLITUDE_API_KEYおよびAMPLITUDE_SECRET_KEYを設定するか、--secret-key -を渡してください。--secret-key <value>はエラーで終了します。
修正
- 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.