البناء لوكلاء الذكاء الاصطناعي: رحلة Apidog CLI

هذه سلسلة من 10 أجزاء تشرح كيف طوّرت Apidog أداة Apidog CLI، وهي أداة سطر أوامر لاختبار واجهات API.

جرّب Apidog اليوم

بنينا 126 أداة MCP. ثم اكتشفنا أنها ليست الحل الأفضل للوكلاء.

عندما أصبح MCP محورًا مهمًا في الصناعة، كان السؤال المتكرر بسيطًا:

هل لديك MCP؟

كان Apidog MCP يعمل بالفعل، لكن عند استخدامه داخل سير عمل أكثر تعقيدًا ظهرت قيود واضحة.

الخلاصة التي وصلنا إليها:

MCP ممتاز في ربط الأدوات، لكن المهام المعقدة تحتاج إلى عمليات هندسية قابلة للتنفيذ، قابلة للتكرار، ويمكن تشغيلها من سطر الأوامر أو داخل بيئات CI/CD.

---

ما هو Apidog CLI؟

Apidog CLI هو أداة سطر أوامر لاختبار API تتيح لك تشغيل سيناريوهات الاختبار وإدارة وثائق API بطريقة عملية من الطرفية.

بدل الاعتماد فقط على تشغيل الاختبارات يدويًا من الواجهة، يمكنك استخدام CLI لتضمين اختبار API ضمن سير العمل الهندسي اليومي، مثل:

• تشغيل اختبارات API محليًا أثناء التطوير.
• التحقق من السيناريوهات قبل الدمج.
• إدخال اختبارات API ضمن خطوط CI/CD.
• جعل الاختبارات قابلة للتكرار والتنفيذ بنفس الطريقة بين أعضاء الفريق.

لماذا نحتاج CLI بدل الاكتفاء بـ MCP؟

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

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

بمعنى آخر، MCP يربط الأدوات، بينما CLI يجعل العملية قابلة للتنفيذ كجزء من النظام الهندسي.

كيف تفكر في استخدام Apidog CLI؟

يمكنك التعامل مع Apidog CLI كطبقة تنفيذ لاختبارات API.

سير العمل النموذجي يكون كالتالي:

1. عرّف واجهات API وسيناريوهات الاختبار في Apidog.
2. استخدم CLI لتشغيل هذه السيناريوهات من سطر الأوامر.
3. افحص النتائج محليًا أو داخل CI.
4. اجعل فشل الاختبارات يمنع الدمج أو النشر عند الحاجة.

مثال مبسط لسير العمل:

# تشغيل سيناريوهات اختبار API من الطرفية
apidog run

وفي بيئة CI يمكن أن يصبح الأمر جزءًا من pipeline:

steps:
  - name: Run API tests
    run: apidog run

الفكرة الأساسية ليست في الأمر نفسه فقط، بل في تحويل اختبار API إلى خطوة قابلة للتنفيذ آليًا.

ما الذي تغيّر في طريقة العمل؟

قبل استخدام CLI، يكون اختبار API غالبًا مرتبطًا بالواجهة أو بخطوات يدوية.

بعد استخدام CLI، يصبح الاختبار جزءًا من العملية الهندسية:

• المطور يشغّل الاختبارات قبل إرسال التغييرات.
• الفريق يراجع نتائج موحدة.
• CI يعيد تشغيل نفس السيناريوهات تلقائيًا.
• الأخطاء تظهر مبكرًا بدل اكتشافها بعد الدمج أو النشر.

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

الخلاصة

Apidog MCP لا يزال مفيدًا في ربط الأدوات وتمكين الوكلاء من التفاعل معها.

لكن عند بناء سير عمل اختبار API قابل للتكرار والتنفيذ، يصبح CLI خيارًا أكثر ملاءمة.

Apidog CLI يوفّر طريقة عملية لتشغيل سيناريوهات الاختبار وإدارة وثائق API من سطر الأوامر، مما يجعله مناسبًا للاستخدام المحلي وداخل بيئات الأتمتة وCI/CD.