Micro Agent

الوصف

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

تعمل الأداة عن طريق إنشاء حالة اختبار أولاً ثم إنتاج تعليمات برمجية بشكل تكراري حتى تجتاز جميع الاختبارات المحددة. هذه المنهجية التطوير الموجه بالاختبار (TDD) هي جوهر تصميم Micro Agent، مما يضمن أن التعليمات البرمجية التي تم إنشاؤها ليست وظيفية فحسب، بل قوية وقابلة للتحقق أيضًا. يؤكد المشروع على فلسفة الوكيل "المصغر"، مما يعني أنه يركز عمدًا على مهمة واحدة محددة جيدًا: كتابة الاختبارات ثم إنشاء تعليمات برمجية تجتاز تلك الاختبارات. هذا يتناقض مع الوكلاء الأكثر عمومية للذكاء الاصطناعي والتي يمكن أن تؤدي أحيانًا إلى أخطاء مركبة.

يدعم Micro Agent التكامل مع العديد من مزودي LLM المشهورين، بما في ذلك Claude و OpenAI و Ollama، بالإضافة إلى أي خدمات متوافقة مع OpenAI مثل Groq. يمكن للمستخدمين تكوين مفاتيح API الخاصة بهم والنماذج المفضلة مباشرةً من خلال واجهة سطر الأوامر. تقدم الأداة وضعين أساسيين للتشغيل: مطابقة اختبار الوحدة ووضع المطابقة المرئية التجريبي. في مطابقة اختبار الوحدة، يقدم المستخدمون نص اختبار يقوم Micro Agent بتنفيذه بعد كل محاولة لإنشاء التعليمات البرمجية. تسمح ميزة المطابقة المرئية، التي لا تزال قيد التطوير، للوكيل بمحاولة مطابقة تصميم معين عن طريق مقارنة مخرجات التعليمات البرمجية المعروضة مع لقطة شاشة.

التثبيت مباشر عبر npm، ويتطلب Node.js v18 أو أحدث. يمكن أن يكون البدء بسيطًا مثل تشغيل `micro-agent` في الوضع التفاعلي، والذي يوجه المستخدم خلال عملية إنشاء التعليمات البرمجية. لحالات الاستخدام الأكثر تقدمًا، يمكن للمستخدمين تحديد مسارات الملفات ونصوص الاختبار وملفات المطالبات وحتى الأهداف المرئية. يتضمن المشروع أيضًا خيارات لتكوين الحد الأقصى لعدد مرات التشغيل وإدارة الإعدادات من خلال أمر `config` مخصص أو متغيرات البيئة. نرحب بالمساهمات، مع التركيز على تحسين قدرات الوكيل وتجربة المستخدم.

الميزات الأساسية لـ Micro Agent

• إنشاء التعليمات البرمجية وتكرارها مدعوم بالذكاء الاصطناعي

• نهج التطوير الموجه بالاختبار

• يدعم مزودي LLM متعددين (Claude، OpenAI، Ollama، Groq)

• وضع تفاعلي لإنشاء التعليمات البرمجية الموجهة

• مطابقة اختبار الوحدة للتحقق من التعليمات البرمجية

• مطابقة مرئية تجريبية للالتزام بالتصميم

• مفاتيح API ونماذج قابلة للتكوين

• محاولات التشغيل القصوى قابلة للتخصيص

• التكامل مع Visual Copilot لتحويل Figma إلى تعليمات برمجية

• واجهة سطر الأوامر للتكوين والتنفيذ

البدء مع Micro Agent

1. 1

   التثبيت: قم بتشغيل `npm install -g @builder.io/micro-agent`

2. 2

   تكوين مفتاح API: استخدم `micro-agent config set OPENAI_KEY=<your token>` أو `micro-agent config set ANTHROPIC_KEY=<your token>`

3. 3

   تعيين النموذج: استخدم `micro-agent config set MODEL=<model name>` (على سبيل المثال، `gpt-4o`، `claude-3-5-sonnet-20241022`)

