OpenAI AgentKit هي حزمة من الأدوات لبناء ونشر وقياس وكلاء الذكاء الاصطناعي على منصة OpenAI. إذا قمت بإنشاء وكيل يدويًا من قبل، وقمت بدمج أكواد التنسيق والموصلات وسكربتات التقييم، فإن AgentKit كانت إجابة OpenAI على هذا التجزئة. هناك تفصيل مهم في عام 2026 تحتاج إلى معرفته قبل الالتزام، لذا يرشدك هذا الدليل إلى ما يتضمنه AgentKit، ولمن هو، وسير عمل البناء عالي المستوى، ومكان أدوات اختبار API مثل Apidog عندما يبدأ وكيلك في استدعاء الخدمات الخارجية.
ما هو AgentKit
قدمت OpenAI AgentKit في DevDay بتاريخ 6 أكتوبر 2025. لم يكن منتجًا واحدًا، بل كان مجموعة من الأجزاء التي تستند إلى واجهة برمجة تطبيقات OpenAI الحالية وOpenAI Agents SDK، بهدف تقليص الفجوة بين "لدي فكرة وكيل" و "لدي وكيل يعمل أمام المستخدمين."
قبل AgentKit، كان بناء وكيل عادة ما يعني تجميع منطق التنسيق بدون ترقيم للإصدارات، وموصلات مخصصة لكل مصدر بيانات، وخطوط أنابيب تقييم يدوية، وضبط يدوي للمحفزات، وقدر كبير من العمل الأمامي قبل إطلاق أي شيء. قامت AgentKit بتجميع حلول لتلك المشكلات تحت مظلة واحدة.
أمر يجب التنبيه إليه مقدمًا، لأنه يغير طريقة تعاملك مع هذا: في 3 يونيو 2026، أعلنت OpenAI أنها ستنهي جزءين من AgentKit، وهما Agent Builder و Evals. المزيد عن التواريخ أدناه. الخلاصة هي أن المسار الدائم والأول للتعليمات البرمجية من خلال AgentKit هو Agents SDK، وهذا ما يجب أن تبني عليه إذا كنت تريد شيئًا يدوم.
مكونات AgentKit
تم إطلاق AgentKit كأربعة مكونات رئيسية. إليك ما يفعله كل منها وموقفه الحالي.
Agent Builder
Agent Builder هو لوحة بصرية لتصميم سير عمل الوكيل متعدد الخطوات. يمكنك سحب وإسقاط العقد لكل خطوة، وربطها في سير عمل، ومعاينة التشغيلات مقابل مدخلات حقيقية، ونشر لقطات مؤرشفة من سير العمل. إنه نقطة الدخول "لا صفحة فارغة"، مع قوالب للبدء منها.
تفصيل مفيد للمطورين: Agent Builder ليس طريقًا مسدودًا بعيدًا عن التعليمات البرمجية. يحتوي على تبويب Agents SDK الذي يصدر سير عملك كتعليمات Python أو TypeScript قابلة للتشغيل، بحيث يمكنك أخذ التصميم المرئي وتوسيعه في بيئتك الخاصة.
الموقف مهم هنا. تقوم OpenAI بإلغاء Agent Builder، مع تاريخ إغلاق المنصة في 30 نوفمبر 2026، وفقًا لـ صفحة الإلغاءات الخاصة بها. إذا كنت تبدأ من جديد اليوم، فتعامل مع اللوحة المرئية كأداة للمراجعة السريعة وخطط للانتقال إلى رمز SDK.
ChatKit
ChatKit هي واجهة دردشة قابلة للتضمين لوضع وكيلك أمام المستخدمين. بدلاً من بناء واجهة مستخدم للدردشة من الصفر، يمكنك إسقاط مكون ويب، وتوجيهه إلى معرف سير عمل منشور، وتخصيص السمات والسلوك. إنه يتعامل مع استجابات البث، والمحادثات المتسلسلة، وأساسيات الدردشة المعتادة.
ChatKit لا يزال متاحًا وهو الطريقة الموصى بها لنشر تجربة وكيل قائمة على الدردشة. إنه الجزء الأقل تأثرًا بتغييرات عام 2026 من AgentKit.
سجل الموصلات (Connector Registry)
سجل الموصلات هو مكان مخصص للمسؤولين لإدارة كيفية اتصال البيانات والأدوات عبر منتجات OpenAI، شاملًا ChatGPT وواجهة برمجة التطبيقات (API). إنه يجمع الموصلات المسبقة البناء (مثل Dropbox و Google Drive و SharePoint و Microsoft Teams) وخوادم MCP التابعة لجهات خارجية في لوحة واحدة، بحيث يتحكم المسؤول فيما يمكن للوكيل الوصول إليه.
إذا كنت ترغب في فهم جانب MCP من هذه الصورة، فإن دليلنا حول خوادم MCP و OpenAI Agents SDK يغطي كيفية استدعاء الوكلاء للأدوات عبر بروتوكول سياق النموذج (Model Context Protocol).
التقييمات والتحسين (Evals and optimization)
أضافت ميزات Evals مجموعات بيانات، وتقييم التتبع (تسجيل كل خطوة من تشغيل وكيل متعدد)، وتحسين التوجيه التلقائي، والقدرة على التقييم مقابل نماذج خارجية، وليس فقط نماذج OpenAI. كان الهدف هو قياس جودة الوكيل وضبط التوجيهات دون بناء إطار تقييم خاص بك.
مثل Agent Builder، يتم إنهاء Evals. يصبح للقراءة فقط للمستخدمين الحاليين في 31 أكتوبر 2026 ويغلق في 30 نوفمبر 2026.
كيف يرتبط AgentKit بـ Agents SDK
هذا هو الجزء الذي يستحق التوضيح، لأنه يحدد ما ستبنيه عليه.
Agents SDK هو إطار العمل على مستوى الكود. وهو المكان الذي تحدد فيه الوكلاء والأدوات والتسليمات والحواجز الوقائية في Python أو TypeScript. يجلس Agent Builder الخاص بـ AgentKit فوقه كطبقة مرئية تولد كود SDK. يجلس ChatKit بجانبه كسطح للنشر.
| الطبقة | ما هي | موقفها في عام 2026 |
|---|---|---|
| Agents SDK | إطار عمل برمجي لتحديد الوكلاء والأدوات والحواجز الوقائية | نشط، المسار الموصى به على المدى الطويل |
| Agent Builder | لوحة بصرية تصدر كود Agents SDK | مهملة، ستغلق في 30 نوفمبر 2026 |
| ChatKit | واجهة مستخدم دردشة قابلة للتضمين مرتبطة بمعرف سير عمل | متاحة |
| Connector Registry | لوحة تحكم للموصلات وخوادم MCP | متاحة |
| Evals | تقييم التتبع وتحسين المحفزات | للقراءة فقط في 31 أكتوبر 2026، ستغلق في 30 نوفمبر 2026 |
إرشادات OpenAI للترحيل مباشرة: لسير العمل الذي يجب أن يبقى ككود، انتقل إلى Agents SDK. لحالات الاستخدام باللغة الطبيعية التي لا تحتاج إلى كود، استخدم Workspace Agents في ChatGPT. إذا كنت تقرأ هذا لتحديد أين تستثمر، فإن Agents SDK هو الحل لفرق الهندسة.
لمن AgentKit؟
استهدف AgentKit بضع مجموعات. الفرق المنتجات التي أرادت إطلاق وكيل بسرعة دون كتابة رمز التنسيق اعتمدت على Agent Builder و ChatKit. الشركات التي تحتاج إلى وصول منظم للبيانات الداخلية استخدمت Connector Registry. الفرق الهندسية التي أرادت تحكمًا كاملاً استخدمت Agents SDK مباشرة واستخدمت Evals لقياس الجودة.
نظرًا لعمليات الإلغاء، فإن القراءة الأوضح لعام 2026 هي كالتالي: إذا كنت مهندسًا تبني شيئًا للحفاظ عليه، ابدأ بـ Agents SDK. إذا كنت تقوم بالنماذج الأولية وترغب في بداية مرئية قبل اختفاء اللوحة، فإن Agent Builder لا يزال يصدر رمزًا قابلاً للاستخدام.
سير عمل بناء رفيع المستوى
سواء بدأت بصريًا أو في الكود، فإن شكل بناء الوكيل متشابه. إليك سير العمل الذي تتبعه معظم الفرق.
- حدد مهمة الوكيل. ما الهدف الذي يسعى إليه، وما الأدوات التي يحتاجها؟ الأدوات عادة ما تكون استدعاءات API خارجية: نقطة نهاية بحث، بحث في نظام إدارة علاقات العملاء (CRM)، خدمة مصغرة داخلية.
- تكوين سير العمل. في Agent Builder، تقوم بسحب العقد؛ في Agents SDK، تحدد الوكلاء وتُلحق الأدوات والتسليمات في الكود.
- أضف الحواجز الوقائية. تشحن OpenAI طبقة حواجز وقائية مفتوحة المصدر ووحدات يمكنها إخفاء أو الإشارة إلى المعلومات الشخصية (PII)، واكتشاف محاولات اختراق الأنظمة (jailbreak)، وتطبيق فحوصات أخرى. يمكنك استخدامها كعقد لسير العمل أو كمكتبة مستقلة.
- ربط البيانات والأدوات. عبر سجل الموصلات (Connector Registry) أو عن طريق تسجيل خوادم MCP وأدوات الوظائف التي يمكن للوكيل استدعاؤها.
- اختبار وتقييم. تشغيل الوكيل مقابل مدخلات حقيقية، وتقييم التتبعات، وضبط المحفزات.
- النشر. التضمين عبر ChatKit باستخدام معرف سير عمل منشور، أو تشغيل رمز Agents SDK المصدر في البنية التحتية الخاصة بك.
الخطوتان 4 و 5 هما المكان الذي تكمن فيه معظم المشاكل الواقعية، وحيث يثبت اختبار واجهة برمجة التطبيقات (API) جدواه.
مثال واقعي: الأدوات التي يستدعيها وكيلك
لا يكون الوكيل جيدًا إلا بقدر الأدوات التي يمكنه استدعاؤها، وهذه الأدوات غالبًا ما تكون واجهات برمجة تطبيقات HTTP. عندما تقوم بتسجيل أداة وظيفية مع Agents SDK، فإنك تصفها بمخطط JSON حتى يعرف النموذج متى وكيف يستدعيها. قد يتم تعريف أداة تجلب طلبات العميل الأخيرة كالتالي:
{
"type": "function",
"name": "get_recent_orders",
"description": "Look up a customer's recent orders by customer ID.",
"parameters": {
"type": "object",
"properties": {
"customer_id": {
"type": "string",
"description": "The customer's unique identifier"
},
"limit": {
"type": "integer",
"description": "How many orders to return",
"default": 5
}
},
"required": ["customer_id"],
"additionalProperties": false
}
}
عندما يقرر النموذج استدعاء get_recent_orders، يتلقى كودك الوسيطات، ويقوم بطلب حقيقي إلى واجهة برمجة تطبيقات الطلبات الخاصة بك، ويعيد النتيجة إلى الوكيل. قد يبدو هذا الطلب كالتالي:
curl https://api.your-company.com/v1/customers/cus_8842/orders?limit=5 \
-H "Authorization: Bearer $ORDERS_API_KEY" \
-H "Content-Type: application/json"
هنا تكمن المشكلة. يعتمد سلوك الوكيل بالكامل على ما تعيده واجهة برمجة التطبيقات. إذا كانت واجهة برمجة تطبيقات الطلبات بطيئة، أو معطلة، أو تعيد شكلاً لم يتوقعه النموذج، فإن منطق الوكيل ينحرف. وأثناء التطوير، قد لا تكون واجهة برمجة تطبيقات الطلبات موجودة بعد، أو قد لا ترغب في إثقال الإنتاج بتشغيلات الاختبار. هذا هو المفصل الذي تتناسب معه Apidog.
أين تتناسب اختبارات API والمحاكاة
Apidog ليس إطار عمل للوكلاء، ولا يبني وكلاء. AgentKit وAgents SDK يقومان بذلك. ما تفعله Apidog هو الطبقة السفلية: تقوم باختبار ومحاكاة وتوثيق واجهات برمجة التطبيقات والأدوات التي يستدعيها وكيلك. ثلاث مهام ملموسة تظهر باستمرار.
أولاً، قم بمحاكاة واجهات برمجة التطبيقات الخارجية قبل أن تكون جاهزة. إذا كان وكيلك بحاجة إلى استدعاء خدمة طلبات لم يكملها فريق الواجهة الخلفية بعد، فيمكنك إعداد واجهة برمجة تطبيقات وهمية تعيد استجابات واقعية تتطابق مع المخطط المتفق عليه. يتطور وكيلك بناءً على عقد ثابت بدلاً من انتظار الواجهة الخلفية، وتتحكم في حالات الحافة، والنتائج الفارغة، والأخطاء، والاستجابات البطيئة، حسب الطلب.
ثانيًا، تأكد من أن كل أداة تعيد ما يتوقعه الوكيل. استدعاء أداة يعيد 200 مع أسماء حقول خاطئة أسوأ من الفشل التام، لأن النموذج سيحاول الاستدلال على بيانات خاطئة. عن طريق كتابة حالات اختبار API التي تتحقق من رموز الحالة، وشكل الاستجابة، وقيم الحقول المحددة، يمكنك اكتشاف انحراف العقد في كل نقطة نهاية يلمسها وكيلك قبل أن يصل إلى النموذج.
ثالثًا، إدارة مفاتيح البيئة وعناوين URL الأساسية عبر بيئات التطوير والتجربة والإنتاج. تحمل أدوات الوكيل أسرارًا مثل $ORDERS_API_KEY. إن الاحتفاظ بها في متغيرات البيئة وتبديلها لكل بيئة، دون لصق المفاتيح في الكود، هو بالضبط نوع الأمور التي تتعامل معها منصة API بنظافة. يمكنك تنزيل Apidog وسحب نقاط نهاية أدواتك إلى مشروع لاختبارها بمعزل، بعيدًا عن وقت تشغيل الوكيل.
إذا كنت تريد شرحًا مركزًا لكيفية التعامل مع استدعاءات أداة الوكيل كواجهات برمجة تطبيقات قابلة للاختبار، فقد كتبنا واحدًا في كيفية اختبار استدعاءات أداة وكيل الذكاء الاصطناعي. باختصار: كل أداة يستدعيها وكيلك هي واجهة برمجة تطبيقات، وواجهات برمجة التطبيقات تستحق الاختبار.
أسئلة مكررة
هل OpenAI AgentKit مجاني؟
تستند أدوات AgentKit إلى استخدامك لواجهة برمجة تطبيقات OpenAI، لذا فإنك تدفع مقابل الرموز المميزة للنموذج الأساسي وأي استدعاءات للأدوات يقوم بها الوكيل. لا يوجد بند اشتراك منفصل لـ AgentKit؛ التكلفة هي النموذج واستخدام واجهة برمجة التطبيقات الذي يولده وكيلك. تحقق دائمًا من الأسعار الحالية على منصة OpenAI، حيث تتغير أسعار النماذج.
ما الفرق بين AgentKit و Agents SDK؟
Agents SDK هو إطار العمل البرمجي لتحديد الوكلاء والأدوات والحواجز الوقائية. AgentKit هي حزمة أوسع تتضمن Agent Builder المرئي، وChatKit، وسجل الموصلات (Connector Registry)، وEvals فوق هذا الـ SDK. مع إغلاق Agent Builder وEvals في أواخر عام 2026، فإن Agents SDK هو المسار الدائم المعتمد على الكود أولاً. يغطي دليل Agents SDK الخاص بنا الموضوع من البداية إلى النهاية.
هل سيتم إلغاء Agent Builder؟
نعم. أعلنت OpenAI في 3 يونيو 2026 أنها ستلغي Agent Builder ومنصة Evals. سيتم إغلاقهما في 30 نوفمبر 2026، وستصبح Evals للقراءة فقط في 31 أكتوبر 2026. يبقى ChatKit متاحًا، وتوصي OpenAI بنقل سير العمل المعتمد على الكود أولاً إلى Agents SDK، والعمليات التي تعتمد على اللغة الطبيعية إلى Workspace Agents في ChatGPT.
هل يمكنني اختبار واجهات برمجة التطبيقات التي يستدعيها وكيل AgentKit الخاص بي؟
نعم، ويجب عليك ذلك. كل أداة يستدعيها الوكيل هي واجهة برمجة تطبيقات HTTP مع طلب واستجابة. يمكنك محاكاة واجهات برمجة التطبيقات هذه أثناء بنائها، والتأكد من أن استجاباتها تتطابق مع المخطط الذي يتوقعه وكيلك، وإدارة المفاتيح التي يحتاجها كل منها. توفر منصة مثل Apidog كل هذه الوظائف الثلاث بحيث تتصرف أدوات وكيلك بشكل متوقع قبل أن تصل إلى مستخدم حقيقي.
الخاتمة
قدمت AgentKit لمطوري OpenAI طريقة أسرع لبناء الوكلاء: لوحة مرئية في Agent Builder، وواجهة مستخدم قابلة للتضمين في ChatKit، وموصلات محكومة في Connector Registry، وقياس من خلال Evals. مع اقتراب أواخر عام 2026، يتم سحب Agent Builder و Evals، لذا فإن الرهان الدائم لفرق الهندسة هو Agents SDK، مع ChatKit و Connector Registry إلى جانبه.
مهما كان المسار الذي تختاره، فإن موثوقية وكيلك تعتمد على واجهات برمجة التطبيقات التي يستدعيها. قم بمحاكاتها مبكرًا، وتأكد من استجاباتها، وحافظ على تنظيم مفاتيحك. يوفر لك Apidog مكانًا واحدًا لاختبار ومحاكاة كل نقطة نهاية أداة يعتمد عليها وكيلك، بحيث تصمد التكاملات عندما يضعها الوكيل تحت الضغط.