Vercel AI SDK: bộ công cụ TypeScript cho ứng dụng AI
AI SDK cho phép dự án TypeScript chỉ cần một lệnh gọi hàm — generateText() — là tới được model của OpenAI, Anthropic hoặc Google qua Vercel AI Gateway, thay vì phải dùng ba SDK riêng của từng provider. Nên dùng nếu bạn đã dùng Next.js, React, Svelte hoặc Vue và muốn đổi model chỉ bằng cách đổi một chuỗi string; nên bỏ qua nếu backend của bạn chạy Python hay stack không phải JS, vì mọi ví dụ trong README đều giả định TypeScript.
Vercel AI SDK là gì?
AI SDK là bộ công cụ TypeScript của Vercel dùng để kết nối các mô hình ngôn ngữ lớn vào code của bạn mà không bị khóa vào SDK của một nhà cung cấp duy nhất. Bạn chỉ cần gọi generateText() với một chuỗi model như 'openai/gpt-5.4' hay 'anthropic/claude-opus-4.6', phần xử lý riêng của từng provider do thư viện lo. Package lõi được publish dưới tên ai trên npm, cùng các package hook riêng cho từng framework như @ai-sdk/react.
Các tính năng cốt lõi
- ✓API thống nhất cho provider — generateText() và generateObject() nhận một chuỗi model như 'anthropic/claude-opus-4.6' hay 'openai/gpt-5.4' và chạy qua cùng một chữ ký hàm bất kể nhà cung cấp nào.
- ✓Mặc định dùng Vercel AI Gateway — các lệnh gọi model đi qua gateway của Vercel trừ khi bạn cài thêm package provider như @ai-sdk/openai hoặc @ai-sdk/anthropic để gọi trực tiếp.
- ✓Structured output qua Output.object() — truyền vào một schema Zod là nhận lại một object có kiểu dữ liệu rõ ràng, thay vì tự parse văn bản tự do.
- ✓Class ToolLoopAgent để dựng agent — gắn các tool như trình thực thi shell hay công cụ tạo ảnh vào một vòng lặp do SDK quản lý.
- ✓Hook của AI SDK UI — useChat() và các hook liên quan từ @ai-sdk/react không phụ thuộc framework, dùng được trên cả Next.js, React, Svelte và Vue.
- ✓createAgentUIStreamResponse() — stream output của agent thẳng vào response của một route API trong Next.js.
Xây dựng ứng dụng AI
- •Giao diện chat dựng trên useChat() kết hợp với một route API Next.js, đúng như ví dụ image-generation-agent trong README.
- •Agent gọi tool thật — ví dụ sandboxAgent trong README cho một ToolLoopAgent quyền truy cập shell qua Vercel Sandbox.
- •Trích xuất dữ liệu có cấu trúc, chẳng hạn biến một prompt thành object recipe có kiểu dữ liệu rõ ràng bằng generateText() kết hợp Output.object().
- •Generative UI, nơi kết quả của một tool call — như ảnh vừa tạo — được render thành component React ngay trong luồng chat.
Các bước cài đặt
Bạn cần Node.js 22+ và npm, hoặc một package manager khác; README không nói rõ phiên bản npm tối thiểu. Chạy npm install ai để cài package lõi. Nếu muốn gọi trực tiếp một provider thay vì đi qua Vercel AI Gateway, cài thêm package của provider đó, ví dụ npm install @ai-sdk/openai @ai-sdk/anthropic @ai-sdk/google. Với các hook UI, cài riêng package của framework, ví dụ npm install @ai-sdk/react. README cũng gợi ý chạy npx skills add vercel/ai nếu bạn dùng coding agent như Claude Code hoặc Cursor.
Cách dùng chính
Gọi generateText({ model: 'openai/gpt-5.4', prompt }) để lấy một phản hồi text — chuỗi model này đi qua Vercel AI Gateway trừ khi bạn đã cài và import trực tiếp package provider. Thay bằng Output.object({ schema }) với một schema Zod để nhận lại object có kiểu dữ liệu thay vì văn xuôi, như ví dụ recipe trong README. Với agent, khởi tạo ToolLoopAgent với một model và một map tools, rồi truyền nó vào createAgentUIStreamResponse() bên trong route handler của Next.js để useChat() ở client component có thể stream cuộc hội thoại.
Điểm mạnh
- ✓Chỉ một chữ ký hàm (generateText, generateObject) dùng được cho cả OpenAI, Anthropic, Google và các provider khác — đổi model chỉ là đổi một chuỗi string, không phải viết lại code.
- ✓Các hook của AI SDK UI như useChat() không phụ thuộc framework, nên cùng một cách làm áp dụng được từ Next.js sang React, Svelte hay Vue.
- ✓Structured output qua Output.object() với schema Zod giúp TypeScript bắt lỗi sai định dạng dữ liệu ngay lúc biên dịch thay vì lúc chạy.
- ✓Lệnh cài npx skills add vercel/ai gắn thẳng một skill AI SDK vào các coding agent như Claude Code hay Cursor.
Những điều cần cân nhắc khi áp dụng
- △README không ghi rõ license, nên kiểm tra lại trực tiếp trên repo trước khi đưa vào codebase thương mại.
- △Mọi ví dụ trong README đều là TypeScript/JavaScript — không có tài liệu nào nói tới ngôn ngữ khác, nên công cụ này không giúp được cho backend Python hay Go.
- △Mặc định đi qua Vercel AI Gateway nghĩa là các lệnh gọi model của bạn chạy qua hạ tầng của Vercel, trừ khi bạn chủ động cài và cấu hình một package provider gọi trực tiếp.
- △Các ví dụ agent trong README (ToolLoopAgent, Vercel Sandbox) giả định bạn tự viết được vòng lặp gọi tool — không có trình dựng agent low-code nào ở đây.
So sánh với các công cụ phát triển AI khác
Câu hỏi thường gặp
Các hook UI của AI SDK hoạt động với Next.js, React, Svelte và Vue; tài liệu tổng quan của bộ công cụ còn liệt kê thêm Angular và Node.js như một runtime được hỗ trợ, theo README trên GitHub.
AI SDK kết nối sẵn với OpenAI, Anthropic và Google qua API thống nhất của mình, cộng thêm các provider khác được liệt kê trong tài liệu provider của Vercel; README nêu rõ tên ba provider này.
Vercel AI Gateway là lớp định tuyến mặc định mà AI SDK dùng để gọi tới các provider model — chỉ cần truyền một chuỗi model như 'anthropic/claude-opus-4.6' là gateway lo phần còn lại, không cần cài riêng package provider.
AI SDK hỗ trợ tạo dữ liệu có cấu trúc qua hàm Output.object(), kết hợp generateText() với một schema Zod để phản hồi trả về là một object có kiểu dữ liệu rõ ràng — ví dụ trong README tạo ra một recipe gồm tên, danh sách nguyên liệu và các bước làm.
AI SDK cung cấp class ToolLoopAgent để gắn các tool — như một trình thực thi lệnh shell hay công cụ tạo ảnh — vào một vòng lặp do SDK quản lý, còn createAgentUIStreamResponse() stream output của agent đó thẳng vào một route API trong Next.js.
Template của AI SDK là các dự án khởi điểm, theo README, đã tích hợp sẵn AI SDK cho từng use case, provider và framework cụ thể, giúp bạn có một setup chạy được ngay thay vì bắt đầu từ con số không.
Vấn đề mà AI SDK giải quyết
Mỗi nhà cung cấp LLM đi kèm SDK riêng, với format request, cách stream và cú pháp gọi tool khác nhau, nên một ứng dụng Next.js muốn cho người dùng chọn giữa model của OpenAI và Anthropic sẽ phải duy trì hai đường tích hợp song song và viết lại logic stream cho giao diện chat với từng bên. AI SDK gộp tất cả vào một bề mặt generateText()/useChat() duy nhất, nên đổi provider chỉ còn là đổi một chuỗi model thay vì viết lại code.
Nên dùng AI SDK khi nào — và khi nào nên bỏ qua
Nên dùng AI SDK nếu bạn đang xây ứng dụng TypeScript — Next.js, React, Svelte hoặc Vue — và muốn đổi qua lại giữa model của OpenAI, Anthropic và Google mà không phải viết lại code tích hợp mỗi lần đổi. Nên bỏ qua nếu backend của bạn không dùng TypeScript/JavaScript, vì mọi ví dụ trong README đều giả định stack đó, hoặc nếu bạn muốn một trình dựng agent trực quan, low-code thay vì tự tay viết ToolLoopAgent.