Personalizar o Gemini usando arquivos AGENT.md

Dê instruções personalizadas para o Gemini no Android Studio usando um ou mais arquivos AGENT.md. Os arquivos AGENT.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:

  1. Crie um arquivo AGENT.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 AGENT.md quando você envia uma consulta. Para mais detalhes, consulte Como os arquivos AGENT.md funcionam.

  2. 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.

  3. Salve e envie o arquivo para o VCS para compartilhar com sua equipe.

Gerenciar arquivos AGENT.md como contexto

É possível aplicar ou remover arquivos AGENT.md como contexto para uma consulta específica usando o painel Contexto no painel de chat. As opções de Arquivos AGENT.md incluem todos os arquivos AGENT.md no diretório atual e nos diretórios pai.

Gerenciar arquivos AGENT.md como contexto
Figura 1. Gerenciar arquivos AGENT.md como contexto.

Exemplos de instruções

Você pode usar o arquivo AGENT.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 AGENT.md

Você pode dividir arquivos AGENT.md grandes em arquivos menores que podem ser reutilizados em diferentes contextos:

  1. Separe um conjunto de instruções e salve em outro arquivo Markdown, como style-guidance.md.

  2. Faça referência aos arquivos Markdown menores em um arquivo AGENT.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 AGENT.md a seguir faz referência a outros dois arquivos de instruções:

# My AGENT.md

You are an experienced Android app developer.

@./get-started.md

## Coding style

@./shared/style-guidance.md

Como funcionam os arquivos AGENT.md

O Gemini verifica automaticamente o diretório atual e os diretórios principais em busca de arquivos AGENT.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 AGENT.md na raiz do projeto (se houver um) será incluído por padrão.

Qual é a diferença entre arquivos AGENT.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 AGENT.md são salvos ao lado do código-fonte e são neutros para IDEs. Recomendamos usar arquivos AGENT.md se um dos principais objetivos for compartilhar as instruções com sua equipe.