AI Dependency End-of-Life／Deprecation Management

packet_id: MANUAL-EA291-DRAIN-20261022-C1 revision_id: EA-291-RESEARCH-20261022-R1 status: RESEARCH_CANDIDATE / PRE_BRIDGE_AUDIT 確認日: 2026-10-22 JST

AI依存関係の廃止管理とは、モデル、API、SDK、プロンプト保管、検索基盤などの提供終了が業務へ与える影響を把握し、期限までに移行または利用終了を完了する運用である。廃止通知を読んで台帳に日付を書くことは着手にすぎない。実際に使っている依存を特定し、代替で必要な振る舞いとデータを維持できるかを検証し、旧依存への実行経路が残っていないことまで確かめる必要がある。

非推奨、提供終了、サポート終了、新規作成停止、読み取り専用化は同じ状態ではない。呼び出しがまだ成功する期間でも、新しい資源を作れない場合や、移行に必要な履歴を後から取得できなくなる場合がある。利用可否だけで管理すると、動作している間に移行の選択肢を失う。本稿では、通知日、制限が変わる日、停止日、移行準備に必要な日を別々に記録することを提案する。

Vertex AIのリリースノート[S1]の2026-04-02項目には、Gemini 2.5の複数モデルのretirement日程を2026-10-16へ更新したという告知が残っている。これは日程が更新されることの具体例である。確認日より前の日付を、今後余裕がある期限として再掲してはならない。また、過去のリリースノートだけから、現在の全リージョン・全契約の呼び出し可否を判定しない。

OpenAIの廃止一覧[S2]では、reusable prompt objectsとv1/promptsの停止予定が2026-11-30、プロンプト内容のアプリケーションコードへの移行が案内されている。同ページのAssistants API項目には2026-08-26の終了日が記載されている。今回確認した移行資料[S3]は、以前のスレッドメッセージ取得の例が現在は使えず、アプリケーション側に保存したメッセージを利用するよう説明する。また、中間移行先として登場するprompt objects自体にも廃止の注意がある。

これらは特定提供者の特定機能に関する確認時点の資料であり、全APIの共通猶予期間や、利用者環境での移行成功を示すものではない。既存Explorerの期限情報をそのまま転載せず、今回の公式資料確認と過去の告知の位置付けを区別した。

台帳は直接呼び出すモデルだけでなく、要求を成立させる経路を対象にする。例は、アプリケーション、モデルAPI、SDK、ゲートウェイ、プロンプトの保管先、検索索引、埋め込み、ツール用コネクター、認証方式、実行環境である。独自アダプターが古いAPIを内部で使っていると、アプリケーションの表面だけを見ても依存は見つからない。

各依存には、正確な識別子と版、提供者、利用環境、呼び出し元、業務責任者、技術担当、通知の出典、確認日、停止条件、代替候補、移行状態を持たせる。別名と固定版を区別し、別名の参照先が変わる場合の追跡方法も残す。停止日が未公表なら未公表とし、空欄を無期限サポートと解釈しない。

棚卸しはコード検索だけでは完結しない。実行ログ、ジョブ定義、環境設定、管理画面、保管されたプロンプトや既存会話など、実行経路に応じた資料と突き合わせる。利用者や本番データを不要に収集せず、依存の識別と影響判断に必要な範囲へ絞る。コードに残った未使用参照と、利用量が少ないが重要な月次処理も区別する。

公式通知、移行資料、契約上の個別通知は、取得日と該当箇所を付けて保存する。日程が変わった場合は旧情報を黙って上書きせず、旧期限、新期限、変更の出典、業務への影響を残す。SNSや利用者報告は調査のきっかけになっても、提供者の公式な停止日と同じ証拠にはしない。

複数資料が矛盾する場合は、対象モデル、API版、リージョン、アカウント種別、機能をそろえて確認する。単に新しいページだからすべてに適用されるとは限らない。解消できなければ期限不確実として担当者を置き、必要に応じて提供者に確認する。延長が見込めるという期待だけで移行作業を止めない。

移行の社内期限は、利用経路を構成する依存の中で業務を止める最も早い制約から逆算する。API停止が先でも、評価基盤の停止やデータ取得期限がさらに早ければ、準備作業はそちらに合わせる。停止日直前を切替日とすると、評価失敗やデータ不整合の修正期間がなくなる。必要な余裕は変更規模と検証手順から見積もり、一律の猶予日数を安全保証としない。

代替が推奨されていることと、業務要件を満たすことは別である。入力形式、出力構造、ツール呼び出し、状態管理、検索、引用、権限、保持、遅延、費用など、対象業務で必要な契約を列挙する。モデル名やエンドポイントを置き換えて正常応答が返っただけでは、移行完了とは判定しない。

評価では代表的な入力だけでなく、長い会話、空の検索結果、ツール失敗、権限不足、キャンセル、再試行、途中切断、重複実行を含める。外部へ書き込む処理は隔離先や模擬ツールで確認し、旧系と新系の比較のために実際の送信や注文を二重実行しない。結果には入力条件と版、判定基準、失敗例、残った制限を付ける。

