Vercel AI SDK

تُعد Vercel AI SDK مكتبة TypeScript مفتوحة المصدر طورتها Vercel، الشركة المطورة لـ Next.js، لبناء تطبيقات متكاملة (full-stack) ووكلاء مستقلين مدعومين بالذكاء الاصطناعي. تم إصدارها بموجب ترخيص Apache 2.0، وهي تلغي الحاجة إلى تعلم واجهة برمجة التطبيقات (API) الخاصة بكل مزود من خلال توفير واجهة واحدة ومتسقة لتوليد النصوص، وإخراج الكائنات المنظمة، واستدعاء الأدوات، وتوليد الصور، والصوت، والتضمينات (embeddings)، وبث واجهة المستخدم عبر OpenAI و Anthropic و Google و Mistral و Amazon Bedrock وأكثر من 15 مزودًا آخر. وصلت حزمة SDK إلى الإصدار 6 في أكتوبر 2025، بعد إطلاق الإصدار v5 في يوليو 2025، واعتبارًا من أبريل 2026، سجلت أكثر من 20 مليون تنزيل شهريًا من أكثر من 95,000 مشروع يعتمد عليها.

تأتي حزمة SDK في جزأين: AI SDK Core و AI SDK UI. يغطي Core الأساسيات من جانب الخادم، بما في ذلك generateText و generateObject (مع تكامل مخطط Zod للحصول على مخرجات منظمة وآمنة من حيث النوع)، و streamText، و streamObject، واستدعاء الأدوات مع حلقات متعددة الخطوات، وتوليد الصور وتحريرها، وإعادة الترتيب (reranking)، وتجريد رسمي للوكيل (Agent) تم تقديمه في الإصدار v6. توفر AI SDK UI خطافات (hooks) مستقلة عن إطار العمل (useChat، useCompletion، useAssistant) مع تكافؤ كامل في الميزات عبر React و Next.js و Vue و Svelte و Angular. يضيف المنتج المرافق الاختياري، Vercel AI Gateway (الذي تم إطلاقه في أغسطس 2025)، توجيهًا موحدًا عبر مئات النماذج مع زمن انتقال إضافي يقل عن 20ms، وتجاوز تلقائي للفشل، وبدون أي زيادة في الأسعار عن أسعار المزودين. كل هذا مجاني ومفتوح المصدر؛ حيث تدفع فقط مقابل رموز API الخاصة بالمزود التي تستخدمها.

ما الذي تفعله Vercel AI SDK فعليًا في أبريل 2026

اعتبارًا من الإصدار v6، تم بناء الحلقة الأساسية لحزمة SDK حول ثلاثة أنماط. النمط الأول هو التوليد باستدعاء واحد: يأخذ generateText أو streamText مرجعًا للنموذج، وموجهًا (prompt) أو مصفوفة رسائل، وأدوات اختيارية، ثم يُرجع استجابة محددة النوع. التبديل من GPT-4o إلى Claude Sonnet 3.7 يعني تغيير استيراد (import) واحد؛ ويبقى باقي الاستدعاء متطابقًا. النمط الثاني هو الاستخراج المنظم: يقبل generateObject مخطط Zod ويُرجع كائنًا محدد النوع بالكامل، حيث تتعامل حزمة SDK مع تحويل المخطط إلى موجه وتحليل الاستجابة تلقائيًا. النمط الثالث هو تجريد الوكيل (Agent): تقوم بتعريف وكيل مرة واحدة مع نموذجه، وتعليمات النظام، والأدوات، وتكوين الذاكرة، ثم تقوم بإنشاء مثيل له في أي مكان في التطبيق. يتحكم المعلمة stopWhen في وقت خروج حلقة استدعاء الأداة، ليحل محل نمط maxSteps المخصص من الإصدارات السابقة.

تجاوز إصدار v5 في يوليو 2025 حاجز 2 مليون تنزيل أسبوعيًا وقدم توليد الصوت ونسخه، والأدوات الديناميكية التي يمكن للنموذج تحديدها في وقت التشغيل، والتكافؤ الكامل لـ Vue و Svelte مع React، وميزة المزود العالمي التي تتيح لك معالجة أي نموذج بواسطة معرف نصي بسيط من خلال AI Gateway. أضفى إصدار v6 في أكتوبر 2025 طابعًا رسميًا على فئة الوكيل (Agent)، وأضاف الموافقة على الأدوات لسير عمل التدخل البشري (human-in-the-loop)، وأطلق DevTools لتصحيح أخطاء استدعاءات LLM وتتبعات الوكيل داخل المتصفح، ووسع توليد الصور لقبول الصور المرجعية للتحرير، وأضاف إعادة الترتيب الأصلية عبر وظيفة rerank. كما وصل الدعم الكامل لـ MCP (Model Context Protocol) في الإصدار v6، ليغطي OAuth، والموارد، والموجهات.

