Personnaliser Gemini à l'aide de fichiers AGENT.md
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Donnez à Gemini dans Android Studio des instructions personnalisées à suivre à l'aide d'un ou de plusieurs fichiers AGENT.md. Les fichiers AGENT.md sont placés à côté des autres fichiers de votre codebase. Il est donc facile de les archiver dans votre système de contrôle des versions (VCS) et de partager des instructions spécifiques au projet, des règles de style de programmation et d'autres conseils avec toute votre équipe.
Pour commencer, procédez comme suit :
Créez un fichier AGENT.md n'importe où dans le système de fichiers de votre projet. Lorsque vous envoyez une requête, Gemini recherche les fichiers AGENT.md dans le répertoire actuel et dans tous les répertoires parents. Pour en savoir plus, consultez Fonctionnement des fichiers AGENT.md.
Ajoutez vos instructions. Rédigez vos instructions à l'aide de Markdown. Pour plus de clarté, pensez à utiliser des titres et des puces pour les différentes règles.
Voir des exemples d'instructions
Enregistrez le fichier et validez-le dans votre système de gestion de versions pour le partager avec votre équipe.
Gérer les fichiers AGENT.md comme contexte
Vous pouvez appliquer ou supprimer des fichiers AGENT.md comme contexte pour une requête spécifique à l'aide du panneau Contexte dans le panneau de chat. L'option Fichiers AGENT.md inclut tous les fichiers AGENT.md du répertoire actuel et de ses répertoires parents.
Figure 1. Gérez les fichiers AGENT.md comme contexte.
Exemples d'instructions
Vous pouvez utiliser le fichier AGENT.md pour donner des instructions à l'agent. Vous trouverez ci-dessous quelques exemples, mais les instructions que vous fournissez doivent être spécifiques à votre projet.
"L'activité principale est /path/to/MainActivity.kt."
"Le code permettant de naviguer entre les écrans est
path/to/navigation/UiNavigation.kt"
"Le code qui gère les requêtes HTTP se trouve à l'adresse <path>."
Architecture du projet
"Placez toute la logique métier dans les ViewModels."
"Suivez toujours les recommandations officielles en matière d'architecture, y compris l'utilisation d'une architecture en couches. Utilisez un flux de données unidirectionnel (UDF), des ViewModels, la collecte de l'état de l'UI en tenant compte du cycle de vie et d'autres recommandations."
Bibliothèques préférées : "Utilise la bibliothèque <nom de la bibliothèque> pour la navigation."
Définir des noms de substitution pour les services d'API courants ou la terminologie interne : "Le service de backend principal est appelé 'PhotoSift-API'."
Guides de style de l'entreprise : "Tous les nouveaux composants d'UI doivent être créés avec Jetpack Compose. Ne suggère pas les mises en page basées sur XML."
Modulariser vos fichiers AGENT.md
Vous pouvez diviser les fichiers AGENT.md volumineux en fichiers plus petits qui peuvent être réutilisés dans différents contextes :
Séparez un ensemble d'instructions et enregistrez-les dans un autre fichier Markdown, tel que style-guidance.md.
Référencez les fichiers Markdown plus petits dans un fichier AGENT.md en utilisant le symbole @ suivi du chemin d'accès au fichier que vous souhaitez importer. Les formats de chemin d'accès suivants sont acceptés :
Chemins relatifs :
@./file.md : importer depuis le même répertoire
@../file.md : importer depuis le répertoire parent
@./subdirectory/file.md : importer depuis un sous-répertoire
Chemins absolus : @/absolute/path/to/file.md
Par exemple, le fichier AGENT.md suivant fait référence à deux autres fichiers d'instructions :
# My AGENT.md
You are an experienced Android app developer.
@./get-started.md
## Coding style
@./shared/style-guidance.md
Fonctionnement des fichiers AGENT.md
Gemini analyse automatiquement le répertoire actuel et les répertoires parents à la recherche de fichiers AGENT.md et ajoute leur contenu au début de chaque requête en tant que préambule. Si aucun fichier n'est ouvert lorsque vous envoyez une requête, le fichier AGENT.md à la racine du projet (le cas échéant) est inclus par défaut.
Quelle est la différence entre les fichiers AGENT.md et les règles ?
Les règles vous permettent également de définir des instructions et des préférences qui s'appliquent à toutes les requêtes. Toutefois, les règles sont définies dans le fichier IntelliJ /.idea/project.prompts.xml, tandis que les fichiers AGENT.md sont enregistrés à côté de votre code source et sont indépendants de l'IDE. Nous vous recommandons d'utiliser des fichiers AGENT.md si l'un des principaux objectifs est de partager les instructions avec votre équipe.
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/22 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/22 (UTC)."],[],[],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."]]
