يتعلق إصدار أبريل في معظمه بشيء واحد: تسهيل فحص تطوير وكلاء الذكاء الاصطناعي (AI Agent).
إذا كنت تقوم بإنشاء وكلاء، فأنت تعلم بالفعل أن الجزء الصعب ليس دائمًا هو الإجابة النهائية. بل هو كل ما حدث قبل ظهور الإجابة. ماذا ظن الوكيل أن المستخدم يريده؟ ما هي الأداة التي استدعاها؟ ما الذي عاد من تلك الأداة؟ هل فشل الاستعلام الأولي (prompt)، أم فشل منطق العمل؟
يضيف Apidog هذا الشهر أدوات جديدة لهذا النوع من العمل: مصحح أخطاء وكلاء الذكاء الاصطناعي (AI Agent Debugger)، ومصحح أخطاء A2A، واستيراد Postman API لعمليات الترحيل الأكبر، وتجربة "اسأل الذكاء الاصطناعي" أفضل في الوثائق المنشورة، وموفري النماذج المخصصة.
إليك ما تغير👇
⭐ تحديثات جديدة
🔥 مصحح أخطاء وكلاء الذكاء الاصطناعي: افحص تشغيل الوكيل بالكامل
لطالما دعم Apidog تصحيح الأخطاء المرئي لنقاط نهاية SSE. وقد كان ذلك مفيدًا لتدفق استجابات النموذج، وتحديثات التقدم، والإشعارات في الوقت الفعلي، وغيرها من واجهات برمجة التطبيقات المعتمدة على الأحداث.
لكن تصحيح أخطاء الوكيل يحتاج أكثر من مجرد عارض تدفق.
استجابة النموذج تخبرك فقط إلى أين وصل الوكيل. لا تخبرك كيف وصل إلى هناك. في المشاريع الحقيقية، غالبًا ما تحتاج إلى رؤية الخطوات الوسيطة: منعطفات المحادثة، استدعاءات النموذج، استدعاءات أدوات MCP، تنفيذ المهارات المخصصة، نتائج الأدوات، والمخرجات النهائية.
لقد تم بناء مصحح أخطاء وكلاء الذكاء الاصطناعي الجديد لهذا الغرض.
بدلاً من التحقق من الاستجابة النهائية فقط، يمكنك متابعة مسار تنفيذ الوكيل داخل Apidog. يتم تسجيل كل جولة من المحادثة، واستدعاء النموذج، واستدعاء أداة MCP، وتشغيل المهارة، والنتيجة النهائية في مكان واحد.
هذا يجعل الإجابة على أسئلة تصحيح الأخطاء العملية أسهل بكثير:
- هل وفر الاستعلام الأولي (prompt) للنموذج سياقًا كافيًا؟
- هل اختار الوكيل الأداة الصحيحة؟
- هل أعادت أداة MCP النتيجة المتوقعة؟
- هل نشأت المشكلة من تكوين النموذج، أو معلمات الأداة، أو منطق العمل؟
يمكن أن تصبح أنظمة الوكلاء فوضوية بسرعة. هذا يمنح الفرق طريقة أنظف لرؤية ما حدث بالفعل.
🤝 مصحح أخطاء A2A: اختبار اتصال وكيل لوكيل
أصبحت أنظمة الوكلاء المتعددة أكثر شيوعًا. بمجرد أن تبدأ الوكلاء في العمل معًا، تحتاج إلى طريقة موثوقة للتحقق مما إذا كان يمكنهم تمرير المهام وتبادل الرسائل وإرجاع النتائج بشكل صحيح.
يدعم Apidog الآن تصحيح الأخطاء لبروتوكول A2A من Google، أو وكيل-لوكيل (Agent-to-Agent).
يمكنك إرسال طلبات A2A مباشرة، وفحص معلمات الطلب، والتحقق من الاستجابات، والتحقق من نتيجة التفاعل. يساعد هذا الفرق على اختبار اتصال وكيل-لوكيل دون التنقل بين أدوات منفصلة أو قراءة تفاصيل البروتوكول الأولية يدويًا.
الفرق بين أداتي تصحيح الأخطاء الجديدتين بسيط:
- يفحص مصحح أخطاء وكلاء الذكاء الاصطناعي ما يحدث داخل وكيل واحد أثناء تشغيله لمهمة.
- يفحص مصحح أخطاء A2A ما إذا كان يمكن لوكيل واحد الاتصال بوكيل آخر.
ستحتاج معظم الفرق العاملة على الوكلاء إلى كليهما عاجلاً أم آجلاً.
📦 استيراد بيانات Postman عبر Postman API
أصبح ترحيل Postman الآن خيارًا أفضل للفرق الكبيرة.
لقد دعم Apidog بالفعل استيراد ملفات Postman المحلية. والآن يمكنك أيضًا استيراد مساحات العمل (Workspaces) والمجموعات (Collections) والبيئات (Environments) عبر Postman API.
تم تصميم هذا لعمليات الترحيل الكبيرة عند إنشاء مشاريع جديدة. في الممارسة العملية، إنه أقرب إلى نقل مساحة عمل Postman بأكملها إلى Apidog. إذا كان حسابك في Postman يحتوي على مساحات عمل متعددة، فسيقوم Apidog بإنشاء مشاريع مقابلة بعد الاستيراد.
هذا يعني عددًا أقل من خطوات التصدير المحلي والرفع والتنظيف. بالنسبة لعمليات الاستيراد الصغيرة، لا تزال الملفات المحلية تعمل. أما بالنسبة لعمليات ترحيل مساحات العمل الأكبر، فيجب أن يكون مسار API أقل إرهاقًا بكثير.
📄 "اسأل الذكاء الاصطناعي" في الوثائق المنشورة يفتح الآن في الشريط الجانبي
يعمل "اسأل الذكاء الاصطناعي" في الوثائق المنشورة الآن في شريط جانبي.
يمكن للقراء إبقاء المستند الحالي مفتوحًا أثناء طرح الأسئلة حوله. قد يبدو هذا تغييرًا صغيرًا في واجهة المستخدم، لكنه يزيل الكثير من التنقل ذهابًا وإيابًا. يمكنك قراءة وثائق API، وطرح سؤال، ومتابعة، والبقاء في مكانك في الصفحة.
وهو مفيد بشكل خاص للوثائق الطويلة، حيث قد تكون الإجابة موجودة في مكان ما في الصفحة ولكن ليس من السهل العثور عليها بسرعة.
🧠 موفرو نماذج الذكاء الاصطناعي المخصصون
يمكن للفرق أيضًا ربط موفري خدمة مخصصين باستخدام عنوان URL أساسي (Base URL) مخصص. إذا كانت شركتك تستخدم بالفعل خدمة نماذج مستضافة ذاتيًا أو بوابة نماذج داخلية، فيمكنك إحضار هذا الإعداد إلى Apidog بدلاً من التبديل بين الأدوات في كل مرة تحتاج فيها إلى تصحيح أخطاء سير عمل متعلق بالذكاء الاصطناعي.
🐞 إصلاحات الأخطاء وتحسينات أصغر
لقد قمنا أيضًا هذا الشهر بإطلاق عدد من الإصلاحات وتحديثات تحسين تجربة المستخدم:
- تم إصلاح مشكلة عدم احتفاظ الدمج الذكي لـ OpenAPI بأمثلة استجابة نقطة النهاية.
- تم إصلاح مشكلة حيث يمكن أن يتضمن الدمج من فرع فرعي إلى فرع رئيسي محمي نقاط نهاية لم يتم تحديدها.
- تم إصلاح عرض القائمة المنسدلة غير الصحيح عند إنشاء إصدارات نقطة النهاية من الفروع.
- تم إصلاح مشكلة عدم عمل TestData و TestCases عند تشغيل الاختبارات عبر CLI.
- تم إصلاح مشكلة حيث تضمن تصدير OpenAPI مكونات الاستجابة من وحدات غير ذات صلة.
- تم إصلاح تنسيق تصدير Markdown لـ JSON مع التعليقات.
- تم إصلاح خطأ في تصدير Word ناتج عن
crypto is not defined. - تم إصلاح مشكلة عدم عرض حقول اسم المستخدم وكلمة المرور عند استيراد Knife4j مع تمكين المصادقة الأساسية (Basic Auth).
- تم إصلاح خطأ في تصفية نقطة النهاية عندما كانت العلامات أرقامًا.
- تم إصلاح مشكلة عدم إرجاع
apidog endpoint list --branchبيانات للفرع المحدد. - تم إصلاح العديد من المشكلات المتعلقة بمعلمات أداة MCP، والتصفية، ورسائل الخطأ.
- تم إصلاح مشكلة حيث كان الكود المُنشأ يفتقر إلى خيار التكوين
typescriptThreePlus.
🌟 ماذا يعني هذا
إصدار أبريل هو إصدار عملي للفرق التي تبني منتجات وكلاء الذكاء الاصطناعي.
يساعدك مصحح أخطاء وكلاء الذكاء الاصطناعي على فحص تشغيل وكيل واحد. يساعدك مصحح أخطاء A2A على اختبار الاتصال بين الوكلاء. يجعل استيراد Postman API عملية الترحيل أقل إرهاقًا. يجعل الشريط الجانبي لـ "اسأل الذكاء الاصطناعي" الوثائق المنشورة أسهل في الاستخدام. يمنح موفرو النماذج المخصصة الفرق مزيدًا من التحكم في إعدادات الذكاء الاصطناعي الخاصة بهم.
لا شيء من هذا مبهرج لمجرد التباهي. إنه نوع الأدوات الذي تبدأ في الرغبة فيه بمجرد أن ينتقل تطوير الوكلاء من العروض التوضيحية إلى المشاريع الحقيقية.
💬 انضم إلى المحادثة
تواصل مع مهندسي API الآخرين وفريق Apidog:
- انضم إلى مجتمعنا على Discord للمناقشات والدعم في الوقت الفعلي.
- شارك في مجتمعنا على Slack للمحادثات التقنية.
- تابعنا على X (تويتر) للحصول على آخر التحديثات.
ملاحظة: للحصول على التفاصيل الكاملة حول جميع التحديثات، تحقق من سجل تغييرات Apidog!
مع خالص التقدير،
فريق Apidog