"تُعد AI SDK التجريد المثالي الوحيد الذي رأيته حتى الآن. يواصل الإصدار v5 هذا السجل الحافل. كل شيء يبدو في مكانه الصحيح." - Ben Hylak، raindrop.ai، منشور إطلاق Vercel AI SDK 5، 31 يوليو 2025

يشمل أكثر من 20 مزودًا للنماذج OpenAI (GPT-4o، GPT-5، o1/o3)، و Anthropic (Claude 3.5/3.7 Sonnet، Claude Opus)، و Google (Gemini 2.0/2.5 Flash، Gemini Pro)، و Meta Llama (عبر Groq أو Bedrock)، و Mistral، و Cohere، و xAI Grok، و Amazon Bedrock. تختلف قدرات المزودين: لا يدعم كل مزود كل ميزة (استخدام الكمبيوتر، إدخال PDF، التضمينات، تحرير الصور)، وتوثق حزمة SDK جداول قدرات كل مزود لمساعدة المطورين على التنقل في ذلك. يُعد تبديل المزودين في منتصف المشروع أقوى نقطة بيع لحزمة SDK؛ حيث أعادت Thomson Reuters بناء منتجها CoCounsel باستخدام AI SDK مع 3 مطورين فقط في شهرين، مما أدى إلى دمج 10 تكاملات منفصلة للمزودين في نظام واحد يخدم الآن 1,300 شركة محاسبة.

موقع Vercel AI SDK مقارنةً بـ LangChain JS و Mastra

تُعد LangChain JS نقطة المقارنة الأكثر مباشرة لمطوري JavaScript. يبلغ حجم حزمة LangChain المضغوطة 101.2 kB مقابل 67.5 kB لحزمة AI SDK، وتعتمد على واجهات برمجة تطبيقات نظام ملفات Node.js التي تجعلها غير متوافقة مع بيئات تشغيل الحافة (edge runtimes). تكمن نقاط قوة LangChain في البنية التحتية لـ RAG: فهي توفر محملات المستندات، ومستردات مخازن المتجهات (vector store retrievers)، وبنى الوكلاء المبنية مسبقًا (ReAct، Plan-and-Execute) التي لا توفرها AI SDK. بينما تكمن نقاط قوة AI SDK في تكامل واجهة المستخدم، والتوافق مع الحافة، وخطافات البث، والبساطة المطلقة: المهمة التي تتطلب إنشاء مصفوفة رسائل متعددة الخطوات في LangChain هي استدعاء generateText واحد في AI SDK. في المعايير المقارنة، بلغ متوسط زمن الانتقال لـ LangChain حوالي 50ms p99 مقابل 30ms لـ AI SDK. بالنسبة للفرق التي تبني واجهات مستخدم للدردشة باستخدام Next.js، تتفوق AI SDK في كل بُعد تقريبًا. أما بالنسبة للفرق التي تبني مسارات RAG معقدة قريبة من Python أو استرجاع متعدد المتجهات، فإن LangChain هي نقطة البداية الأفضل.

تشغل Mastra مسارًا مختلفًا. إنها إطار عمل وكيل TypeScript مع مسارات عمل متينة، وذاكرة رصد مدمجة (سجلت 94.87% على LongMemEval دون الحاجة إلى قاعدة بيانات متجهات)، ومصحح أخطاء Studio مرئي لإعادة تشغيل عمليات الوكيل، وبنية تنسيق سلسة (.then/.parallel/.branch/.foreach). لا توفر Mastra خطافات واجهة مستخدم للبث؛ إنها مكتبة بنية تحتية للوكيل من جانب الخادم، وليست حزمة SDK متكاملة. تغطي AI SDK مساحة أكبر (من useChat في React وصولاً إلى استدعاءات المزود) ولكنها تقدم ذاكرة وتنسيق مسار عمل أقل تقييدًا. تجمع الفرق أحيانًا بين الاثنين: Mastra لطبقة الوكيل والاستمرارية، و AI SDK لطبقة واجهة مستخدم البث. تحظى Mastra بحوالي 300K تنزيل أسبوعيًا مقابل أكثر من 20M شهريًا لـ AI SDK، مما يعكس جمهورًا أكثر تخصصًا. تُعد LiteLLM نقطة مرجعية ثالثة: فهي تعمل كطبقة وكيل (proxy) للمزود بدلاً من مكتبة تطبيقات، ولا تحتوي على تكامل للواجهة الأمامية، وهي موجهة بشكل أساسي نحو Python. غالبًا ما تعمل كبوابة خلفية تستدعيها تطبيقات Vercel AI SDK من خلالها.

