تخصيص Gemini باستخدام ملفات AGENTS.md

يمكنك تزويد "Gemini في استوديو Android" بتعليمات مخصّصة باستخدام ملف واحد أو أكثر من ملفات AGENTS.md. يتم وضع ملفات AGENTS.md بجانب الملفات الأخرى في قاعدة الرموز البرمجية، لذا من السهل إضافتها إلى نظام التحكّم في الإصدار (VCS) ومشاركة التعليمات الخاصة بالمشروع وقواعد نمط الترميز والإرشادات الأخرى مع فريقك بالكامل.

للبدء، اتّبِع الخطوات التالية:

1. أنشِئ ملف AGENTS.md في أي مكان في نظام ملفات مشروعك. يفحص Gemini الدليل الحالي وجميع الأدلة الرئيسية بحثًا عن ملفات AGENTS.md عند إرسال طلب بحث. لمزيد من التفاصيل، اطّلِع على مقالة طريقة عمل ملفات AGENTS.md.

2. أضِف تعليماتك. اكتب تعليماتك باستخدام Markdown. لتحسين إمكانية القراءة، ننصحك باستخدام العناوين والنقاط النقطية لقواعد مختلفة. اطّلِع على تعليمات مثال.

3. احفظ الملف وأضِفه إلى نظام التحكّم في الإصدار لمشاركته مع فريقك.

إدارة ملفات AGENTS.md كبيانات سياقية

يمكنك تطبيق ملفات AGENTS.md أو إزالتها كبيانات سياقية لطلب بحث معيّن باستخدام لوحة السياق في لوحة المحادثة. يتضمّن الخيار ملفات AGENTS.md جميع ملفات AGENTS.md في الدليل الحالي والأدلة الرئيسية.

تعليمات مثال

يمكنك استخدام ملف AGENTS.md لتزويد الوكيل بالتعليمات. في ما يلي بعض الأمثلة، ولكن يجب أن تكون التعليمات التي تقدّمها خاصة بمشروعك.

• "النشاط الرئيسي هو /path/to/MainActivity.kt."
• "الرمز البرمجي الذي يتيح التنقّل بين الشاشات هو path/to/navigation/UiNavigation.kt"
• الرمز البرمجي الذي يعالج طلبات HTTP موجود في <path>.
• بنية المشروع
  • "ضَع كل منطق النشاط التجاري في ViewModels."
  • "اتّبِع دائمًا توصيات البنية الرسمية، بما في ذلك استخدام بنية متعددة الطبقات. استخدِم تدفق بيانات أحادي الاتجاه (UDF)، وViewModels، وجمع حالة واجهة المستخدم التي تراعي مراحل النشاط، وغيرها من التوصيات."
• المكتبات المفضّلة: "استخدِم مكتبة <library name> للتنقّل."
• تحديد أسماء العناصر النائبة لخدمات واجهة برمجة التطبيقات الشائعة أو المصطلحات الداخلية: "يُشار إلى خدمة الخلفية الأساسية باسم PhotoSift-API."
• أدلة الأنماط الخاصة بالشركة: "يجب إنشاء جميع مكوّنات واجهة المستخدم الجديدة باستخدام Jetpack Compose. لا تقترح تنسيقات مستندة إلى XML."

تقسيم ملفات AGENTS.md إلى وحدات

يمكنك تقسيم ملفات AGENTS.md الكبيرة إلى ملفات أصغر يمكن إعادة استخدامها في سياقات مختلفة:

1. افصل مجموعة من التعليمات واحفظها في ملف Markdown آخر، مثل style-guidance.md.

2. أشِر إلى ملفات Markdown الأصغر في ملف AGENTS.md باستخدام الرمز @ متبوعًا بمسار الملف الذي تريد استيراده. تنسيقات المسارات المتوافقة:

   • المسارات النسبية:
     • @./file.md : الاستيراد من الدليل نفسه
     • @../file.md : الاستيراد من الدليل الرئيسي
     • @./subdirectory/file.md : الاستيراد من دليل فرعي
   • المسارات المطلقة: @/absolute/path/to/file.md

على سبيل المثال، يشير ملف AGENTS.md التالي إلى ملفَي تعليمات آخرَين:

# My AGENTS.md

You are an experienced Android app developer.

@./get-started.md

## Coding style

@./shared/style-guidance.md

طريقة عمل ملفات AGENTS.md

يفحص Gemini تلقائيًا الدليل الحالي والأدلة الرئيسية بحثًا عن ملفات AGENTS.md ويضيف محتواها إلى بداية كل طلب كتمهيد. إذا لم يكن لديك ملف مفتوح عند إرسال طلب بحث، يتم تضمين ملف AGENTS.md في جذر المشروع تلقائيًا (إذا كان متوفرًا).

ما الفرق بين ملفات AGENTS.md والقواعد؟

تسمح لك القواعد أيضًا بتحديد التعليمات والإعدادات المفضّلة التي تنطبق على جميع الطلبات. ومع ذلك، يتم تحديد القواعد في ملف IntelliJ‏ /.idea/project.prompts.xml، بينما يتم حفظ ملفات AGENTS.md بجانب الرمز البرمجي المصدر ولا تعتمد على بيئة تطوير متكاملة معيّنة. ننصحك باستخدام ملفات AGENTS.md إذا كان أحد الأغراض الرئيسية هو مشاركة التعليمات مع فريقك.

ما الفرق بين ملفات AGENTS.md والمهارات؟

تمثّل المهارات الخبرات عند الطلب التي يتم استدعاؤها عندما يتطابق طلبك مع وصف المهارة، بينما تتم إضافة المحتوى في AGENTS.md إلى بداية كل طلب بحث. ننصحك باستخدام المهارات لمهام معيّنة وملفات AGENTS.md للتأثير في السلوك العام للوكيل. لمزيد من المعلومات حول المهارات، اطّلِع على مقالة مقدّمة عن مهارات Android.