ما الجديد في Apidog CLI: من مشغل الاختبار إلى طبقة سير عمل الوكيل

لطالما كان Apidog CLI نقطة الدخول عبر سطر الأوامر لتشغيل اختبارات API من الطرفية، أو داخل مسارات CI، أو ضمن سير عمل الأتمتة، أو من أنظمة خارجية.

جرّب Apidog اليوم

apidog run --project <projectId> --test-scenario <scenarioId> --environment <environmentId>

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

لذلك لم يعد CLI مجرد خطوة أخيرة لتشغيل اختبارات جاهزة. يجب أن يتيح أيضًا للوكلاء قراءة أصول API، إنشاء أو تحديث أصول الاختبار، التحقق من التغييرات المنظمة، كتابتها، ثم التحقق من النتيجة.

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

لماذا أصبح CLI أكثر أهمية مع وكلاء الذكاء الاصطناعي؟

الواجهات الرسومية مناسبة للبشر: مرئية، مرنة، ومفيدة للاستكشاف. أما وكلاء الذكاء الاصطناعي فيعملون بشكل أفضل مع:

• أوامر منظمة
• مدخلات قابلة للتوقع
• مخرجات قابلة للقراءة آليًا
• خطوات تحقق واضحة
• عمليات قابلة للتكرار

هنا يظهر دور CLI. فهو يوفر واجهة مستقرة للوصول إلى نفس الموارد التي يديرها المطورون داخل Apidog، مثل:

• واجهات API
• البيئات والمتغيرات
• حالات الاختبار
• سيناريوهات الاختبار
• مجموعات الاختبار
• التقارير
• عمليات الاستيراد والتصدير

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

من apidog run إلى سير عمل كامل لاختبار API

كانت تجربة CLI السابقة تركز أساسًا على تنفيذ الاختبارات. كان ذلك يجعل apidog run مفيدًا كبوابة جودة داخل CI، لكنه غالبًا ما يظهر في نهاية سير العمل فقط.

CLI المحدث يوسع التغطية عبر موارد Apidog الأساسية، بحيث يمكن للأتمتة المشاركة مبكرًا في دورة التطوير:

1. قراءة سياق المشروع.
2. إنشاء أو تحديث أصول الاختبار.
3. التحقق من JSON أو البنية قبل الكتابة.
4. كتابة التغييرات في Apidog.
5. قراءة المورد مرة أخرى.
6. تشغيل الاختبارات للتأكد من النتيجة.

يمكن استخدام CLI المحدث مع موارد مثل:

• المشاريع وبيانات تعريف المشروع
• تعاريف API
• البيئات والمتغيرات
• حالات الاختبار
• سيناريوهات الاختبار
• مجموعات الاختبار
• التقارير
• سير عمل الاستيراد والتصدير
• الحسابات، الفروع، المشغلون، وموارد المشروع ذات الصلة

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

حلقة أكثر أمانًا للاختبار المدفوع بالوكلاء

عندما يساعد وكيل ذكاء اصطناعي في تطوير أو اختبار API، لا تكمن المخاطرة فقط في توليد المحتوى. المخاطرة الأكبر هي كتابة محتوى مولّد داخل مشروع حقيقي دون تحقق كافٍ.

الحل العملي هو اعتماد حلقة آمنة:

1. يقرأ الوكيل المورد الحالي.
2. يولّد التغيير المطلوب.
3. يتحقق من البنية باستخدام CLI.
4. يكتب التغيير.
5. يقرأ المورد مرة أخرى.
6. يشغل الاختبارات أو التحقق المناسب.

هذه الحلقة مهمة لأن موارد Apidog منظمة. على سبيل المثال، قد تتضمن حالة الاختبار أو سيناريو الاختبار:

• بيانات الطلب
• التأكيدات assertions
• استخراج المتغيرات
• المعالجات المسبقة pre-processors
• المعالجات اللاحقة post-processors
• ترتيب الخطوات
• الإشارات إلى البيئات
• تفاصيل أخرى مرتبطة بالتنفيذ

إذا خمّن الوكيل البنية، فقد يؤدي خطأ صغير إلى فشل الكتابة، أو ظهور غير مكتمل في واجهة المستخدم، أو اختبار يعمل بطريقة غير متوقعة.

لهذا السبب يعد cli-schema جزءًا مهمًا من الترقية. قبل كتابة ملف JSON معقد في Apidog، يمكن للوكيل أو السكريبت التحقق من مطابقته للمخطط المتوقع.

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 تمنح الوكيل القدرة على التنفيذ. أما المهارات Skills فتمنحه إرشادات تشغيلية حول كيفية استخدام هذه الأوامر بشكل صحيح.

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

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

على سبيل المثال، عند إنشاء سيناريو اختبار متعدد الخطوات، النمط الأكثر أمانًا غالبًا هو:

1. إنشاء السيناريو الأساسي.
2. استيراد الخطوات من واجهات API أو حالات اختبار موجودة.
3. قراءة بنية السيناريو الكاملة مرة أخرى.
4. تحديث التأكيدات أو المتغيرات أو المعالجات على دفعات صغيرة.
5. التحقق من السيناريو وتشغيله.

تساعد المهارات الوكلاء على تجنب أخطاء مثل:

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

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

تغييرات أكثر أمانًا باستخدام فروع الذكاء الاصطناعي

عندما يعدّل وكيل موارد المشروع، يجب أن تكون التغييرات قابلة للمراجعة والعزل. لذلك يمكن استخدام CLI المحدث مع فروع الذكاء الاصطناعي AI Branches.