"الانتقال من streamText إلى الوكلاء القابلين للتركيب هو خطوة أنيقة.. حجم العناية التي وضعها الفريق في تصميم واجهة برمجة التطبيقات مذهل." - Josh، Upstash، مدونة Vercel AI SDK 6، أكتوبر 2025

كيف تبدو تجربة التطوير اليومية

نقطة البداية القياسية لمعظم الفرق هي مشروع Next.js App Router. تقوم بتثبيت ai وحزمة مزود (@ai-sdk/openai، @ai-sdk/anthropic، إلخ)، وإنشاء معالج مسار (route handler) يستدعي streamText ويُرجع StreamingTextResponse، ثم تستخدم خطاف useChat على العميل. يدير الخطاف سجل الرسائل، وحالة الإدخال، وتسلسل البث، ومعالجة الأخطاء، وإرسال النموذج. تُبلغ الفرق باستمرار عن الانتقال من مستودع فارغ إلى روبوت دردشة بث يعمل في أقل من 30 دقيقة.

مسار الإخراج المنظم نظيف بنفس القدر. يقبل generateObject تعريف مخطط Zod ويُرجع كائن TypeScript محدد النوع، مع معالجة جميع هندسة الموجهات للالتزام بالمخطط بواسطة طبقة SDK. هذا يجعله النهج المفضل لاستخراج البيانات، والتصنيف، وأي مهمة تحتاج فيها إلى شكل إخراج موثوق. في تجريد الوكيل للإصدار v6، تقوم بتعريف وكيل قابل لإعادة الاستخدام مع نموذج، وتعليمات، وأدوات، وإعدادات ذاكرة اختيارية، ثم تستدعي agent.generate() أو agent.stream() أينما دعت الحاجة في التطبيق. تتراكب لوحة DevTools، الجديدة في الإصدار v6، في المتصفح أثناء التطوير وتعرض كل استدعاء LLM، واستدعاء أداة، واستخدام الرموز (tokens)، وزمن الانتقال في عرض جدول زمني، مما يقلل بشكل كبير من دورة تصحيح الأخطاء للتدفقات متعددة الخطوات.

بالنسبة للفرق التي تنشر خارج Vercel، تعمل حزمة SDK على أي خادم Node.js، أو بيئة تشغيل الحافة، أو Cloudflare Workers، أو AWS Lambda، أو حاوية Docker. تُعد Vercel AI Gateway اختيارية؛ يمكنك استخدام حزمة SDK بالكامل مع مفاتيح API المباشرة للمزود. يستخدم منتج v0 by Vercel حزمة AI SDK داخليًا لميزات توليد واجهة المستخدم الخاصة به، وهو أمر يستحق المعرفة إذا كنت ترغب في فهم كيف تستخدم Vercel مكتبتها الخاصة (dog-fooding). تُعد OpenAI Agents SDK أداة مشابهة من الناحية المفاهيمية تقتصر على مزودي OpenAI، وهي مفيدة للمقارنة عند تقييم ما إذا كان التقيد بمزود واحد (provider lock-in) يهم حزمة التقنيات الخاصة بك.

لمن تم بناء Vercel AI SDK