4. 4

   التشغيل التفاعلي: قم بتشغيل `micro-agent` واتبع المطالبات

5. 5

   التشغيل مع الاختبارات: استخدم `micro-agent <file path> -t "<test script>"`

6. 6

   التشغيل مع المطابقة المرئية: استخدم `micro-agent <file path> --visual <url>` (يتطلب مفتاح Anthropic API)

حالات استخدام Micro Agent

• تحسين التعليمات البرمجية الآلي
• مساعدة التطوير الموجه بالاختبار
• النماذج الأولية السريعة
• تقليل تصحيح الأخطاء اليدوي
• تنفيذ التصميم إلى التعليمات البرمجية
• تحسين إنشاء التعليمات البرمجية لـ LLM
• تعزيز إنتاجية المطور

الأسئلة الشائعة من Micro Agent

• ما هو Micro Agent وماذا يفعل؟

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

• ما هي مزودي LLM التي يدعمها Micro Agent؟

  يدعم Micro Agent مزودي Claude و OpenAI و Ollama وأي مزودين متوافقين مع OpenAI مثل Groq.

• كيف يضمن Micro Agent جودة التعليمات البرمجية؟

  إنه يطبق نهج التطوير الموجه بالاختبار، حيث يقوم بإنشاء تعليمات برمجية يجب أن تجتاز اختبارات الوحدة المحددة. يقوم بتكرار التعليمات البرمجية حتى يتم تلبية جميع حالات الاختبار.

• ما هو الجانب "المصغر" لـ Micro Agent؟

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

• هل يمكن لـ Micro Agent المساعدة في تنفيذ التصميم المرئي؟

  نعم، لدى Micro Agent ميزة مطابقة مرئية تجريبية تحاول مطابقة مخرجات التعليمات البرمجية المعروضة مع لقطة شاشة تصميم مقدمة. كما أنه يتكامل مع Visual Copilot لتحويل Figma إلى تعليمات برمجية.

• ما هي المتطلبات الأساسية لتثبيت Micro Agent؟

  يتطلب Micro Agent تثبيت Node.js v18 أو أحدث على نظامك.

• كيف أقوم بتكوين مفاتيح API لـ Micro Agent؟

  يمكنك تكوين مفاتيح API باستخدام سطر الأوامر، على سبيل المثال: `micro-agent config set OPENAI_KEY=<your token>` أو `micro-agent config set ANTHROPIC_KEY=<your token>`.

• هل يمكنني تحديد نموذج الذكاء الاصطناعي الذي يستخدمه Micro Agent؟

  نعم، يمكنك تعيين النموذج المفضل باستخدام `micro-agent config set MODEL=<model name>`، مثل `gpt-4o` أو `claude-3-5-sonnet-20241022`.

• ما هو وضع "مطابقة اختبار الوحدة"؟

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

• كيف يمكنني المساهمة في مشروع Micro Agent؟

  نرحب بالمساهمات. يمكنك تقديم طلبات السحب والتحقق من ملف `./CONTRIBUTING.md` للحصول على الإرشادات. تتوفر أيضًا قضايا تحمل علامة "good first issue" للمساهمين الجدد.

• ما هو العدد الافتراضي للمحاولات التي يقوم بها Micro Agent؟

  افتراضيًا، يحاول Micro Agent 10 محاولات. يمكن تغيير ذلك باستخدام العلامة `-m`، على سبيل المثال: `micro-agent ./file-to-edit.ts -m 20`.

• هل يتعامل Micro Agent مع عمليات متعددة الملفات معقدة؟

  لا، تم تصميم Micro Agent كوكيل "مصغر" ولا يحاول تثبيت وحدات، أو قراءة/كتابة ملفات متعددة، أو إجراء عمليات معقدة أخرى يمكن أن تؤدي إلى أخطاء كبيرة.