Vercel AI SDK 是什麼、怎麼用：TypeScript 開發 AI 應用和智能體的開源工具包

本文根據 Vercel AI SDK 官方 GitHub 倉庫 README 整理，資料核對於 2026-10-11。開源項目變化快，以官方倉庫為準。

是什麼

Vercel AI SDK（npm 包名就叫 ai）是 Vercel 維護的開源庫，README 稱它是「TypeScript 的 AI 工具包」：一個免費、開源、用於構建 AI 應用和智能體的庫。如果你用 Next.js、React 這類技術棧做帶聊天介面的產品，它幾乎是預設選擇——它同時解決了後端「怎麼調模型」和前端「怎麼把流式輸出顯示出來」兩件事。倉庫約有 2.72 萬星標。

能做什麼

README 介紹的幾個部分：

• 統一的模型訪問：用同一套接口調用 OpenAI、Anthropic、Google 等模型；README 說明預設通過 Vercel AI Gateway 訪問，也可以安裝各家的 provider 包直連。
• 文本與結構化輸出：generateText 生成文本；配合 Output.object 讓模型按指定結構返回數據。
• 智能體：ToolLoopAgent 提供帶工具調用的智能體循環。
• 前端 UI 鉤子：例如 useChat，適配 Next.js、React、Svelte 和 Vue，處理消息狀態與流式渲染。
• 模板與技能：倉庫提供項目模板，以及一個給編程智能體用的技能包。

怎麼上手

README 給出的安裝命令（需要 Node.js 22 或更高版本）：

bash
npm install ai
npm install @ai-sdk/react                                   # 前端鉤子
npm install @ai-sdk/openai @ai-sdk/anthropic @ai-sdk/google # 按需安裝各家 provider

想讓編程智能體熟悉這個庫，可以運行 npx skills add vercel/ai 安裝官方技能。

典型路線：在服務端路由裏用 generateText（或流式版本）調用模型，在頁面組件裏用 useChat 連接這個路由，幾十行代碼就能得到一個可用的聊天介面；之後再加入工具調用和結構化輸出。

免費與付費

庫本身免費、開源。費用來自兩處：模型調用費（直連各家，或通過 Vercel AI Gateway 計費），以及應用的託管費用。它並不要求部署在 Vercel 上。

適合誰 / 不適合誰

適合： 使用 TypeScript 的全棧和前端開發者；要做聊天介面、流式輸出的 Web 產品；希望隨時切換模型供應商的團隊。

不適合： 以 Python 為主的團隊（可以看 Pydantic AI、LangGraph 等）；不寫代碼的用戶；只需要在腳本里調用一次模型的簡單場景——直接用官方 SDK 更省事。

注意事項

• 大版本之間有破壞性變更，老教學裏的函數名可能已經改了，以當前文檔為準。
• API Key 只能放在服務端，不要寫進前端代碼。
• 預設經由 AI Gateway 時，請求會經過 Vercel 的服務，有合規要求的項目改用直連 provider。