تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
قدِّم تعليمات مخصّصة إلى "Gemini في استوديو Android" ليتبعها باستخدام ملف واحد أو أكثر من AGENT.md الملفات. يتم وضع ملفات AGENT.md بجانب الملفات الأخرى في قاعدة الرموز البرمجية، لذا يسهل تسجيلها في نظام التحكّم في الإصدار (VCS) ومشاركة التعليمات الخاصة بالمشروع وقواعد أسلوب الترميز والإرشادات الأخرى مع فريقك بأكمله.
للبدء، اتّبِع الخطوات التالية:
أنشِئ ملف AGENT.md في أي مكان في نظام ملفات مشروعك. يفحص Gemini الدليل الحالي وجميع الأدلة الرئيسية بحثًا عن ملفات AGENT.md عند إرسال طلب بحث. لمزيد من التفاصيل، يُرجى الاطّلاع على طريقة عمل ملفات AGENT.md.
أضِف تعليماتك. اكتب تعليماتك باستخدام Markdown. لتحسين إمكانية القراءة، ننصحك باستخدام العناوين ونقاط التعداد للقواعد المختلفة.
الاطّلاع على تعليمات نموذجية
احفظ الملف وأرسِله إلى نظام إدارة الإصدارات (VCS) لمشاركته مع فريقك.
إدارة ملفات AGENT.md كسياق
يمكنك تطبيق ملفات AGENT.md أو إزالتها كسياق لطلب بحث معيّن
باستخدام درج السياق في لوحة المحادثة. تتضمّن خيارات AGENT.md الملفات جميع ملفات AGENT.md في الدليل الحالي وأدلته الأصلية.
الشكل 1. إدارة ملفات AGENT.md كسياق
أمثلة على التعليمات
يمكنك استخدام ملف AGENT.md لتقديم تعليمات إلى البرنامج. في ما يلي بعض الأمثلة، ولكن يجب أن تكون التعليمات التي تقدّمها خاصة بمشروعك.
"النشاط الرئيسي هو /path/to/MainActivity.kt".
"رمز التنقّل بين الشاشات هو
path/to/navigation/UiNavigation.kt"
"يمكن العثور على الرمز البرمجي الذي يعالج طلبات HTTP في <path>".
بنية المشروع
"وضع جميع منطق الأنشطة التجارية في ViewModels"
اتّبِع دائمًا اقتراحات البنية الرسمية، بما في ذلك استخدام بنية ذات طبقات. استخدِم تدفق البيانات أحادي الاتجاه (UDF) وViewModels ومجموعة حالات واجهة المستخدم المتوافقة مع مراحل النشاط وغيرها من الاقتراحات".
المكتبات المفضّلة: "استخدِم مكتبة <اسم المكتبة> للتنقّل".
تحديد أسماء العناصر النائبة لخدمات واجهة برمجة التطبيقات الشائعة أو المصطلحات الداخلية:
"يُشار إلى خدمة الخلفية الأساسية باسم PhotoSift-API".
أدلة الأسلوب في الشركة: "يجب إنشاء جميع عناصر واجهة المستخدم الجديدة باستخدام Jetpack Compose. لا تقترح تخطيطات مستندة إلى XML".
تقسيم ملفات AGENT.md إلى وحدات
يمكنك تقسيم ملفات AGENT.md كبيرة إلى ملفات أصغر يمكن إعادة استخدامها في سياقات مختلفة:
فصل مجموعة من التعليمات وحفظها في ملف Markdown آخر، مثل style-guidance.md
أشِر إلى ملفات Markdown الأصغر في ملف AGENT.md باستخدام الرمز @
متبوعًا بمسار الملف الذي تريد استيراده. تتوفّر تنسيقات المسارات التالية:
المسارات النسبية:
@./file.md - الاستيراد من الدليل نفسه
@../file.md: الاستيراد من الدليل الرئيسي
@./subdirectory/file.md - الاستيراد من دليل فرعي
المسارات المطلقة: @/absolute/path/to/file.md
على سبيل المثال، يشير ملف AGENT.md التالي إلى ملفَّي تعليمات آخرَين:
# My AGENT.md
You are an experienced Android app developer.
@./get-started.md
## Coding style
@./shared/style-guidance.md
طريقة عمل ملفات AGENT.md
يفحص Gemini تلقائيًا الدليل الحالي والأدلة الرئيسية بحثًا عن ملفات AGENT.md ويضيف محتواها إلى بداية كل طلب كتمهيد. إذا لم يكن لديك ملف مفتوح عند إرسال طلب بحث، سيتم تضمين الملف AGENT.md في جذر المشروع تلقائيًا (إذا كان هناك ملف).
ستكون الأولوية لملف GEMINI.md.
ما الفرق بين ملفات AGENT.md والقواعد؟
تتيح لك القواعد أيضًا تحديد التعليمات والإعدادات المفضّلة التي تنطبق على جميع الطلبات. ومع ذلك، يتم تحديد القواعد في ملف IntelliJ
/.idea/project.prompts.xml، بينما يتم حفظ ملفات AGENT.md بجانب
رمز المصدر، وهي متوافقة مع جميع بيئات التطوير المتكاملة. ننصحك باستخدام ملفات AGENT.md إذا كان أحد الأغراض الأساسية هو مشاركة التعليمات مع فريقك.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-08-22 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-08-22 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Customize Gemini using AGENT.md files\n\nGive Gemini in Android Studio customized instructions to follow using one or\nmore `AGENT.md` files. `AGENT.md` files are placed alongside the other files in\nyour codebase, so it's straightforward to check them in to your version control\nsystem (VCS) and share project-specific instructions, coding style rules, and\nother guidance with your entire team.\n\nTo get started, follow these steps:\n\n1. Create an `AGENT.md` file anywhere in your project's file system. Gemini\n scans the current directory and all parent directories for `AGENT.md` files when\n you submit a query. For more details, see [How `AGENT.md` files work](#how-agent-files-work).\n\n | **Tip:** Use multiple instruction files across different directories for more granular control over different parts of your codebase. For example, you can have a global `AGENT.md` file at the project root and more specific `AGENT.md` files in subdirectories for different modules.\n2. Add your instructions. Write your instructions using Markdown. For\n readability, consider using headings and bullet points for different rules.\n [See example instructions](#example-instructions).\n\n3. Save and commit the file to your VCS to share it with your team.\n\nManage `AGENT.md` files as context\n----------------------------------\n\nYou can apply or remove `AGENT.md` files as context for a particular query\nusing the **Context** drawer in the chat panel. The **`AGENT.md` Files** options\nincludes all `AGENT.md` files in the current directory and its parent\ndirectories.\n**Figure 1.** Manage `AGENT.md` files as context.\n\nExample instructions\n--------------------\n\nYou can use the `AGENT.md` file to give instructions to the agent. The following\nare some examples, but the instructions that you provide should be specific to\nyour project.\n\n- \"The main activity is `/path/to/MainActivity.kt`.\"\n- \"The code to support navigating between screens is `path/to/navigation/UiNavigation.kt`\"\n- \"The code handling HTTP requests is at `\u003cpath\u003e`.\"\n- Project architecture\n - \"Place all business logic in ViewModels.\"\n - \"Always follow official architecture recommendations, including use of a layered architecture. Use a unidirectional data flow (UDF), ViewModels, lifecycle-aware UI state collection, and other recommendations.\"\n- Preferred libraries: \"Use the \\\u003clibrary name\\\u003e library for navigation.\"\n- Defining placeholder names for common API services or internal terminology: \"The primary backend service is referred to as 'PhotoSift-API'.\"\n- Company style guides: \"All new UI components must be built with Jetpack Compose. Don't suggest XML-based layouts.\"\n\nModularize your `AGENT.md` files\n--------------------------------\n\nYou can break down large `AGENT.md` files into smaller files that can be reused\nin different contexts:\n\n1. Separate out a set of instructions and save them in another Markdown file,\n such as `style-guidance.md`.\n\n2. Reference the smaller Markdown files in an `AGENT.md` file by using the `@`\n symbol followed by the path to the file you want to import. The following path\n formats are supported:\n\n - Relative paths:\n - `@./file.md` - Import from the same directory\n - `@../file.md` - Import from the parent directory\n - `@./subdirectory/file.md` - Import from a subdirectory\n - Absolute paths: `@/absolute/path/to/file.md`\n\nFor example, the following `AGENT.md` file references two other instruction\nfiles: \n\n # My AGENT.md\n\n You are an experienced Android app developer.\n\n @./get-started.md\n\n ## Coding style\n\n @./shared/style-guidance.md\n\nHow `AGENT.md` files work\n-------------------------\n\nGemini automatically scans the current directory and parent directories for\n`AGENT.md` files and adds their content to the beginning of every prompt as a\npreamble. If you don't have a file open when you submit a query, then the\n`AGENT.md` file at the project root (if there is one) is included by default.\n| **Note:** If you have a `GEMINI.md` file and `AGENT.md` file in the same directory, the `GEMINI.md` file takes precedence.\n\nWhat's the difference between `AGENT.md` files and Rules?\n---------------------------------------------------------\n\n[Rules](/studio/gemini/rules) also let you define instructions and preferences\nthat apply to all prompts. However, rules are defined in the IntelliJ file\n`/.idea/project.prompts.xml`, whereas `AGENT.md` files are saved next to your\nsource code and are IDE-neutral. We recommend using `AGENT.md` files if one of\nthe primary purposes is to share the instructions with your team.\n| **Note:** Gemini combines rules and instructions in `AGENT.md` files when processing your query."]]
