ورش عمل ShipSF - ورشة عمل العاملين الصغار باستخدام Notion

Highlights

• تتيح عمال Notion للوكلاء توسيع قدراتهم البرمجية بشكل آمن وموثوق عبر كود مخصص.

• تستخدم البنية التحتية لعمال Notion بيئات Vercel Sandbox لعزل الكود غير الموثوق ومنع هجمات تعدين العملات المشفرة وحجب الخدمة.

• تمنع ميزة بيانات الاعتماد الوسيطة من Vercel بيئات العزل من تخزين بيانات الاعتماد عبر إدراجها في رؤوس طلبات الشبكة في الوقت المناسب.

• يتكون كود العامل من مفتاح تصدير الوحدة، ووصف الأداة، ومخطط الإدخال، ودالة التنفيذ.

• تستخرج البيئة المعزولة مخططات الأدوات عبر تحويل الوحدة النمطية إلى نص JSON وقراءتها عبر الإخراج القياسي.

Timeline

1. 00:00:00 - 05:03:00

   مفهوم وعمل عمال Notion والأمان

   تتيح عمال Notion توسيع قدرات المنصة باستخدام كود مخصص يكتبه الوكلاء أو المستخدمون. صُممت هذه البيئة لتجاوز قيود MCP والمهارات المحلية التي تكشف بيانات الاعتماد باستمرار. تضمن عزل الحوسبة لمنع تعدين العملات المشفرة وهجمات حجب الخدمة، مما يتيح تشغيل كود المستخدمين بأمان تام على خوادم الإنتاج.

   • تتضمن قدرات عمال Notion أدوات الوكلاء وعمليات المزامنة والأتمتة الحتمية.
   • تختلف أدوات العمال عن بروتوكول MCP والمهارات المحلية بتوفير تنفيذ موثوق وإدارة آمنة لبيانات الاعتماد.
   • تمنع بيئات Vercel Sandbox الكود العشوائي من إحداث أضرار أمنية أو استهلاك موارد الحوسبة بشكل غير عادل.
2. 05:03:00 - 08:34:00

   آلية بيانات الاعتماد والتجربة العملية

   تقوم تقنية بيانات الاعتماد الوسيطة بحماية المفاتيح السرية من التسجيل الخبيث من قبل الوكلاء. يوضح العرض التوضيحي كيف يقوم وكيل مخصص بجلب تفضيلات الطعام والطلبات السابقة من منصة Forkable وإجراء الطلبات الحتمية بشكل منتظم وأسبوعي نيابة عن المستخدم.

   • تؤدي ميزة بيانات الاعتماد الوسيطة إلى إدراج الاعتمادات في رأس طلب الشبكة الصادر لحظة التنفيذ دون حفظها في بيئة العزل.
   • ينفذ وكيل طلب الطعام المهام أسبوعياً نيابة عن المستخدم دون الحاجة لتفاعل بشري مستمر.
   • يجلب الوكيل بيانات الطلبات السابقة ويؤكد الوجبات تلقائياً عبر منصة Forkable.
3. 08:34:00 - 17:00:00

   بنية الكود وعملية استخراج أدوات الوكيل

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

   • يحدد كود العامل اسم الأداة والوصف ومخطط Zod للإدخال ودالة التنفيذ.
   • تُرفع حزمة Tarball البرمجية إلى تخزين الكائنات ليتم بثها وتنفيذها داخل بيئة معزولة.
   • تستخدم البيئة المعزولة الإخراج القياسي لتسجيل مخططات الأدوات بصيغة JSON والتحقق من صحتها.
4. 17:00:00 - 28:43:00

   تنفيذ الأدوات وإدارة الحالة والأسئلة الشائعة

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

   • تُنفذ دوال الأدوات داخل بيئات معزولة جديدة أو عبر لقطات سريعة لضمان استقلالية كل عملية استدعاء.
   • تتفوق عمال Notion على الوظائف السحابية مثل AWS Lambda بسهولة النشر السريع بأسطر أوامر بسيطة.
   • يتعافى الوكيل ذاتياً من أخطاء استدعاء الأدوات بالاعتماد على نظام الذاكرة الخاص به.