Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Dê instruções personalizadas para o Gemini no Android Studio usando um ou mais arquivos AGENTS.md. Os arquivos AGENTS.md são colocados ao lado dos outros arquivos na base de código. Assim, é fácil fazer check-in deles no sistema de controle de versões (VCS, na sigla em inglês) e compartilhar instruções específicas do projeto, regras de estilo de programação e outras orientações com toda a equipe.
Para começar, siga estas etapas:
Crie um arquivo AGENTS.md em qualquer lugar no sistema de arquivos do projeto. O Gemini verifica o diretório atual e todos os diretórios principais em busca de arquivos AGENTS.md quando você envia uma consulta. Para mais detalhes, consulte Como os arquivos AGENTS.md funcionam.
Adicione suas instruções. Escreva as instruções usando Markdown. Para facilitar a leitura, use títulos e marcadores para regras diferentes.
Confira um exemplo de instruções.
Salve e envie o arquivo para o VCS para compartilhar com sua equipe.
Gerenciar arquivos AGENTS.md como contexto
É possível aplicar ou remover arquivos AGENTS.md como contexto para uma consulta específica usando o painel Contexto no painel de chat. As opções de Arquivos AGENTS.md incluem todos os arquivos AGENTS.md no diretório atual e nos diretórios pai.
Figura 1. Gerenciar arquivos AGENTS.md como contexto.
Exemplos de instruções
Você pode usar o arquivo AGENTS.md para dar instruções ao agente. Confira alguns exemplos, mas as instruções precisam ser específicas para seu projeto.
"A atividade principal é /path/to/MainActivity.kt."
"O código para oferecer suporte à navegação entre telas é
path/to/navigation/UiNavigation.kt"
"O código que processa solicitações HTTP está em <path>."
Arquitetura do projeto
"Coloque toda a lógica de negócios nos ViewModels."
"Sempre siga as recomendações oficiais de arquitetura, incluindo o uso de uma arquitetura em camadas. Use um fluxo de dados unidirecional (UDF), ViewModels, coleta de estado da interface com reconhecimento de ciclo de vida e outras recomendações".
Bibliotecas preferenciais: "Use a biblioteca <nome da biblioteca> para navegação".
Definir nomes de marcador de posição para serviços de API comuns ou terminologia interna:
"O serviço de back-end principal é chamado de 'PhotoSift-API'."
Guias de estilo da empresa: "Todos os novos componentes de interface precisam ser criados com o Jetpack
Compose. Não sugira layouts baseados em XML."
Modularizar seus arquivos AGENTS.md
Você pode dividir arquivos AGENTS.md grandes em arquivos menores que podem ser reutilizados em diferentes contextos:
Separe um conjunto de instruções e salve em outro arquivo Markdown, como style-guidance.md.
Faça referência aos arquivos Markdown menores em um arquivo AGENTS.md usando o símbolo @
seguido pelo caminho para o arquivo que você quer importar. Os seguintes formatos de caminho são compatíveis:
Caminhos relativos:
@./file.md: importar do mesmo diretório
@../file.md: importar do diretório principal
@./subdirectory/file.md: importar de um subdiretório
Caminhos absolutos: @/absolute/path/to/file.md
Por exemplo, o arquivo AGENTS.md a seguir faz referência a outros dois arquivos de
instruções:
# My AGENTS.md
You are an experienced Android app developer.
@./get-started.md
## Coding style
@./shared/style-guidance.md
Como funcionam os arquivos AGENTS.md
O Gemini verifica automaticamente o diretório atual e os diretórios principais em busca de arquivos
AGENTS.md e adiciona o conteúdo deles ao início de cada comando como um
preâmbulo. Se você não tiver um arquivo aberto ao enviar uma consulta, o arquivo
AGENTS.md na raiz do projeto (se houver um) será incluído por padrão.
Qual é a diferença entre arquivos AGENTS.md e regras?
Com as regras, também é possível definir instruções e preferências
que se aplicam a todos os comandos. No entanto, as regras são definidas no arquivo do IntelliJ
/.idea/project.prompts.xml, enquanto os arquivos AGENTS.md são salvos ao lado do
código-fonte e são neutros para IDEs. Recomendamos usar arquivos AGENTS.md se um dos principais objetivos for compartilhar as instruções com sua equipe.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-09-05 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-05 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."]]