الجمهور الأساسي هو مطورو TypeScript و JavaScript الذين يبنون تطبيقات ويب بميزات الذكاء الاصطناعي. تُعد حزمة SDK مناسبة بشكل خاص لمطوري React و Next.js الذين يريدون واجهات مستخدم للدردشة بالبث المباشر، حيث يجرد خطاف useChat كل البنية التحتية للحالة التي يصبح من الممل كتابتها من الصفر. كما أنها تناسب الفرق التي تحتاج إلى شحن ميزات الذكاء الاصطناعي بسرعة وتتوقع التكرار في خيارات النماذج: واجهة برمجة التطبيقات المستقلة عن المزود تجعل من السهل إجراء اختبار A/B لـ GPT-4o مقابل Claude Sonnet أو إدراج نموذج أرخص للمسارات غير الحرجة دون إعادة هيكلة مواقع الاستدعاء. تشير الشركات الناشئة والوكالات التي تبني مشاريع العملاء مرارًا وتكرارًا إلى حزمة SDK كنقطة انطلاق افتراضية لها لأن الوقت المستغرق للوصول إلى عرض توضيحي يعمل يكون سريعًا باستمرار.

تحصل فرق المؤسسات التي تعتمد تطوير TypeScript أولاً على أكبر قدر من الاستفادة على المدى الطويل: أمان النوع (type safety) من البداية إلى النهاية عبر مدخلات ومخرجات استدعاء الأداة، وتوليد الكائنات المنظمة المرتبطة مباشرة بمخططات Zod، والقدرة على مركزية تكوين المزود وتتبع التكاليف من خلال AI Gateway. تُعد حالة Thomson Reuters (3 مطورين، شهران، ذكاء اصطناعي قانوني على مستوى الإنتاج عبر 1,300 شركة) المثال الأكثر استشهادًا به لما يمكن لفريق مركز أن يبنيه عندما لا تكون طبقة تجريد المزود هي عنق الزجاجة.

ما لا تقدمه Vercel AI SDK

حزمة SDK مخصصة لـ TypeScript فقط. لن تجد فرق Python أي مكافئ من الطرف الأول ويجب أن تنظر إلى LangChain Python أو LlamaIndex أو حزمة Python SDK الخاصة بـ Genkit بدلاً من ذلك.

حزمة SDK ليست إطار عمل RAG. لا تحتوي على محملات مستندات مدمجة، أو أدوات تقسيم (chunking)، أو مستردات مخازن متجهات. ستحتاج الفرق التي تبني مسارات استرجاع قاعدة المعرفة إلى إضافة هذه المكونات بشكل منفصل (LlamaIndex.TS، أو أساسيات RAG الخاصة بـ Mastra، أو حزمة SDK لقاعدة بيانات متجهات). يمتلك نظام LangChain JS البيئي بنية تحتية لـ RAG ذات وزن أثقل إذا كان مسار الاسترجاع هو التحدي الهندسي الأساسي.

كما أن حزمة SDK ليست بيئة تشغيل وكيل طويلة الأمد. عند نشرها على استضافة Vercel الخاصة، يكون لمعالجات المسار (route handlers) حد أقصى لوقت التنفيذ (15 ثانية افتراضيًا، 300 ثانية في Pro) مما يقيد الوكلاء المستقلين الذين يقومون بأبحاث تكرارية أو تخطيط متعدد الخطوات. تحتاج الفرق التي تشغل وكلاء يتطلبون دقائق من وقت التنفيذ إلى النشر على بنية تحتية بدون هذه القيود، سواء كان ذلك يعني Node مستضاف ذاتيًا، أو Cloudflare Workers مع Durable Objects، أو منصة تنفيذ وكيل مخصصة. حادثة RSC في أكتوبر 2024 تستحق المعرفة: أطلقت Vercel بث Generative UI / React Server Components كميزة رئيسية في SDK 3.0 في مارس 2024، وجذبت التبني، ثم أوقفت التطوير بعد 7 أشهر مشيرة إلى "قيود طويلة الأمد.. بدون حلول جيدة على المدى القريب." هذا النمط من الميزات الطموحة المقترنة بالمنصة والتي تصطدم بجدران معمارية جعل بعض الفرق حذرة بشأن البناء على ميزات SDK التجريبية.

يُعد حجم الحزمة مصدر قلق مشروع للتطبيقات المحسنة للحافة (edge-optimized). عند 186 kB لطلب OpenAI واحد مقابل 87 kB لمكتبة OpenAI الرسمية وحدها، تحمل حزمة SDK عبئًا إضافيًا يهم في زمن انتقال التشغيل البارد (cold-start latency) أو ميزانيات الحافة المقيدة. قد يفضل المطورون الذين يحتاجون إلى الحد الأدنى المطلق من البصمة كتابة استدعاءات المزود المباشرة.