← جميع المقالات

Code Mode: كيف يستدعي وكيل الذكاء الاصطناعي الأدوات عبر الشيفرة المولَّدة

Code Mode: كيف يستدعي وكيل الذكاء الاصطناعي الأدوات عبر الشيفرة المولَّدة

فحص أيّ الحزم من عشرات الحزم في monorepo يعتمد على حزمة معيّنة مهمة روتينية يُسلَّمها الناس إلى وكلاء الذكاء الاصطناعي. في شرح فيديو نُشر في 14 أكتوبر 2026 يُعرض وضع جديد في الوكيل Pi 1.0 اسمه Code Mode: يكتب النموذج أولًا شيفرة JavaScript صغيرة، ثم تنفّذ هذه الشيفرة استدعاءات الأدوات بنفسها داخل صندوق حماية QuickJS وتعيد إلى النموذج النتيجة النهائية فقط. في الاختبار أدّى النهجان — الاستدعاء المتدرّج للأدوات وCode Mode — العدد نفسه بالضبط من الاستدعاءات (18 استدعاء: تشغيل bash واحد و17 قراءة ملف) ووجدا الحزمتين نفسهما ذات التبعية المباشرة. الفرق ليس في النتيجة بل في الطريق: في الوضع العادي اضطر النموذج إلى ابتلاع قوائم الملفات ومحتوياتها، أما في Code Mode فرأى الملخّص النهائي فقط.

أين يهدر الاستدعاء المتدرّج الرموز

تعمل حلقة الوكيل الكلاسيكية هكذا: يقرّر النموذج استدعاء أداة، تعيد المنصة النتيجة، يقرّر النموذج الاستدعاء التالي — وهكذا حتى الجواب النهائي. في المهام الجماعية هذا مكلف: ليجد الحزم التابعة يقرأ الوكيل عشرات الملفات، ويمرّ كل محتواها عبر سياق النموذج. كل نتيجة وسيطة تكلف رموزًا ووقتًا ومالًا، بينما العمل المفيد فيها غالبًا واحد بالمئة: النموذج لا يحتاج الملف نفسه، بل الجواب عن سؤال «هل تُذكر الحزمة X هنا».

Песочница выполняет сгенерированный код вместо модели

ما الذي يغيّره Code Mode

يقلب Code Mode الحلقة رأسًا على عقب. يكتب النموذج برنامج JavaScript مرة واحدة، تكون فيه استدعاءات الأدوات دوالّ عادية. ثم يعمل الشيفرة بدل النموذج: داخل صندوق QuickJS تقرأ الملفات بالتوازي، وتحلّل JSON، وتصفّي البيانات وتجمّعها — وتعيد إلى النموذج ملخّصًا مضغوطًا فقط. في الاختبار أدّى النهجان المجموعة نفسها من الاستدعاءات، لكن في Code Mode تمّت القراءات الـ17 كلها داخل الصندوق بالتوازي، ووصل إلى النموذج ملخّص وحيد: حزمتان بتبعية مباشرة. رموز أقل في السياق، وزمن أقل، واحتمال أضيق أن يفقد النموذج تفصيلًا في تيار البيانات الوسيطة.

كيف تكرّر ذلك عندك

  • اجعل أدوات الوكيل دوالّ قابلة للاستدعاء من الشيفرة، لا مجرد مخططات JSON للاستدعاء المتدرّج.
  • أضف إلى موجه النظام قاعدة: في المهام الجماعية — «اكتب أولًا شيفرة تستدعي الأدوات وتعيد ملخّصًا»؛ واترك الاستدعاء المتدرّج للأفعال المفردة.
  • نفّذ الشيفرة المولَّدة داخل صندوق حماية معزول (مثل محرّك QuickJS) بحدّ زمني ودون وصول إلى الشبكة أو نظام الملفات عدا دوالّ الأدوات الممنوحة صراحة.
  • أعد إلى النموذج نتيجة مهيكلة وسجلّ التنفيذ، لا البيانات الخام: من السجل يستطيع النموذج إصلاح الشيفرة إذا انهارت.

متى يكون مجديًا ومتى لا يكون

يتفوّق Code Mode حيث تكثر الاستدعاءات المتشابهة: تصفية مئات السجلات، والتجميع، وعبور أشجار التبعيات، ومطابقة القوائم الكبيرة. أما الاستدعاءات المفردة — «اقرأ ملفًا واحدًا»، «أرسل رسالة واحدة» — فالفرق فيها شبه معدوم، والشيفرة تضيف طبقة زائدة. وفخّ منفصل هو معالجة الأخطاء: يجب أن تصمد الشيفرة المولَّدة أمام فشل الأداة وتعيد المحاولة، وإلا أسقطت مهمة جماعية كاملة بسبب خلل واحد.

لماذا إعادة المحاولة إلزامية: أرقامنا

الفشل جزء طبيعي من أي حمل توليدي، ومن واجب المنسّق الشيفري أن يصمد أمامه. بحسب تجميعات مجهّلة من قاعدة الإنتاج لخدمتنا (بلا نصوص موجّهات ولا معرّفات)، خلال 30 يومًا من 4 سبتمبر إلى 4 أكتوبر 2026 مرّت عبر المنصة 12 689 عملية توليد: 9 907 صورًا و2 334 فيديو و448 مقطعًا موسيقيًا. وخلال 90 يومًا من 6 يوليو إلى 4 أكتوبر 2026 بلغت نسبة التوليدات النهائية الناجحة 92,2% للنموذج gpt-image-2 من أصل 3 518، و91,9% للنموذج seedream-45 من أصل 1 127، و79,7% لنموذج الفيديو kling-3.0 من أصل 374. حتى لدى النماذج المستقرة قد ينتهي كل استدعاء ثامن أو عاشر بالفشل، وفي الفيديو كل خامس: إذا كنت تنسّق هذه الاستدعاءات بشيفرة، فاجعل إعادة المحاولة جزءًا من البرنامج المولَّد نفسه.

المصدر — شرح الفيديو «Pi Agent 1.0 Code Mode» على Bilibili (نُشر في 14 أكتوبر 2026): bilibili.com/video/BV1rNJk6BEYg. والمزيد من الشروح العملية في مدونتنا.