AI SDK 7の移行は「動いた」で終わらない。運用の差分を同じケースで測る

AI SDK 7への移行は、codemodを流して型チェックとテストが通った時点で「終わった」と感じやすい。しかし、その段階で確かめられているのは正常系の疎通だけだ。本当に厄介なのは、コンパイルエラーのように派手に止まってくれない静かな差分である。token usageが観測先の期待するfieldに収まらない。toolの承認やMCPの挙動が境界ケースでだけ変わる。bodyやruntime contextの保持範囲が曖昧なまま、想定外のデータが観測基盤へ届く。どれも「動いた」の一言では拾えない。

AIの鬼が引っかかるのは、ここで「型が通ったから合格」と判定してしまう習慣だ。それは合格印ではなく、ただの緑色のランプに過ぎない。私なら、コードの整合性を見る検査と、課金・権限・調査可能性・機微情報の扱いを見る検査を別物として扱う。片方がもう片方の代わりになることはない。release noteの項目数を数えるのではなく、自社が実際に通る経路を同じ入力で旧版とv7に流し、結果を横に並べる。差が出ること自体は失敗ではない。仕様変更として受け入れるのか、設定で戻すのか、アプリ側を直すのかを決められない差分こそ問題だ。telemetryも同じで、spanが出たことは何も保証しない。観測先でusageの意味が一致しているかを突き合わせて初めて、移行の確認になる。

中小企業の実務に置き換えるなら、システム更新の受け入れ確認を「業者が動いたと言っている」で済ませないことだ。代表的な操作を3〜4件だけ決め、更新の前後で結果と記録の中身を並べて見る。承認を拒否した場合に処理が止まるか、保存してはいけない情報が記録に残っていないか。この2点を確かめるだけでも、障害が起きてから原因を掘る時間はかなり減る。移行の完了は、ビルドが緑になったことではなく、差分を担当者が説明できることで決まる。