شرح محوّل Grok Build في Vercel AI SDK

في 13 أغسطس 2026، أتاحت Vercel مسارًا رسميًا لتشغيل Grok Build عبر HarnessAgent في Vercel AI SDK 7. وبذلك يستطيع أي منتج استخدام Grok Build من خلال واجهة التطبيق نفسها التي تتيحها Vercel الآن لـ9 بيئات مدعومة لوكلاء البرمجة، من دون إعادة بناء طبقة التنسيق حول كل بيئة.

ماذا أضافت Vercel فعليًا إلى Vercel AI SDK؟

هذا إصدار لمحوّل، وليس نموذجًا جديدًا من Grok.

أسهل طريقة لفهمه هي الفصل بين طبقاته. النموذج يولّد الاستجابات. أما بيئة وكيل البرمجة فتحوّل النموذج إلى عامل ينفّذ المهام، إذ تدير الملفات والأدوات والجلسات والأذونات والحلقة التي تُبقي المهمة مستمرة. ويشكّل Agent Client Protocol، أو ACP، اللغة المشتركة بين العميل وبيئة متوافقة معه. ثم يأتي المحوّل ليترجم ذلك البروتوكول إلى الواجهة التي يعرفها تطبيقك أصلًا.

حزمة Vercel الجديدة هي @ai-sdk/harness-grok-build. وهي تصل HarnessAgent بواجهة Grok Build CLI عبر ACP، مع الاعتماد في الطبقة الأدنى على حزمة @ai-sdk/harness-acp.

لذلك يبدو المسار هكذا:

تطبيقك → HarnessAgent → محوّل Grok Build → Grok Build CLI داخل بيئة معزولة

طبقة ACP العامة هي البنية التحتية للاتصال. أما محوّل Grok Build فهو الموصل الجاهز الذي يعرّف مسبقًا الحزمة والملف التنفيذي وربط المصادقة وأمر التشغيل وربط الأدوات. وللتعمق في آلية البروتوكول، راجع شرح محوّل ACP لبيئات الوكلاء في AI SDK. هنا ينصب التركيز على مسار Grok Build الجاهز للاستخدام.

قبل هذا الإصدار، كانت إضافة بيئة تشغيل متوافقة مع ACP تتطلب منك إعداد ملف تعريفها بنفسك. إطلاق Grok Build في 13 أغسطس منحه محوّلًا رسميًا وأدخله في دورة جلسات HarnessAgent نفسها المستخدمة مع Claude Code وCodex وDeep Agents وOpenCode وPi، ليصل العدد حينها إلى 6 بيئات.

ومنذ 31 أغسطس 2026، رفعت إضافة fx من Vercel العدد المدعوم إلى 9 بيئات: Claude Code وCline وCodex وCursor وDeep Agents وfx وGrok Build وOpenCode وPi. يوسّع محوّل fx قائمة الخيارات، لكنه لا يغيّر طريقة عمل محوّل Grok Build.

عبارة «الواجهة نفسها» أهم من «الوكيل نفسه». يمكنك الاحتفاظ بعقد التطبيق كما هو، لكنك لن تحصل بالضرورة على سلوك أدوات أو أذونات أو قابلية مراقبة أو مخرجات نماذج متطابقة عبر البيئات الـ9 المدعومة.

لماذا يهم هذا التكامل؟

ما تغيّر هنا هو حجم العمل اللازم للتكامل.

تعيد الدالتان HarnessAgent.generate() وHarnessAgent.stream() نتائج متوافقة مع AI SDK. فإذا كان منتجك يملك أصلًا واجهة محادثة أو مهام مبنية على AI SDK، يمكن وضع Grok Build خلف مسار النتائج القائم نفسه. تتغيّر بيئة الوكيل على الخادم، فيما لا تحتاج واجهة المستخدم إلى صيغة استجابة جديدة لمجرد تغيّر العامل المنفّذ.

يمنح ذلك فرق المنصات طريقة أنظف لمقارنة بيئات التشغيل أو توجيه أنواع مختلفة من المهام. يستطيع الفريق الإبقاء على دورة موحّدة للجلسات وبنية بث واحدة، ثم اختيار البيئة الأنسب لكل مهمة.

لا يجعل هذا الإصدار Grok Build أسرع أو أقل تكلفة أو أدق. ما يضيفه هو اتصال مدعوم. كما أنه لا يفيد من يستخدم Grok Build عبر واجهته الطرفية وحدها؛ بل يستهدف من يبني منتجًا أو نظامًا داخليًا حول وكلاء البرمجة.

من يمكنه الاستفادة منه غدًا؟

مؤسس شركة لأدوات المطورين يريد إضافة بيئة تشغيل

لنفترض أنك تبيع منتجًا لمراجعة الشفرة بالذكاء الاصطناعي أو إصلاح المستودعات، وقد بنيته على AI SDK. يمكنك إضافة Grok Build بوصفه بيئة أخرى تعمل على الخادم، من دون إنشاء واجهة مستقلة للجلسات وعقد بث منفصل لها.

