تحديثات APIDOG لشهر أبريل: مصحح أخطاء وكيل الذكاء الاصطناعي، ومصحح أخطاء A2A، وترحيل أسهل من Postman

يتعلق إصدار أبريل بشيء عملي واحد: جعل فحص وتتبّع تطوير وكلاء الذكاء الاصطناعي أسهل، خصوصًا عندما تحتاج إلى معرفة ما حدث قبل ظهور الإجابة النهائية.

جرّب Apidog اليوم

إذا كنت تبني وكلاء ذكاء اصطناعي، فغالبًا لا تكون المشكلة في النص النهائي فقط. تحتاج عادةً إلى تتبّع سلسلة التنفيذ كاملة:

• ماذا فهم الوكيل من طلب المستخدم؟
• أي نموذج تم استدعاؤه؟
• أي أداة أو MCP Tool استخدمها؟
• ماذا أعادت الأداة؟
• هل الخطأ في الـ prompt، أم في إعدادات النموذج، أم في منطق العمل؟

في هذا الإصدار، يضيف Apidog أدوات تساعدك على التعامل مع هذه الأسئلة مباشرة: مصحح أخطاء وكلاء الذكاء الاصطناعي، مصحح أخطاء A2A، استيراد Postman عبر API، تحسين تجربة "اسأل الذكاء الاصطناعي" في الوثائق المنشورة، ودعم موفري نماذج مخصصين.

⭐ تحديثات جديدة

🔥 مصحح أخطاء وكلاء الذكاء الاصطناعي: تتبّع تشغيل الوكيل خطوة بخطوة

كان Apidog يدعم سابقًا تصحيح أخطاء نقاط نهاية SSE بشكل مرئي. هذا مفيد عند التعامل مع:

• تدفق استجابات النماذج
• تحديثات التقدم
• الإشعارات في الوقت الفعلي
• واجهات API المعتمدة على الأحداث

لكن تصحيح أخطاء الوكلاء يحتاج رؤية أعمق من مجرد عرض التدفق النهائي.

في تطبيقات الوكلاء الحقيقية، تحتاج إلى تتبّع التنفيذ الداخلي للوكيل، مثل:

1. جولات المحادثة.
2. استدعاءات النموذج.
3. استدعاءات أدوات MCP.
4. تنفيذ المهارات المخصصة.
5. نتائج الأدوات.
6. المخرجات النهائية.

مصحح أخطاء وكلاء الذكاء الاصطناعي في Apidog يجمع هذه الخطوات في مكان واحد، بحيث يمكنك فحص مسار التنفيذ بدل الاكتفاء بالاستجابة النهائية.

استخدمه عندما تريد الإجابة عن أسئلة مثل:

• هل يحتوي الـ prompt على سياق كافٍ؟
• هل اختار الوكيل الأداة الصحيحة؟
• هل أعادت أداة MCP البيانات المتوقعة؟
• هل المشكلة في تكوين النموذج؟
• هل الخطأ في معلمات الأداة؟
• هل فشل منطق العمل بعد نجاح استدعاء الأداة؟

مثال عملي على سيناريو تصحيح:

User request
  ↓
Agent reasoning
  ↓
Model call
  ↓
MCP tool call
  ↓
Tool response
  ↓
Custom skill execution
  ↓
Final answer

بدل فحص كل خطوة يدويًا في سجلات منفصلة، يمكنك تتبّعها داخل Apidog لمعرفة أين انحرف السلوك المتوقع.

🤝 مصحح أخطاء A2A: اختبار اتصال وكيل بوكيل

مع انتشار أنظمة الوكلاء المتعددة، لم يعد كافيًا اختبار وكيل واحد فقط. تحتاج أيضًا إلى التحقق من قدرة الوكلاء على التواصل فيما بينهم.

يدعم Apidog الآن تصحيح أخطاء بروتوكول A2A من Google، أي Agent-to-Agent.