النمط العملي هو:

1. ينشئ الوكيل التغييرات داخل فرع معزول.
2. يراجع الفريق الاختلافات.
3. يتم تأكيد النتيجة.
4. تُدمج التغييرات في الفرع المستهدف عند الموافقة.

بهذا لا تؤثر التغييرات الآلية مباشرة على الفرع الرئيسي أو فرع التعاون المشترك.

أمثلة سير عمل عملية

1. توليد اختبارات من تعاريف API

يمكن للوكيل تنفيذ سير عمل مثل:

1. قراءة تعاريف API من مشروع Apidog.
2. توليد حالات اختبار.
3. التحقق من JSON الناتج باستخدام cli-schema.
4. كتابة حالات الاختبار في Apidog.
5. قراءتها مرة أخرى.
6. تشغيل التحقق.

بهذا لا يكون توليد الاختبارات مجرد اقتراح نصي، بل عملية قابلة للتحقق والتنفيذ.

2. صيانة سيناريوهات الاختبار المعقدة

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

النمط الأكثر أمانًا:

1. استيراد الخطوات من واجهات API أو حالات اختبار موجودة.
2. قراءة السيناريو الكامل.
3. تحديث التأكيدات أو المتغيرات أو المعالجات.
4. تشغيل التحقق.

apidog test-scenario import-steps <scenarioId> --project <projectId> --source endpoint --ids <endpointIds> --sync manual
apidog test-scenario get <scenarioId> --project <projectId> --with-case-detail

3. نقل وإعادة إنتاج أصول المشروع

يحسن CLI المحدث أيضًا سير عمل الاستيراد والتصدير لبيانات Apidog الأصلية. هذا مفيد في حالات مثل:

• ترحيل المشاريع
• إعادة إنتاج بيئات العملاء
• نسخ إعدادات الاختبار
• نقل واجهات API والمخططات وحالات الاختبار والسيناريوهات بين المشاريع

apidog export --project <projectId> --format apidog --output ./project.apidog.json
apidog import --project <projectId> --format apidog --file ./project.apidog.json

4. الحفاظ على بوابات جودة CI

القدرات الجديدة الموجهة للوكلاء لا تستبدل CI. بل تكمله.

لا يزال apidog run نقطة الدخول الأساسية لتشغيل الاختبارات الآلية وتوليد التقارير داخل CI.

apidog run --project <projectId> --test-scenario <scenarioId> --environment <environmentId> -r "cli,html,junit" --out-dir ./apidog-reports

يمكن استخدام هذا الأمر داخل pipeline لضمان أن تغييرات API لا تتجاوز بوابة الجودة قبل الدمج أو النشر.

البدء

إذا كان 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?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation

أو ثبّته / حدّثه يدويًا:

npm install -g apidog-cli@latest

للمرجع الكامل للأوامر، راجع خيارات Apidog CLI.

جرّب أول مهمة مع وكيلك

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

انسخ المطالبة التالية إلى وكيل الذكاء الاصطناعي الخاص بك:

استخدم Apidog CLI لمساعدتي في إنشاء أول نقطة نهاية API في Apidog. أولاً، تحقق من إعداد Apidog CLI الخاص بي واسرد المشاريع التي يمكنني الوصول إليها. اسألني عن المشروع الذي يجب استخدامه. بعد أن أؤكد، أنشئ نقطة نهاية GET /health بسيطة باسم Health Check مع مثال استجابة 200. تحقق من أي إدخال منظم قبل الكتابة، ثم اقرأ نقطة النهاية مرة أخرى ولخص ما تم إنشاؤه.

هذه المهمة تمنح المستخدم الجديد مسارًا عمليًا:

1. يتحقق الوكيل من إعداد CLI.
2. يسأل قبل الكتابة إلى المشروع.
3. ينشئ تعريف API صغيرًا.
4. يتحقق من البنية قبل الكتابة.
5. يقرأ النتيجة المحفوظة مرة أخرى.

الخطوات التالية

• قم بتنزيل Apidog لتصميم واجهات API، تصحيحها، اختبارها، وتوثيقها في مساحة عمل واحدة.
• تعرف على المزيد حول Apidog CLI لاختبار API عبر سطر الأوامر، أتمتة CI، وسير عمل وكلاء الذكاء الاصطناعي.

الأسئلة الشائعة

ما هو Apidog CLI؟

Apidog CLI هو أداة سطر أوامر لتشغيل اختبارات API، العمل مع موارد مشروع Apidog، وربط أصول API والاختبار بسير عمل الأتمتة.

هل يمكن لـ Apidog CLI تشغيل اختبارات API داخل CI؟

نعم. يمكن استخدام apidog run داخل مسارات CI لتشغيل اختبارات API، توليد التقارير، والحفاظ على بوابات الجودة الآلية.

كيف يساعد Apidog CLI وكلاء الذكاء الاصطناعي؟

يوفر Apidog CLI طريقة منظمة للوكلاء من أجل قراءة معلومات API، توليد أو تحديث أصول الاختبار، التحقق من التغييرات، كتابتها في Apidog، قراءة النتيجة مرة أخرى، ثم تشغيل الاختبارات.

ما هو cli-schema في Apidog CLI؟

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

كيف أقوم بتثبيت Apidog CLI؟

يمكنك تثبيته يدويًا باستخدام:

npm install -g apidog-cli@latest

أو يمكنك أن تطلب من وكيل الذكاء الاصطناعي اتباع دليل التثبيت وتثبيت CLI مع المهارات المصاحبة.