أضافت OpenAI في 16 أكتوبر 2026 إلى البيئات المستضافة في Agents API كلًا من Artifact SDK ومهارات إنشاء وتعديل جداول البيانات والعروض التقديمية ومستندات Word. القيمة ليست فقط أن “الوكيل يصنع ملفًا”، بل أن Workflow إنتاجية تستطيع إبقاء الملفات المصدرية وتنفيذ الكود والمستند الناتج داخل Session مدارة، ثم نشر نسخة غير قابلة للتغيير عبر Artifacts API. مع ذلك يجب اعتبار الناتج غير موثوق حتى ينجح فحص البنية والمعادلات والتخطيط والمصدر والأمن.
يفصل هذا المقال بين السلوك الموثق من OpenAI والتوصيات الهندسية. يأتي تاريخ الإصدار وأنواع المستندات من سجل تغييرات API الرسمي، بينما تأتي خصائص Sessions وSandbox والملفات والأمن والاحتفاظ من وثائق Agents API التي تم التحقق منها في 22 أكتوبر 2026. أما Pipeline التحقق المقترحة فهي تصميم إنتاجي وليست Benchmark أوضمانًا من OpenAI.
ما الذي تغير في Agents API؟
يسجل Changelog الرسمي أن البيئات المستضافة حصلت على Artifact SDK ومهارات للجداول والعروض وWord في 16 أكتوبر. أما Agents API الأوسع فهي Codex Harness مُدارة: تتولى OpenAI الجلسات والتنسيق واختصار السياق والتعافي، بينما يقدم التطبيق التعليمات والأدوات ويختار بيئة التنفيذ. يستطيع الوكيل تشغيل الكود وتعديل الملفات والاتصال بخوادم MCP وإنتاج Artifacts.
هذا يغلق فجوة عملية. فقبل أن يصبح المستند مفيدًا، تحتاج العملية عادة إلى قراءة بيانات منظمة وحساب قيم وتطبيق Template وعرض الملف وإتاحته للمستخدم. لا تحافظ الاستجابة النصية على معادلات Spreadsheet أوهندسة Slides أوالبنية القابلة للتحرير في Word. تمنح Sandbox نظام ملفات وتنفيذ كود، وتوفر المهارات مسار التأليف، وتوفر Artifacts API عقد الاسترجاع الدائم.
لكن ذلك لا يحول المستند المولد إلى سجل أعمال موثوق. قد يحتوي Workbook أنيقًا على Formula خاطئة، وقد يسقط العرض تحذيرًا جوهريًا، وقد يكشف Word Metadata أوHidden Content. نجاح فتح الملف مجرد فحص Format.
صمّم مهمة مستند محدودة
ابدأ بعقد Job صريح بدل Prompt واسعة. حدد المدخلات المسموحة وإصدار القالب وصيغ المخرجات وقواعد الحساب والأقسام المطلوبة والحجم الأقصى واللغة والجمهور وفحوص القبول. ضع منطق الأعمال الحتمي خارج تعليمات اللغة الطبيعية عندما تكون الصحة مهمة.
في تقرير عمليات شهري مثلًا، اقبل JSON خاضعة لـSchema وقالبًا مثبت الإصدار. يحسب الكود التجميعات من الحقول المعتمدة، بينما يشرح الوكيل الشذوذ ويملأ الخلايا السردية. ثم يعيد Validator حساب المعادلات ويقارن الإجماليات بالمصدر. هكذا يستخدم النموذج للتلخيص، وتملك الشيفرة التقليدية الحساب والقيود.
استخدم Session أوEnvironment مخصصة لكل Tenant أوعبء حساس. تقول وثيقة الأمن إن الكود المولد يستطيع الوصول إلى الملفات والاعتمادات والشبكة المتاحة داخل البيئة. وتوصي بالعزل، وفصل البيئات عندما لا يجوز مشاركة البيانات، والسماح للوجهات الخارجية المعتمدة فقط، وإبقاء مفاتيح التطبيق خارج البيئة.
لا ترفع قرص إنتاج كاملًا لأن الوكيل قد يحتاج تقريرًا واحدًا. ضع أقل ملفات ممكنة تحت /workspace، واستعمل معرف Job غير دال، واحذف المعرفات الشخصية غير اللازمة. وإذا احتجت بيانات خارجية، فاستعمل Function محدودة أوMCP Tool بصلاحية ضيقة تعيد Records خاضعة للتحقق، بدل Credential عامة ونفاذ واسع للشبكة.
استخدم دورة حياة Artifact بوعي
يمكن إرفاق المدخلات عند إنشاء Session مستضافة أوإضافتها عبر Environment Files API، ويجب أن يكون المسار داخل /workspace. لنشر الناتج اطلب حفظه تحت /workspace/outputs؛ وعند اكتمال Turn تنشر OpenAI الملفات كـArtifacts غير قابلة للتغيير.
ترتبط Artifact بجلسة وTurn، وتبقى قابلة للتنزيل بعد انتهاء البيئة، لكنها لا تعدّل في مكانها عبر API. يولّد الإصدار المعدل في Turn جديدة ويُميّز بواسطة Turn ID والمسار. احفظ معًا Session ID وTurn ID وArtifact ID وContent Hash وإصدار القالب ونسخة المصدر ونتيجة التحقق.
تنزّل API Artifact واحدة في كل طلب. إذا أنشأت المهمة Workbook وDeck وDocument وAudit Manifest، فنزّل كل عنصر بوضوح أوأنشئ ZIP تحت outputs. لا تعتمد على Sandbox Path بعد انتهائها، وانسخ الملفات المقبولة إلى Storage التطبيق قبل حذف Session.
توثق OpenAI حدودًا منها 200 MiB لكل Artifact منشورة و500 MiB للمخرجات المنشورة معًا. هذه سقوف منصة وليست توصية Product. ضع حدودًا أصغر تناسب تنزيل المتصفح وفحص البرمجيات الخبيثة وكلفة الاحتفاظ وتجربة المستخدم.
ضع بوابة تحقق قبل التسليم
استخدم State Machine بدليل صريح:
RECEIVED -> STAGED -> GENERATED -> VALIDATING -> APPROVED -> PUBLISHED
| |
+-> REJECTED +-> QUARANTINEDتحقق من المحتوى قبل الانتقال إلى APPROVED. افتح Spreadsheet بمحلل مستقل، وارفض External Links وMacros إلا إذا سمحت بها، وأعد حساب المعادلات، وقارن الإجماليات بالمصدر، وافحص Named Ranges وHidden Sheets. وفي Presentation اعرض كل Slide كصورة، واكشف Overflow والخطوط المفقودة، وتأكد من الأقسام وأن Chart تطابق جدولها. وفي Word افحص العناوين والجداول والروابط والتعليقات وTracked Changes والكائنات المضمنة وخصائص الوصول وMetadata.
نفذ فحص Malware وArchive Bomb قبل إتاحة التنزيل. وحّد اسم الملف وContent-Type بدل الوثوق بالامتداد. ارفض الصيغ غير المتوقعة والملفات التنفيذية المضمنة ونسبة الضغط الشاذة والروابط إلى Hosts غير معتمدة. احتفظ بالملف المرفوض في Quarantine فقط إن سمحت السياسة، وإلا احذفه واحفظ سجل فشل محدودًا.
أضف مراجعة دلالية للادعاءات التي لا تفحص بنيويًا. يجب أن يشير كل رقم في الملخص إلى حقل مصدر أوخلية محسوبة، وكل سياسة مقتبسة إلى معرف مصدر ثابت. أما العقود والقوائم المالية والتقديمات التنظيمية والتعليمات الطبية والتزامات العملاء فتحتاج موافقة بشرية مؤهلة قبل النشر.
اجعل Retry آمنة والنتائج قابلة للرصد
يمكن أن تفشل Turns وUploads والتحقق والتخزين بشكل مستقل. امنح كل Job مفتاح Idempotency، واحفظ الانتقال قبل إطلاق Side Effect التالية. يجب أن تجد Retry ملفًا مقبولًا موجودًا بحسب Job وTurn وHash بدل نشر ملف “نهائي” ثانٍ بصمت.
سجل Events منظمة لإنشاء Session وInput Hashes وTool Calls ونشر Artifact وقواعد التحقق وهوية الموافق والنسخ والتنظيف. لا تنسخ Prompts أوالملفات في Logs عامة. قس Queue Time ووقت إعداد Sandbox ومدة التوليد والتحقق وسبب الرفض والحجم وعدد Retry ونسبة القبول. قارن بحسب القالب ونوع المستند حتى لا تختفي مشكلة عروض داخل معدل نجاح عام.
تحتفظ API بحالة Session. وتقول الصفحة الرسمية إن Agents API تدعم حاليًا Data Residency في الولايات المتحدة فقط ولا تدعم Zero Data Retention، وإن Self-hosted Sandbox لا تجعلها مؤهلة لـZDR. قد يمنع هذا القيد استخدام Workflow لبعض فئات البيانات حتى لو كان التوليد مناسبًا تقنيًا.
متى تستخدمها ومتى لا؟
استخدم المسار المدار عندما تكون المدخلات محدودة، وتفيد الصيغة المكتبية القابلة للتحرير، وتمتد المهمة على أدوات أوTurns متعددة، ويمكنك التحقق قبل التسليم. أمثلة جيدة: حزم تحليل داخلية، ومسودات عروض، وتقارير تشغيل دورية، ومواد تدريب قابلة للتعديل، وتحويلات أولية للمستندات.
استخدم Export Code حتميًا عندما يكون القالب ثابتًا وربط البيانات بسيطًا، أويجب أن يتكرر الناتج Byte-for-byte، أويكون Latency صارمًا، أوتنتج مكتبة معروفة الملف بأمان. خدمة تملأ عشرين خلية لا تحتاج Agent مستقلة. واستخدم أداة تأليف يقودها إنسان عندما يهيمن الحكم الإبداعي أوالمسؤولية القانونية.
لا تستخدمها لأسرار أوبيانات منظمة لا تتوافق مع نموذج الإقامة والاحتفاظ الموثق. ولا تسمح للنموذج بالتوقيع أوالإرسال أوالبريد أوOverwrite سجل أعمال بلا Authorization Boundary مستقلة. ولا تقبل التعليمات المضمنة في ملف مرفوع كأوامر أعلى أولوية؛ عامل المحتوى كبيانات وقيد الأدوات بالسياسة.
قائمة تنفيذ جاهزة للإنتاج
عرّف Job Schema والمدخلات الدنيا وإصدار القالب. اعزل العملاء وقيد Egress. أبقِ مفاتيح التطبيق والأطراف الثالثة خارج Sandbox. ولّد داخل مجلد Job وانشر المرشحين النهائيين تحت /workspace/outputs. احفظ معرفات Session وTurn وArtifact والمصدر. افحص البنية والحسابات والمصدر والأمن وRendering بأدوات مستقلة. اطلب موافقة بشرية للمخرجات عالية الأثر. انسخ المقبول إلى Storage دائم، وطبق Retention، واحذف Sessions والنسخ المنشورة عند انتهاء الحاجة.
وأخيرًا اختبر حالات عدائية: مستند مصدر يطلب تجاهل السياسة، وWorkbook تالفة، وExternal Link مخفية، وFormula تنقص صفًا، وSlide فيها نص مقصوص، وRetry مكررة، وArtifact تتجاوز حد المنتج. تقلل Artifact SDK والمهارات كلفة التأليف؛ أما الجودة الإنتاجية فتأتي من الحدود المحيطة بها.
المراجع الرسمية
تدعم هذه المراجع سلوك الأدوات المذكورة. الأمثلة وقرارات التصميم توضيحية، ويجب تكييفها مع متطلبات المشروع وإصداراته.
إعداد: Noor Yasser
تعمل على تحدٍ تقني مشابه؟
أساعد الفرق على تحويل القرار المعماري إلى نطاق واضح وتنفيذ يمكن تشغيله ومراجعته بثقة.
