Gemini را با استفاده از فایل های AGENT.md سفارشی کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
دستورالعمل‌های سفارشی‌سازی شده Gemini را در Android Studio ارائه دهید تا با استفاده از یک یا چند فایل AGENT.md دنبال کنید. فایل‌های AGENT.md در کنار فایل‌های دیگر در پایگاه کد شما قرار می‌گیرند، بنابراین آسان است که آنها را در سیستم کنترل نسخه (VCS) خود بررسی کنید و دستورالعمل‌های خاص پروژه، قوانین سبک کدنویسی و سایر راهنمایی‌ها را با کل تیم خود به اشتراک بگذارید.
برای شروع، مراحل زیر را دنبال کنید:
یک فایل AGENT.md در هر نقطه از فایل سیستم پروژه خود ایجاد کنید. Gemini دایرکتوری فعلی و همه دایرکتوری‌های والد را برای فایل‌های AGENT.md اسکن می‌کند وقتی درخواستی ارسال می‌کنید. برای جزئیات بیشتر، نحوه کار فایل‌های AGENT.md را ببینید.
دستورالعمل های خود را اضافه کنید. دستورالعمل های خود را با استفاده از Markdown بنویسید. برای خوانایی، استفاده از عناوین و نقاط گلوله برای قوانین مختلف را در نظر بگیرید. نمونه دستورالعمل ها را ببینید .
فایل را در VCS خود ذخیره و متعهد کنید تا با تیم خود به اشتراک بگذارید.
فایل های AGENT.md را به عنوان زمینه مدیریت کنید
می‌توانید فایل‌های AGENT.md را به‌عنوان زمینه برای یک درخواست خاص با استفاده از کشوی Context در پانل چت اعمال یا حذف کنید. گزینه های AGENT.md Files شامل تمام فایل های AGENT.md در فهرست فعلی و دایرکتوری های والد آن می شود.
شکل 1. فایل های AGENT.md را به عنوان زمینه مدیریت کنید.
نمونه دستورالعمل
می توانید از فایل AGENT.md برای دادن دستورالعمل به نماینده استفاده کنید. در زیر چند نمونه آورده شده است، اما دستورالعمل هایی که ارائه می دهید باید مختص پروژه شما باشد.
"فعالیت اصلی /path/to/MainActivity.kt است."
"کد پشتیبانی از پیمایش بین صفحه‌ها path/to/navigation/UiNavigation.kt است."
"کد مدیریت درخواست های HTTP در <path> است."
معماری پروژه
"کلیه منطق تجاری را در ViewModels قرار دهید."
"همیشه از توصیه‌های رسمی معماری، از جمله استفاده از معماری لایه‌ای پیروی کنید. از یک جریان داده یک طرفه (UDF)، ViewModels، مجموعه وضعیت UI آگاه از چرخه حیات و سایر توصیه‌ها استفاده کنید."
کتابخانه های ترجیحی: "از کتابخانه <library name> برای پیمایش استفاده کنید."
تعیین نام مکان‌نماها برای سرویس‌های مشترک API یا اصطلاحات داخلی: "سرویس باطن اولیه به عنوان "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 در ریشه پروژه (اگر وجود داشته باشد) به طور پیش فرض گنجانده شده است.
تفاوت بین فایل های AGENT.md و Rules چیست؟
قوانین همچنین به شما امکان می دهند دستورالعمل ها و اولویت هایی را تعریف کنید که برای همه درخواست ها اعمال می شود. با این حال، قوانین در فایل IntelliJ /.idea/project.prompts.xml تعریف شده‌اند، در حالی که فایل‌های AGENT.md در کنار کد منبع شما ذخیره می‌شوند و از نظر IDE خنثی هستند. اگر یکی از اهداف اصلی این است که دستورالعمل ها را با تیم خود به اشتراک بگذارید، توصیه می کنیم از فایل های AGENT.md استفاده کنید.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و 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."]]