يمكنك استخدام مصحح A2A من أجل:

• إرسال طلبات A2A مباشرة.
• فحص معلمات الطلب.
• التحقق من الاستجابة.
• مراجعة نتيجة التفاعل بين الوكلاء.
• التأكد من أن تمرير المهام بين الوكلاء يعمل كما هو متوقع.

الفرق العملي بين الأداتين:

الأداة	متى تستخدمها؟
مصحح أخطاء وكلاء الذكاء الاصطناعي	عندما تريد فحص ما يحدث داخل وكيل واحد أثناء تنفيذ مهمة
مصحح أخطاء A2A	عندما تريد اختبار الاتصال والتفاعل بين وكيل ووكيل آخر

إذا كان لديك نظام يحتوي على أكثر من وكيل، فستحتاج غالبًا إلى الاثنين: واحد لتصحيح السلوك الداخلي، وآخر لتصحيح الاتصال بين الوكلاء.

📦 استيراد بيانات Postman عبر Postman API

أصبح ترحيل البيانات من Postman أسهل للفرق الكبيرة.

كان Apidog يدعم استيراد ملفات Postman المحلية. الآن يمكنك أيضًا الاستيراد عبر Postman API، بما يشمل:

• Workspaces
• Collections
• Environments

هذا مفيد عند إنشاء مشاريع جديدة في Apidog اعتمادًا على إعدادات Postman الموجودة.

بدل تنفيذ خطوات متكررة مثل:

Export collection
→ Export environment
→ Upload files
→ Reorganize projects
→ Clean up imported data

يمكنك استخدام مسار Postman API لترحيل مساحات العمل بشكل مباشر.

إذا كان حساب Postman يحتوي على عدة Workspaces، فسيقوم Apidog بإنشاء مشاريع مقابلة بعد الاستيراد.

استخدم هذا الخيار عندما يكون لديك:

• أكثر من Workspace.
• عدة Collections مرتبطة ببيئات مختلفة.
• فريق كبير يحتاج إلى ترحيل منظم.
• مشروع جديد تريد بناؤه بسرعة داخل Apidog.

أما إذا كان الاستيراد صغيرًا أو لمرة واحدة، فلا يزال خيار الملفات المحلية مناسبًا.

📄 "اسأل الذكاء الاصطناعي" في الوثائق المنشورة يفتح الآن في الشريط الجانبي

تعمل ميزة "اسأل الذكاء الاصطناعي" في الوثائق المنشورة الآن داخل شريط جانبي.

الفائدة العملية هنا أن القارئ لا يحتاج إلى مغادرة الصفحة أو فقدان موضعه داخل الوثائق.

يمكنك الآن:

1. فتح صفحة وثائق API.
2. قراءة نقطة نهاية أو قسم معين.
3. طرح سؤال في الشريط الجانبي.
4. متابعة القراءة من نفس الموضع.

هذا مفيد خصوصًا في الوثائق الطويلة، حيث قد تكون الإجابة موجودة داخل الصفحة، لكن الوصول إليها يدويًا يستغرق وقتًا.

مثال على أسئلة يمكن طرحها أثناء قراءة الوثائق:

ما الحقول المطلوبة في هذا الطلب؟
ما معنى هذا الخطأ؟
ما الفرق بين هذين الـ endpoints؟
هل هذا الحقل اختياري أم إجباري؟

🧠 موفرو نماذج الذكاء الاصطناعي المخصصون

يدعم Apidog الآن ربط موفري نماذج مخصصين باستخدام Base URL مخصص.

هذا مفيد إذا كان فريقك يستخدم:

• خدمة نماذج مستضافة ذاتيًا.
• بوابة نماذج داخلية.
• إعدادًا خاصًا لإدارة الوصول إلى النماذج.
• مزود نماذج غير مدمج افتراضيًا في الأداة.

