Vercel AI SDK v7：TypeScript のアプリ層として強いが、AI 基盤のすべてではない
Vercel AI SDK は、複数のモデル提供元を共通の TypeScript API から扱い、テキスト生成、構造化出力、ストリーミング UI、ツール呼び出しを実装するためのライブラリです。2026年8月19日時点の主系列は [email protected] で、Node.js 22 以上と Apache-2.0 ライセンスを確認しました。
重要なのは製品境界です。オープンソースの SDK、別契約の AI Gateway、任意の UI 部品集 AI Elements、Vercel のホスティングや可観測性は同じものではありません。これらを一括して『SDK の機能』と呼ぶと、通信経路、費用、保持期間、移行可能性を誤って評価します。
採用判断は『モデルを交換できるか』だけでなく、交換後もツール引数、停止条件、例外、利用量、画面状態が同じように動くかで行います。型が共通でも、モデルの挙動まで同じになるわけではありません。
2026年時点の製品境界
| 確認項目 | 確認できた事実 | 判断への影響 |
|---|---|---|
| 主系列 | [email protected]、Node.js 22 以上 | 古い v5/v6 の例をそのままコピーしない |
| エージェント | ToolLoopAgent と stopWhen | 停止条件と最大反復回数を明示する |
| 通信 | Core、UI transport、各 provider package | 画面状態とサーバー状態を分けて試験する |
| 別製品 | AI Gateway、AI Elements、Vercel Cloud | 料金、保持、障害範囲を個別に確認する |
useChat は v5 以降で通信設計が変わっています。検索で見つけたコードがコンパイルできても、現行の状態管理や再接続の設計に合うとは限りません。ロックファイルと移行文書を同時に保存してください。
安全な移行と評価の手順
- 現在のパッケージ、provider、Node.js、フレームワークの版を固定する。
- 通常回答、構造化出力、ツール呼び出し、取消、再接続を含む評価用シナリオを作る。
- ツールの JSON Schema、認可、確認画面、べき等性を SDK の外側で実装する。
- 旧版と新版を同じ入力で走らせ、出力だけでなくイベント列と利用量を比較する。
- タイムアウト、429、部分ストリーム、provider 障害を意図的に発生させる。
- 少量の利用者から段階的に移行し、即時に戻せる経路を残す。
| 評価軸 | 測定方法 | 合格条件 |
|---|---|---|
| 正確性 | 固定した課題で構造と引用を比較 | 重大な意味差がない |
| ツール安全性 | 引数、権限、重複実行を記録 | 無断実行と二重実行がゼロ |
| 運用 | p95、取消、再接続、エラー率 | 既存基準を満たす |
| 費用 | 成功した処理単位で総費用を計算 | 予算上限と警告が機能する |
本番で見落としやすい限界
provider 抽象化は移行作業を減らしますが、モデルの推論品質、ツール選択、構造化出力の厳密さまでは標準化しません。provider を変えるたびに回帰試験が必要です。
MCP や外部ツールを接続すると、プロンプトインジェクションが実操作につながります。読み取りと書き込みを分け、不可逆操作には人の承認を置きます。
実験的な OpenTelemetry 連携では入力や出力が記録される可能性があります。機密情報の伏字、利用者同意、保持期間を先に決めます。
Gateway は便利ですが、直接 provider を呼ぶ構成とは障害範囲と請求経路が変わります。非常時の迂回経路も試験対象です。
代替手段との使い分け
| 選択肢 | 向いている用途 | 主な注意点 |
|---|---|---|
| Vercel AI SDK | TypeScript で AI 機能と UI を組む | 長期状態や業務ワークフローは別途設計 |
| OpenAI Agents SDK | OpenAI 中心の agent、handoff、tracing | provider 中立性は低い |
| LangGraph | 長期状態、分岐、再開を伴う処理 | 学習と運用設計が重い |
| 直接 API | 単一 provider の小さな機能 | 交換性と共通 UI を自作する |
TypeScript 製品で生成、ストリーム、ツール実行を共通化したいなら有力です。複雑な長期業務を SDK 一つで管理できると期待すると設計不足になります。
独立判断では、まず Core と必要な provider package だけで始め、Gateway や追加 UI は運用上の効果を測ってから採用するのが安全です。
よくある質問
無料ですか？
SDK は Apache-2.0 のオープンソースです。モデル API、AI Gateway、Vercel のインフラ料金は別に発生します。
provider を変えれば同じ結果になりますか？
なりません。型と呼び出し方は共通化できますが、推論、ツール選択、拒否、利用量は変わります。
v5 の useChat コードはそのまま動きますか？
状態管理と通信設計が変わっているため、公式移行文書に沿った確認が必要です。
MCP は安全ですか？
接続しただけでは安全になりません。権限分離、承認、監査、入力の不信任が必要です。
AI Gateway は必須ですか？
必須ではありません。provider package から直接呼び出す構成も可能です。
どんなチームに向きますか？
TypeScript を主軸に、AI 機能と画面を同じ製品内で管理したいチームに向きます。
確認した一次資料
- 参照資料 1: github.com/vercel/ai
- 参照資料 2: github.com/vercel/ai/releases
- 参照資料 3: github.com/vercel/ai/blob/main/LICENSE
- 参照資料 4: ai-sdk.dev/docs/ai-sdk-core/generating-text
- 参照資料 5: ai-sdk.dev/docs/ai-sdk-core/tools-and-tool-calling
- 参照資料 6: ai-sdk.dev/docs/reference/ai-sdk-core/tool-loop-agent
- 参照資料 7: ai-sdk.dev/docs/ai-sdk-ui/transport
- 参照資料 8: ai-sdk.dev/docs/ai-sdk-ui/stream-protocol
- 参照資料 9: ai-sdk.dev/docs/ai-sdk-core/mcp-tools
- 参照資料 10: ai-sdk.dev/docs/ai-sdk-core/telemetry
- 参照資料 11: vercel.com/docs/ai-gateway
- 参照資料 12: vercel.com/docs/ai-gateway/pricing
- 参照資料 13: elements.ai-sdk.dev
- 参照資料 14: docs.langchain.com/oss/javascript/langgraph/overview
- 参照資料 15: github.com/openai/openai-node
- 参照資料 16: openai.github.io/openai-agents-js/
独立確認日：2026年8月21日。版、料金、実験機能は変わるため、導入時に公式文書を再確認してください。