وكيل توثيق API والاختبارات الوظيفية
هذا المشروع عبارة عن مجموعة من الوكلاء الذين يعملون معًا لكتابة الوثائق والاختبارات الوظيفية لواجهة برمجة التطبيقات (API).
هنا هو سير العمل:
- ExtractEntrypointsAgent: قراءة ملف واستخراج التعليمات البرمجية لجميع نقاط الدخول لتوجيهات واجهة برمجة التطبيقات
- لكل نقطة دخول:
- WalkCallStackAgent: استرداد جميع الوظائف المتضمنة في مسار API
- DocumentationAgent: اكتب وثائق API وفقًا لرمز الوظائف
- WriteTestsAgent: اقرأ وثائق مسار واجهة برمجة التطبيقات (API) وقم بإدراج جميع حالات الاختبار المحتملة
- لكل حالة اختبار:
--- وصف ما هو مطلوب لاختبار الحالة الحالية (الإعداد، والتفكيك، والاختبار، والمطابقات، وما إلى ذلك)
--- استخدم وصف الاختبار ووثائق المسار والتعليقات من Jest runner (إن وجدت) لكتابة الكود
--- قم بتشغيل الكود
--- (كرر حتى تمر جميع الاختبارات)
يستخدم WriteTestsAgent سلسلة من مطلبين.
- يتم استخدام الموجه الأول لتركيز LLM على كتابة المواصفات المتوقعة لكل حالة اختبار
- يركز الموجه الثاني انتباه LLM على كتابة وتصحيح رمز الاختبار المقابل (يقوم بتحليل رسالة الخطأ من Jest runner لإصلاح الكود بشكل متكرر)
مثال
تم إنشاء الكود الموجود في الأمثلة/fastify/doc والأمثلة/fastify/tests بواسطة الوكلاء.
لتجرب بنفسك، قم بتشغيل npx ts-node run.ts وكن صبورًا
