لطالما كان Apidog CLI نقطة الدخول عبر سطر الأوامر لتشغيل اختبارات API من طرفية، أو مسار تكامل مستمر (CI)، أو سير عمل الأتمتة، أو نظام خارجي.
apidog run --project <projectId> --test-scenario <scenarioId> --environment <environmentId>لا يزال هذا الأساس مهمًا. لا تزال الفرق بحاجة إلى طريقة موثوقة لتشغيل اختبارات API، وتوليد التقارير، والحفاظ على بوابات الجودة داخل CI. لكن تطوير API يتغير. يشارك وكلاء الذكاء الاصطناعي (AI Agents) الآن في تصميم API، وتوليد الاختبارات، وتصحيح الأخطاء، والترحيل، والصيانة.
بالنسبة لسير العمل هذه، لا يمكن أن يكون CLI مجرد الخطوة الأخيرة التي تشغل الاختبارات الموجودة. بل يحتاج أيضًا إلى منح الوكلاء طريقة مستقرة لقراءة أصول API، وإنشاء أو تحديث أصول الاختبار، والتحقق من التغييرات المنظمة، وإعادة كتابتها، والتحقق من النتيجة.
يحافظ Apidog CLI المحدث على أساس تشغيل الاختبارات الأصلي ويوسعه إلى طبقة سير عمل للمطورين والسكريبتات ووكلاء الذكاء الاصطناعي. يشرح هذا المقال سبب تزايد أهمية CLI في عصر وكلاء الذكاء الاصطناعي، وما الذي تغير في Apidog CLI، وكيف يمكن للفرق البدء في استخدامه لأتمتة اختبار API.
لماذا يكتسب CLI أهمية أكبر في عصر وكلاء الذكاء الاصطناعي
تم تصميم الواجهات الرسومية للأشخاص. إنها بصرية ومرنة ومفيدة للاستكشاف. ومع ذلك، يعمل وكلاء الذكاء الاصطناعي بشكل أفضل مع الأوامر المنظمة، والمدخلات المتوقعة، والمخرجات المتوقعة، وخطوات التحقق الواضحة.
هنا تبرز أهمية CLI. يوفر CLI للوكلاء والسكريبتات واجهة قابلة للتكرار لنفس الموارد التي يديرها المطورون في Apidog: واجهات برمجة التطبيقات (APIs)، والبيئات، والمتغيرات، وحالات الاختبار، وسيناريوهات الاختبار، ومجموعات الاختبار، والتقارير، وبيانات الاستيراد/التصدير، والمزيد.
عمليًا، هذا يعني أن Apidog يمكن أن يخدم كلاً من المستخدمين البشريين وسير العمل الآلي. يستمر الأشخاص في التصميم، وتصحيح الأخطاء، والمراجعة، والتعاون في واجهة المنتج. يمكن للوكلاء والأتمتة استخدام CLI لإجراء عمليات محكمة حول نفس هذه الأصول.
من apidog run إلى سير عمل كامل لواجهة برمجة التطبيقات والاختبار
ركزت تجربة CLI السابقة بشكل أساسي على تنفيذ الاختبارات. جعل ذلك apidog run مفيدًا كبوابة جودة CI، ولكنه عنى أيضًا أن CLI عادة ما يظهر قرب نهاية سير العمل. يوسع CLI المحدث التغطية عبر المزيد من موارد Apidog الأساسية، بحيث يمكن للأتمتة المشاركة في وقت مبكر: قراءة سياق المشروع، وإعداد أصول الاختبار، والتحقق من التغييرات المنظمة، ثم تشغيل التحقق.
باستخدام CLI المحدث، يمكن للمستخدمين والوكلاء العمل مع موارد مثل:
- المشاريع وبيانات تعريف المشروع
- واجهات برمجة التطبيقات وتعاريف API
- البيئات والمتغيرات
- حالات الاختبار
- سيناريوهات الاختبار
- مجموعات الاختبار
- التقارير
- سير عمل الاستيراد والتصدير
- الحسابات والفروع والمشغلون وموارد المشروع ذات الصلة
يغير هذا دور Apidog CLI. لم يعد مجرد طريقة لتنفيذ الاختبارات بعد الانتهاء من كل شيء آخر. يمكنه الآن المشاركة في وقت مبكر من حلقة التطوير، حيث يحتاج الوكيل إلى فهم المشروع، وتوليد أو تحديث أصول الاختبار، والتحقق من التغييرات، ثم تشغيل التحقق.
حلقة أكثر أمانًا للاختبار المدفوع بالوكلاء
عندما يساعد وكيل الذكاء الاصطناعي في تطوير أو اختبار API، فإن الجزء الخطر ليس فقط توليد المحتوى. الجزء الخطر هو كتابة المحتوى المولّد في مشروع حقيقي دون بنية أو تحقق كافيين.
يجعل CLI المحدث حلقة أكثر أمانًا ممكنة:
هذه الحلقة مهمة لأن العديد من موارد Apidog منظمة. يمكن أن تتضمن حالات الاختبار وسيناريوهات الاختبار بيانات الطلب، والتأكيدات، واستخراج المتغيرات، والمعالجات المسبقة (pre-processors)، والمعالجات اللاحقة (post-processors)، وترتيب الخطوات، والإشارات إلى البيئات، وتفاصيل أخرى. إذا خمّن الوكيل البنية، فإن الأخطاء الصغيرة يمكن أن تسبب فشل الكتابة، أو عرضًا غير مكتمل في واجهة المستخدم، أو اختبارات لا تتصرف كما هو متوقع.
لهذا السبب يعد cli-schema جزءًا مهمًا من الترقية. قبل كتابة ملف JSON معقد في Apidog، يمكن للوكيل أن يطلب من CLI التحقق مما إذا كانت الحقول والبنية تتطابق مع المخطط المتوقع.
apidog cli-schema validate test-case-create --file ./test-case-create.json
apidog cli-schema validate test-scenario-update --file ./scenario-update.jsonباختصار: دع الوكيل يولد، ولكن دع CLI يتحقق قبل حدوث الكتابة.
يمكن لـ CLI أيضًا توفير تلميحات موجهة للوكلاء في مخرجات الأوامر. بعد إنشاء مورد أو تحديثه، غالبًا ما لا تكون الخطوة التالية "التوقف". يجب أن يقرأ وكيل أكثر موثوقية المورد المحفوظ مرة أخرى، ويؤكد البنية، ويشغل الاختبارات عند الاقتضاء. تساعد هذه التلميحات الوكلاء على التحرك عبر سير العمل مع عدد أقل من النقاط العمياء.
المهارات تمنح الوكلاء حكمًا تشغيليًا
تمنح أوامر CLI الوكيل قوة تنفيذ. وتمنح المهارات الوكيل حكمًا تشغيليًا.
المهارة (SKILL) ليست مجرد مرجع للأوامر. إنها أقرب إلى دليل تشغيل مكتوب لوكلاء الذكاء الاصطناعي: متى تستخدم أمرًا، وما هو الأمر الذي يجب أن يأتي أولاً، وما هي الحقول التي لا ينبغي تخمينها، ومتى يجب التحقق، ومتى يجب القراءة مرة أخرى، ومتى يجب تشغيل الاختبارات.
على سبيل المثال، لا ينبغي لوكيل موثوق أن يكتب دائمًا سيناريو اختبار كبير يدويًا من الصفر. غالبًا ما يكون النمط الأكثر أمانًا هو:
- إنشاء السيناريو الأساسي.
- استيراد الخطوات من واجهات برمجة التطبيقات أو حالات الاختبار الموجودة.
- قراءة بنية السيناريو الكاملة مرة أخرى.
- تحديث التأكيدات، أو استخراج المتغيرات، أو المعالجات في خطوات أصغر.
- التحقق من السيناريو وتشغيله.
تُظهر المهارات هذه الأنماط بشكل صريح. إنها تساعد الوكلاء على تجنب الأخطاء الشائعة مثل استخدام اسم حقل خاطئ، أو اختيار قيمة تعداد خاطئة، أو تخطي التحقق من المخطط، أو افتراض أن الكتابة الناجحة تعني أن المورد النهائي صحيح بالفعل.
يوفر Apidog ثماني مهارات مصاحبة لمساعدة الوكلاء على فهم أوامر CLI، وهياكل الموارد، وسير عمل المهام. معًا، يجعل CLI والمهارات Apidog أكثر عملية لتطوير واختبار API بمساعدة الذكاء الاصطناعي.
تغييرات مشروع أكثر أمانًا باستخدام فروع الذكاء الاصطناعي
عندما يقوم وكيل بتعديل موارد المشروع، فإن السلامة وقابلية المراجعة مهمة. لهذا السبب، يمكن أيضًا استخدام CLI المحدث مع فروع الذكاء الاصطناعي (AI Branches).
يمكن للوكيل إجراء التغييرات في فرع معزول أولاً. يمكن للفريق مراجعة الاختلافات، وتأكيد النتيجة، ثم دمجها في الفرع المستهدف. يساعد هذا في منع التغييرات الآلية من التأثير مباشرة على الفرع الرئيسي أو فرع التعاون المشترك.
ما يتيحه هذا في سير العمل الحقيقي
تتضح قيمة CLI المحدث بسهولة أكبر في سير العمل الملموس.
توليد الاختبارات من تعاريف API
يمكن للوكيل قراءة تعاريف API من مشروع، وتوليد حالات اختبار، والتحقق من JSON المولّد باستخدام cli-schema، وكتابة حالات الاختبار في Apidog، وقراءتها مرة أخرى، وتشغيل التحقق. يحول هذا توليد الاختبارات من مجرد اقتراح لمرة واحدة إلى سير عمل متحكم فيه.
صيانة سيناريوهات الاختبار المعقدة
بالنسبة للسيناريوهات متعددة الخطوات، يمكن للوكيل استيراد الخطوات من واجهات برمجة التطبيقات أو حالات الاختبار الموجودة أولاً، ثم تحديث التأكيدات، أو المتغيرات، أو المعالجات بعد قراءة البنية الكاملة. يقلل هذا من خطر بناء سيناريو كبير بشكل غير صحيح في تمريرة واحدة.
apidog test-scenario import-steps <scenarioId> --project <projectId> --source endpoint --ids <endpointIds> --sync manual
apidog test-scenario get <scenarioId> --project <projectId> --with-case-detailنقل وإعادة إنتاج أصول المشروع
يحسن CLI المحدث أيضًا سير عمل الاستيراد والتصدير لبيانات Apidog الأصلية. هذا مفيد لترحيل المشاريع، وإعادة إنتاج بيئات العملاء، ونسخ إعدادات الاختبار، أو نقل واجهات برمجة التطبيقات، والمخططات، وحالات الاختبار، والسيناريوهات عبر المشاريع.
apidog export --project <projectId> --format apidog --output ./project.apidog.json
apidog import --project <projectId> --format apidog --file ./project.apidog.jsonالحفاظ على بوابات جودة CI
لا تحل القدرات الجديدة الجاهزة للوكلاء محل CI. بل تكملها. لا تزال الفرق تستخدم apidog run كنقطة دخول أساسية لتنفيذ الاختبارات الآلي والتقارير.
apidog run --project <projectId> --test-scenario <scenarioId> --environment <environmentId> -r "cli,html,junit" --out-dir ./apidog-reportsالبدء
إذا كان لديك Apidog CLI مثبتًا بالفعل، فتحقق من إصدارك الحالي أولاً:
apidog -vإذا كان إصدار Apidog CLI الخاص بك أقدم من 2.2.5، فقم بتحديث CLI قبل استخدام القدرات الجديدة. يشير رقم الإصدار هذا إلى Apidog CLI، وليس تطبيق Apidog.
يمكنك أن تطلب من وكيل الذكاء الاصطناعي الذي تستخدمه تثبيت كل من Apidog CLI والمهارات المصاحبة عن طريق نسخ هذا المطالبة:
اقرأ التعليمات وساعدني في تثبيت Apidog CLI:
https://apidog.com/apidog-cli-installation-guide.mdإذا كنت تفضل تثبيته أو تحديثه يدويًا، قم بتشغيل:
npm install -g apidog-cli@latestللاطلاع على المرجع الكامل للأوامر، انظر خيارات Apidog CLI.
جرب مهمة وكيلك الأولى
بعد تثبيت CLI والمهارات، أسهل طريقة للبدء هي إعطاء وكيلك مهمة API صغيرة ومنخفضة المخاطر. على سبيل المثال، اطلب منه إنشاء نقطة نهاية بسيطة لفحص الصحة في مشروع Apidog، ثم قراءتها مرة أخرى لتأكيد النتيجة.
انسخ هذه المطالبة إلى وكيل الذكاء الاصطناعي الخاص بك:
استخدم Apidog CLI لمساعدتي في إنشاء أول نقطة نهاية API في Apidog. أولاً، تحقق من إعداد Apidog CLI الخاص بي واسرد المشاريع التي يمكنني الوصول إليها. اسألني عن المشروع الذي يجب استخدامه. بعد أن أؤكد، أنشئ نقطة نهاية GET /health بسيطة باسم Health Check مع مثال استجابة 200. تحقق من أي إدخال منظم قبل الكتابة، ثم اقرأ نقطة النهاية مرة أخرى ولخص ما تم إنشاؤه.يمنح هذا المستخدمين الجدد نقطة انطلاق ملموسة: يتحقق الوكيل من الإعداد، ويسأل قبل الكتابة إلى مشروع، وينشئ تعريف API صغيرًا، ويؤكد النتيجة المحفوظة.
الخطوات التالية:
- قم بتنزيل Apidog لتصميم واجهات برمجة التطبيقات، وتصحيحها، واختبارها، وتوثيقها في مساحة عمل واحدة.
- تعرف على المزيد حول Apidog CLI لاختبار API عبر سطر الأوامر، وأتمتة CI، وسير عمل وكلاء الذكاء الاصطناعي.
الأسئلة الشائعة
ما هو Apidog CLI؟
Apidog CLI هو أداة سطر أوامر لتشغيل اختبارات API، والعمل مع موارد مشروع Apidog، وربط أصول API والاختبار في Apidog بسير عمل الأتمتة.
هل يمكن لـ Apidog CLI تشغيل اختبارات API في CI؟
نعم. يمكن للفرق استخدام apidog run في مسارات CI لتشغيل اختبارات API، وتوليد التقارير، والحفاظ على بوابات الجودة الآلية في سير عمل الاختبار الخاص بهم.
كيف يساعد Apidog CLI وكلاء الذكاء الاصطناعي؟
يوفر Apidog CLI لوكلاء الذكاء الاصطناعي طريقة منظمة لقراءة معلومات API، وتوليد أو تحديث أصول الاختبار، والتحقق من التغييرات، وكتابتها في Apidog، وقراءة النتيجة مرة أخرى، وتشغيل الاختبارات للتحقق.
ما هو cli-schema في Apidog CLI؟
يساعد cli-schema في التحقق من ملفات JSON المعقدة قبل كتابتها في Apidog. يقلل هذا من فشل الكتابة، والحقول غير الصالحة، وحلقات إعادة المحاولة غير الضرورية عندما يقوم الوكلاء بإنشاء أو تحديث حالات الاختبار وسيناريوهات الاختبار.
كيف أقوم بتثبيت Apidog CLI؟
يمكنك أن تطلب من وكيل الذكاء الاصطناعي اتباع دليل تثبيت Apidog CLI وتثبيت كل من CLI والمهارات المصاحبة، أو تثبيته يدويًا باستخدام npm install -g apidog-cli@latest.