الخطوة العملية محدودة: تثبيت المحوّل، وإرفاق النوع نفسه من البيئة المعزولة، ثم اختيار Grok Build عندما يتطلبه العميل أو المهمة. والنتيجة هي خيار تشغيل إضافي من دون واجهة منتج أخرى تحتاج إلى صيانة.

مهندس منصات يقارن بين 9 بيئات للوكلاء

يمكن لفريق منصات تمرير مهمة محددة النطاق داخل مستودع إلى Grok Build وإلى بيئة مدعومة أخرى، ثم مقارنة جودة الإنجاز وسلوك الإخفاق ضمن مسار تطبيق مشترك.

لكن يجب أن تظل المقارنة منصفة. لا يعرض ACP الإصدار 1 دائمًا بيانات الاستخدام لكل خطوة، لذلك لا يستطيع هذا المحوّل منحك مقارنة دقيقة للتكلفة على مستوى كل token عندما لا يعيد Grok الإجماليات. يمكنك مقارنة النتائج والسلوك من البداية إلى النهاية، لكن لا يصح افتراض اكتمال جميع حقول المراقبة بالقدر نفسه.

فريق أدوات داخلية يصلح المستودعات

يستطيع فريق الأدوات الداخلية إرسال مهمة لإصلاح اختبار فاشل إلى مساحة عمل معزولة، وبث نص الوكيل إلى المشغّل، ثم إنهاء الجلسة عند انتهاء المهمة. تحمي حدود البيئة المعزولة النظام المضيف، فيما تمنع دورة التشغيل الصريحة تحوّل الجلسات المؤقتة إلى بنية تحتية منسية.

المكسب هنا هو التحكم التشغيلي. يعمل الوكيل الذي يغيّر الشفرة داخل نطاق محكوم، ويقرر التطبيق متى تبدأ تلك البيئة ومتى تنتهي.

مسؤول أمن أو موثوقية يراجع الإطلاق

أمام هذا المسؤول قرار فعلي. تستخدم المصادقة المباشرة XAI_API_KEY، بينما تعتمد المصادقة عبر AI Gateway بيانات اعتماد Gateway. ويختار وضع auto الافتراضي AI Gateway عند توافر بيانات اعتماده، وإلا ينتقل إلى المصادقة المباشرة مع xAI.

وعليه أيضًا اختبار الأذونات عند الحد الفعلي للأداة. لا يعلن Grok Build عن أوضاع جلسات ACP، وقد تُنفَّذ بعض الأعمال المدمجة الآمنة من دون طلب إذن عبر ACP. لذلك لا تُثبت سياسة كُتبت لبيئة أخرى أن Grok Build سيتصرف بالطريقة ذاتها.

تشغيل المسار الموثّق

يعتمد أقصر إعداد متكامل على Vercel Sandbox والإعدادات الافتراضية للمحوّل.

1. 1

   تثبيت الحزم

   أضف واجهة بيئات الوكلاء المشتركة ومحوّل Grok Build وتنفيذ Vercel Sandbox:

   pnpm add @ai-sdk/harness @ai-sdk/harness-grok-build @ai-sdk/sandbox-vercel

2. 2

   توفير بيانات اعتماد البيئة المعزولة والنموذج

   في مسار Vercel Sandbox الموثّق، اجعل VERCEL_OIDC_TOKEN متاحًا. وللمصادقة المباشرة مع Grok، وفّر XAI_API_KEY. أما مسار Gateway فيحتاج إلى بيانات اعتماد AI Gateway المناسبة؛ ويمكن استخدام AI_GATEWAY_BASE_URL عندما يستلزم ذلك المسار تجاوز عنوان URL الأساسي. يختار الإعداد الافتراضي auth: 'auto' المسار المتاح.

3. 3

   إنشاء الجلسة وتشغيلها ثم إنهاؤها

   استخدم مثال بيئة Grok Build الحالي:

   import { HarnessAgent } from '@ai-sdk/harness/agent';
   import { grokBuild } from '@ai-sdk/harness-grok-build';
   import { createVercelSandbox } from '@ai-sdk/sandbox-vercel';
   
   const agent = new HarnessAgent({
     harness: grokBuild,
     model: 'grok-build-0.1',
     sandbox: createVercelSandbox({
       runtime: 'node24',
       ports: [4000],
     }),
   });
   
   const session = await agent.createSession();
   
   let exitCode = 0;
   try {
     const result = await agent.stream({
       session,
       prompt: 'Check the test failures and fix the production code.',
     });
   
     for await (const part of result.stream) {
       if (part.type === 'text-delta') {
         process.stdout.write(part.text);
       }
     }
   } catch (err) {
     exitCode = 1;
     console.error(err);
   } finally {
     await session.destroy();
     process.exit(exitCode);
   }

4. 4

   توقّع تثبيتًا عبر الشبكة في الجلسة الأولى

   تحتاج الجلسة الأولى إلى اتصال خارجي بالشبكة لأن بيئة ACP تثبّت حزمة @xai-official/grok@1.0.5 المثبّتة الإصدار داخل البيئة المعزولة. إذا كانت البيئة بلا اتصال صادر، فستفشل قبل أن يبدأ الوكيل أي عمل مفيد.

