# Agent Mode (/ar/docs/verdent-manager/advanced-features/agent-mode)

> تنفيذ مهام وكيلة مع شفافية كاملة في كل إجراء



يُعد Agent Mode وضع التنفيذ الافتراضي في Verdent حيث يتخذ الوكيل إجراءات مباشرة بناءً على تعليماتك. وبدلاً من جلسات التخطيط المنظمة، يُعطي Agent Mode الأولوية للتنفيذ السريع مع الحفاظ على شفافية كاملة.

## ما ستتعلمه [#ما-ستتعلمه]

* الحالات التي يكون فيها Agent Mode الخيار الأمثل
* كيفية عمل سير عمل التنفيذ
* إدارة الأذونات والرؤية

***

## متى يكون Agent Mode مفيدًا [#متى-يكون-agent-mode-مفيدًا]

يعمل Agent Mode بأفضل شكل عندما تكون لديك رؤية واضحة لما يجب تنفيذه:

| السيناريو         | الوضع                                                                                  | كيف يساعد Verdent                                                 |
| ----------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| **متطلبات واضحة** | تعرف بالضبط ما تريد تنفيذه. المهمة محددة بوضوح ولها نتيجة محددة.                       | يبدأ الوكيل التنفيذ مباشرة. لا عبء تخطيط، فقط نتائج.              |
| **تكرارات سريعة** | تعمل في حلقة تغذية راجعة سريعة، وتُجري تغييرات تدريجية بناءً على النتائج.              | تتيح لك دورات التنفيذ السريعة رؤية التغييرات فورًا وتعديل المسار. |
| **مهام مباشرة**   | إصلاح الأخطاء، أو الميزات الصغيرة، أو تنظيف الكود، أو إعادة الهيكلة ذات النطاق الواضح. | ينهي الوكيل العمل بفعالية دون تبادل غير ضروري.                    |

***

## سير عمل Agent Mode [#سير-عمل-agent-mode]

<Steps>
  <Step title="أرسل طلبك">
    صِف ما تريد تنفيذه. التعليمات الواضحة والمحددة تعمل بأفضل شكل في Agent Mode.
  </Step>

  <Step title="الوكيل يتخذ الإجراء">
    يبدأ Verdent التنفيذ فورًا. تظهر تعديلات الملفات واستخدام الأدوات والتقدم في الوقت الفعلي.
  </Step>

  <Step title="طلبات الأذونات">
    تتطلب بعض الإجراءات موافقة. راجع ووافق للمتابعة.
  </Step>

  <Step title="اطلع على النتائج">
    يكتمل العمل مع رؤية كاملة لما تغيّر وسبب ذلك.
  </Step>
</Steps>

***

## الخصائص الأساسية [#الخصائص-الأساسية]

| الخاصية             | الوصف                                                          |
| ------------------- | -------------------------------------------------------------- |
| **الوضع الافتراضي** | تبدأ المهام الجديدة في Agent Mode إلا إذا انتقلت إلى Plan Mode |
| **إجراء مباشر**     | يمضي الوكيل في التنفيذ بدلاً من التخطيط المكثف                 |
| **رؤية كاملة**      | تُعرض تعديلات الملفات واستخدام الأدوات والتقدم في الوقت الفعلي |
| **توضيح ضمني**      | تظهر الأسئلة بشكل طبيعي في المحادثة، لا كاستبيانات منظمة       |

***

## Agent Mode مقابل Plan Mode [#agent-mode-مقابل-plan-mode]

اختر بناءً على وضوح المهمة وتعقيدها:

<Tabs>
  <Tab title="استخدم Agent Mode عندما">
    يكون Agent Mode مثاليًا في الحالات التالية:

    * متطلبات واضحة ومحددة جيدًا
    * مهام تنفيذ مباشرة
    * تكرارات سريعة وحلقات تغذية راجعة
    * مهام تكون واثقًا من نهجها
    * إصلاح الأخطاء والميزات الصغيرة
  </Tab>

  <Tab title="استخدم Plan Mode عندما">
    انتقل إلى Plan Mode في الحالات التالية:

    * ميزات معقدة متعددة الخطوات
    * أفكار غير مكتملة أو متطورة
    * قرارات معمارية
    * مهام تتطلب استكشافًا قبل التنفيذ
    * عندما تريد توضيح المتطلبات بشكل منظم
  </Tab>
</Tabs>

***

## الأذونات في Agent Mode [#الأذونات-في-agent-mode]

ينفذ Agent Mode المهام مباشرة، لكن بعض الإجراءات لا تزال تتطلب موافقة صريحة:

* تعديلات الملفات خارج النطاق المتوقع
* العمليات المدمرة
* تنفيذ أدوات معينة
* الإجراءات ذات الآثار الجانبية الكبيرة

<Note>
  تحمي طلبات الأذونات من التغييرات غير المقصودة مع الحفاظ على سرعة التنفيذ للعمليات الروتينية.
</Note>

***

## الأسئلة الشائعة [#الأسئلة-الشائعة]

<AccordionGroup>
  <Accordion title="هل Agent Mode هو الوضع الافتراضي؟">
    نعم. تبدأ المهام الجديدة في Agent Mode. انتقل إلى Plan Mode عندما تحتاج إلى تخطيط منظم.
  </Accordion>

  <Accordion title="هل يطرح الوكيل أسئلة في Agent Mode؟">
    نعم، عند الحاجة. تظهر الأسئلة ضمن المحادثة بدلاً من استبيانات منظمة. قد يمضي الوكيل قدمًا دون طرح أسئلة إذا كانت المهمة واضحة بما فيه الكفاية.
  </Accordion>

  <Accordion title="كيف أنتقل إلى Plan Mode؟">
    اضغط `Shift+Tab` (نظام macOS: `Cmd+.`؛ نظام Windows: `Ctrl+.`) للتبديل بين الأوضاع. يتوفر تبديل الوضع في نقاط معينة، لا خلال التنفيذ النشط.
  </Accordion>

  <Accordion title="هل يتجاوز Agent Mode جميع طلبات التأكيد؟">
    لا. لا تزال بعض الإجراءات تتطلب موافقة. يقلل Agent Mode من العوائق في العمليات الروتينية مع الحفاظ على السلامة في التغييرات الكبيرة.
  </Accordion>

  <Accordion title="متى يجب أن أستخدم Plan Mode بدلًا من ذلك؟">
    استخدم Plan Mode للميزات المعقدة، أو القرارات المعمارية، أو عندما تريد استكشاف المتطلبات وتنقيحها قبل بدء التنفيذ.
  </Accordion>
</AccordionGroup>