بدل التبديل بين أدوات متعددة عند تصحيح سير عمل متعلق بالذكاء الاصطناعي، يمكنك إدخال إعدادات الموفر المخصص داخل Apidog واستخدامه ضمن بيئة العمل نفسها.

مثال تصوري للإعداد:

Provider name: Internal Model Gateway
Base URL: https://models.internal.example.com
Authentication: حسب إعدادات فريقك

هذا يمنح الفرق مرونة أكبر عند العمل مع بنى تحتية داخلية أو بيئات مقيدة.

🐞 إصلاحات الأخطاء وتحسينات أصغر

يتضمن هذا الإصدار أيضًا مجموعة من الإصلاحات والتحسينات:

• تم إصلاح مشكلة عدم احتفاظ الدمج الذكي لـ OpenAPI بأمثلة استجابة نقطة النهاية.
• تم إصلاح مشكلة حيث يمكن أن يتضمن الدمج من فرع فرعي إلى فرع رئيسي محمي نقاط نهاية لم يتم تحديدها.
• تم إصلاح عرض القائمة المنسدلة غير الصحيح عند إنشاء إصدارات نقطة النهاية من الفروع.
• تم إصلاح مشكلة عدم عمل TestData و TestCases عند تشغيل الاختبارات عبر CLI.
• تم إصلاح مشكلة حيث تضمن تصدير OpenAPI مكونات الاستجابة من وحدات غير ذات صلة.
• تم إصلاح تنسيق تصدير Markdown لـ JSON مع التعليقات.
• تم إصلاح خطأ في تصدير Word ناتج عن crypto is not defined.
• تم إصلاح مشكلة عدم عرض حقول اسم المستخدم وكلمة المرور عند استيراد Knife4j مع تمكين المصادقة الأساسية Basic Auth.
• تم إصلاح خطأ في تصفية نقطة النهاية عندما كانت العلامات أرقامًا.
• تم إصلاح مشكلة عدم إرجاع apidog endpoint list --branch بيانات للفرع المحدد.
• تم إصلاح عدة مشكلات متعلقة بمعلمات أداة MCP، والتصفية، ورسائل الخطأ.
• تم إصلاح مشكلة حيث كان الكود المُنشأ يفتقر إلى خيار التكوين typescriptThreePlus.

🌟 ماذا يعني هذا عمليًا؟

إصدار أبريل يستهدف الفرق التي انتقلت من تجربة الوكلاء كنماذج أولية إلى استخدامها في مشاريع حقيقية.

إذا كنت تعمل على وكيل واحد، استخدم مصحح أخطاء وكلاء الذكاء الاصطناعي لفهم مسار التنفيذ الداخلي.

إذا كنت تعمل على عدة وكلاء، استخدم مصحح A2A للتحقق من التواصل بين الوكلاء.

إذا كنت تنقل مشروعًا من Postman، استخدم استيراد Postman API لتقليل خطوات التصدير والرفع اليدوي.

إذا كنت تنشر وثائق API طويلة، فإن الشريط الجانبي لـ "اسأل الذكاء الاصطناعي" يساعد القراء على فهم الوثائق دون مغادرة الصفحة.

وإذا كان فريقك يستخدم بوابة نماذج داخلية أو خدمة مستضافة ذاتيًا، فإن دعم موفري النماذج المخصصين يجعل دمج هذا الإعداد داخل Apidog أسهل.

💬 انضم إلى المحادثة

تواصل مع مهندسي API الآخرين وفريق Apidog:

• انضم إلى مجتمعنا على Discord للمناقشات والدعم في الوقت الفعلي.
• شارك في مجتمعنا على Slack للمحادثات التقنية.
• تابعنا على X (تويتر) للحصول على آخر التحديثات.

ملاحظة: للحصول على التفاصيل الكاملة حول جميع التحديثات، تحقق من سجل تغييرات Apidog!

مع خالص التقدير،

فريق Apidog