التفصيل الذي قد يغيب عن كثيرين هو المنفذ. يحتاج Grok Build إلى بيئة شبكية معزولة فيها منفذ مكشوف واحد على الأقل لجسر ACP. يستخدم المثال Node 24 والمنفذ 4000. أما كائن البيئة المعزولة الذي لا يوفّر ذلك المسار الشبكي، فلا يُعد إعدادًا مكافئًا.

يمرّر المثال الحالي model: 'grok-build-0.1' إلى HarnessAgent. وإذا احتجت إلى تحكم على مستوى المحوّل، فاستبدل grokBuild بـcreateGrokBuild(). يمكنك اختيار أسلوب المصادقة وتمرير بيانات الاعتماد ومستوى الاستدلال وخوادم MCP ومنفذ الجسر ومهلة بدء التشغيل، أو توفير دالة مخصّصة لرمز الجسر. وإذا حذفت reasoningEffort، يستخدم Grok Build إعداده الافتراضي.

القيود التي ينبغي معرفتها

يرث المحوّل قيود ACP الإصدار 1، ولهذه القيود أثر حقيقي في بيئات الإنتاج.

• بيانات الاستخدام غير مكتملة. لا يعرض ACP حدود خطوات النموذج ولا بيانات الاستخدام لكل خطوة. يستنتج المحوّل تلك الحدود ويبلّغ عن استخدام غير معروف عندما لا يقدّم Grok الإجماليات.
• لا يمكن توجيه دورة جارية بطريقة موحّدة. لا يوفّر ACP واجهة مشتركة للتوجيه في منتصف الدورة أو لضغط السياق يدويًا.
• تصفية الأدوات المدمجة محدودة. يمكنك تصفية أدوات المضيف، لكن محاولة تصفية أدوات Grok المدمجة تُطلق خطأ يفيد بعدم دعم هذه الإمكانية.
• قد تصبح قوائم الأدوات قديمة. عندما تتغير قائمة أدوات المضيف، يجب أن يحدّث Grok Build قائمة ACP MCP الخاصة به. وإذا احتفظ بالقائمة القديمة، تفشل الدورة صراحةً.

هناك أيضًا مخاطرة مرتبطة بإدارة الإصدارات. حزم بيئات الوكلاء في AI SDK تجريبية، ولذلك يُتوقع ظهور تغييرات كاسرة بين الإصدارات. يثبّت محوّل Grok داخليًا إصدار CLI وأمر تشغيل ACP، ولا تتيح لك createGrokBuild() تجاوز هذه التفاصيل. يجعل ذلك المسار المدعوم أبسط، لكنه يعني أيضًا أن حزمة المحوّل هي التي تتحكم في توقيت تغيير بيئة التشغيل المثبّتة.

بيانات اعتماد الجسر الافتراضية هي رمز عشوائي بطول 32 بايت. وإذا استبدلت دالة إنشاء الرمز، فيجب أن تعيد الدالة البديلة قيمة سرية فعلًا. هذا إجراء أمني، وليس موضعًا مناسبًا لاستخدام نص تطوير سهل القراءة.

وأخيرًا، ليس هذا إعلانًا عن تسعير جديد. تظل لطريقة مصادقة Grok والبيئة الشبكية المعزولة تكاليف تشغيل خاصة بكل منهما. يقلّل المحوّل أعمال التكامل المخصّصة، لكنه لا يلغي البنية التحتية التي يعتمد عليها.

ما الذي ينبغي فعله الآن؟

ابدأ هذا الأسبوع إذا كنت تستخدم AI SDK 7 بالفعل وتريد إتاحة Grok Build كبيئة برمجة قابلة للاختيار. ابدأ بمهمة محددة النطاق داخل مستودع، وحافظ على إعدادات المحوّل الافتراضية، واختبر مساري النجاح والإخفاق، ثم تحقق من إنهاء الجلسة.

إذا كنت تحتاج إلى عدة بيئات خلف منتج واحد، فأجرِ تقييمًا قصيرًا قبل الانتقال إلى الإنتاج. قارن نتائج المهام وسلوك الأذونات والتعافي من الإخفاق والتكلفة الإجمالية للمهمة. ولا تجعل الاستخدام لكل خطوة معيار الحسم، لأن ACP قد لا يوفّره.

انتظر إذا كان ضغط السياق يدويًا أو التوجيه في منتصف الدورة أو القياس الدقيق لكل خطوة أو قوائم السماح للأدوات المدمجة من متطلباتك. هذه فجوات في البروتوكول وليست أخطاء في الإعداد.

لن يتغير شيء بالنسبة إليك إذا كنت تستخدم Grok Build مباشرة، أو تستدعي نماذج Grok من دون بيئة لوكيل برمجة، أو لا تملك تطبيقًا يحتاج إلى التبديل بين بيئات الوكلاء.

للمزيد من الشروحات العملية عن الأدوات التي تغيّر طريقة إنجاز الفرق لمنتجاتها، اشترك في النشرة البريدية.