AI出力は完全一致しないことがあるため、必要な振る舞いを条件として判定する。例えば「禁止されたデータを参照しない」「必須項目が欠けたら送信を止める」「ツール失敗を成功と伝えない」といった条件である。文面の類似度だけで認可や副作用の安全性を評価しない。業務責任者が許容できる差を確認し、未解決の差があれば利用範囲を狭めるか代替策を選ぶ。

会話、プロンプト、添付ファイル、検索索引、外部IDの対応は、APIの機能と独立して移行対象になり得る。何を移す必要があるか、どこに正本があるか、どの権限と保持期限が付くかを確認する。すべてを新しい保管先へコピーすると、削除済みデータを復活させたり、閲覧権限を広げたりする可能性がある。

移行前後の件数だけでなく、参照の対応、会話順序、関連ファイル、アクセス制御、削除要求、監査上必要な来歴を確認する。索引を再生成する場合は、元データが同じでも検索結果や引用が変わり得るため、検索品質の検証を別に行う。保存されていない履歴を、移行先が自動的に復元できると想定しない。

今回のAssistants移行資料の注意は、古いサンプルコードをコピーするだけではデータ取得経路を確保できない具体例である。移行資料のコードとその注意書きを一緒に読み、現在使える経路かを確認する。中間移行先に別の廃止期限がある場合は、その依存も台帳へ追加し、短期間で二度移行する必要が生じないかを検討する。

切替計画には、対象利用者、段階、監視、停止条件、判断責任者、未処理ジョブ、既存会話、外部副作用の扱いを含める。新規要求を新系へ向けても、古いジョブや再試行ワーカーが旧APIを使い続ける場合がある。実行ログと設定を照合し、低頻度の処理も確認する。

ロールバック先が停止済みなら、旧APIへ戻す計画は成立しない。期限前でも、状態やデータが新系で更新された後に旧系がそれを読めるかを確認する。戻せない変更は切替前に識別し、必要なら読み取り専用運用、手作業、機能制限などの退避策を準備する。外部送信や削除が設定切替だけで取り消せると考えない。

完了条件は、承認した要件を新系で満たし、必要なデータ照合を終え、旧経路からの要求が残らず、不要な資格情報と資源を整理し、責任者が運用を引き継いだことである。保管義務がある証跡まで廃止作業で削除しない。期限通知を閉じることと、資源の削除を同一の操作にせず、それぞれの条件を確認する。

管理には、期限付き依存のうち責任者が決まった割合、最終確認からの経過、移行評価の未解決条件、切替までの余裕、旧経路の残存呼び出しを使える。単なる台帳の登録件数や「対応中」の数だけでは、停止リスクは判断できない。未登録の依存を探す棚卸しと、登録済み依存の進捗管理を両方行う。

失敗しやすいのは、最新という別名なら廃止されないと考える、推奨代替を検証せず採用する、通知メールの宛先社員が退職する、移行資料の中間手順が古くなる、停止後も旧APIへの自動再試行を続ける、といった運用である。通知先、担当者、証拠、実行経路を結び付けることで、担当者の記憶だけに依存しない管理にする。

• 本組織で実際に使うモデル、SDK、API、プロンプト保管、会話保存、契約別の停止条件は未棚卸しでありUNKNOWN。
• Vertex AIの過去の告知日程を確認したが、全環境の現在の利用可否は確認していない。OpenAIの停止予定も確認日時点の公式記載であり、変更時は再確認が必要。
• 本RUNではAPI呼び出し、データ抽出、移行、品質評価、切替、ロールバック、旧資源削除はすべてNOT_RUN。対象組織の移行完了を主張しない。
• SAFE_WORDINGは「期限と対象を確認し、実際の依存経路、データ、業務条件を検証して移行する」。代替名が載っているだけで互換、旧履歴を必ず復旧可能、全提供者が一定期間を保証、と書かない。
• 本文は調査候補として監査へ引き渡すもので、独立監査・採用・公開は未完了。

[S1] Google Cloud, Vertex AI release notes, https://docs.cloud.google.com/vertex-ai/generative-ai/docs/release-notes 。2026-10-22 JST取得。2026-04-02のretirement日程変更の項目。過去の告知として使用。

[S2] OpenAI, Deprecations, https://developers.openai.com/api/docs/deprecations 。同日確認。Reusable promptsの2026-06-03項目と停止予定、Assistants APIの終了日欄。日付と推奨移行の根拠。

[S3] OpenAI, Assistants migration guide, https://developers.openai.com/api/docs/assistants/migration 。同日確認。Migrating your integration節のprompt objectsの注意と、保存済みメッセージを使う移行上の制約。

既存SOURCE_CLAIM_INDEX行2549（EV-XPL-20261016-R225-01／SRC-EVID-000120）、行2600（EV-XPL-20261017-R311-01／SRC-EVID-000144）、行2602（EV-XPL-20261018-R315-01／SRC-EVID-000145）の論点を再確認した。今回の公式資料取得と既存Explorerの記録を区別し、無関係な行2601を本件の根拠として流用していない。

旧退避文書1Vd0BP7G2UyPDRQs_-8dPvTgQ78Tk6kcVGuMJjqNdr84、2026-09-18 12:20 JST RUN、tab t.0:25571–31074内EA-291、原案t.0:49466、ARTIFACT_INDEX行267は所在監査の来歴である。既存の完成記事とせず、今回の調査本文を新規成果として記録した。