Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Proporciona instrucciones personalizadas a Gemini en Android Studio para que las siga con uno o más archivos AGENT.md. Los archivos AGENT.md se colocan junto con los demás archivos de tu base de código, por lo que es sencillo registrarlos en tu sistema de control de versiones (VCS) y compartir instrucciones específicas del proyecto, reglas de estilo de codificación y otras orientaciones con todo tu equipo.
Para comenzar, sigue estos pasos:
Crea un archivo AGENT.md en cualquier lugar del sistema de archivos de tu proyecto. Cuando envías una pregunta, Gemini analiza el directorio actual y todos los directorios principales en busca de archivos AGENT.md. Para obtener más información, consulta Cómo funcionan los archivos AGENT.md.
Agrega tus instrucciones. Escribe tus instrucciones con Markdown. Para facilitar la lectura, considera usar encabezados y viñetas para las diferentes reglas.
Consulta las instrucciones de ejemplo.
Guarda y confirma el archivo en tu VCS para compartirlo con tu equipo.
Administra archivos AGENT.md como contexto
Puedes aplicar o quitar archivos AGENT.md como contexto para una búsqueda en particular con el panel Contexto del panel de chat. Las opciones de AGENT.md Files incluyen todos los archivos AGENT.md del directorio actual y sus directorios superiores.
Figura 1: Administra archivos AGENT.md como contexto.
Ejemplo de instrucciones
Puedes usar el archivo AGENT.md para darle instrucciones al agente. A continuación, se incluyen algunos ejemplos, pero las instrucciones que proporciones deben ser específicas para tu proyecto.
"La actividad principal es /path/to/MainActivity.kt".
"El código para admitir la navegación entre pantallas es path/to/navigation/UiNavigation.kt".
"El código que controla las solicitudes HTTP se encuentra en <path>".
Arquitectura del proyecto
"Coloca toda la lógica empresarial en ViewModels".
"Siempre sigue las recomendaciones oficiales de arquitectura, incluido el uso de una arquitectura en capas. Usa un flujo unidireccional de datos (UDF), ViewModels, recopilación de estado de la IU optimizada para ciclos de vida y otras recomendaciones".
Bibliotecas preferidas: "Usa la biblioteca <nombre de la biblioteca> para la navegación".
Definir nombres de marcadores de posición para servicios de API comunes o terminología interna:
"El servicio de backend principal se conoce como 'PhotoSift-API'".
Guías de estilo de la empresa: "Todos los componentes de IU nuevos deben compilarse con Jetpack Compose. No sugieras diseños basados en XML".
Modulariza tus archivos AGENT.md
Puedes dividir los archivos AGENT.md grandes en archivos más pequeños que se puedan reutilizar en diferentes contextos:
Separa un conjunto de instrucciones y guárdalas en otro archivo Markdown, como style-guidance.md.
Haz referencia a los archivos Markdown más pequeños en un archivo AGENT.md con el símbolo @ seguido de la ruta de acceso al archivo que deseas importar. Se admiten los siguientes formatos de ruta de acceso:
Rutas de acceso relativas:
@./file.md: Importar desde el mismo directorio
@../file.md: Importar desde el directorio principal
@./subdirectory/file.md: Importar desde un subdirectorio
Rutas de acceso absolutas: @/absolute/path/to/file.md
Por ejemplo, el siguiente archivo AGENT.md hace referencia a otros dos archivos de instrucciones:
# My AGENT.md
You are an experienced Android app developer.
@./get-started.md
## Coding style
@./shared/style-guidance.md
Cómo funcionan los archivos AGENT.md
Gemini analiza automáticamente el directorio actual y los directorios superiores en busca de archivos AGENT.md y agrega su contenido al comienzo de cada instrucción como preámbulo. Si no tienes un archivo abierto cuando envías una consulta, se incluye de forma predeterminada el archivo AGENT.md en la raíz del proyecto (si hay uno).
¿Cuál es la diferencia entre los archivos AGENT.md y las reglas?
Las reglas también te permiten definir instrucciones y preferencias que se aplican a todas las instrucciones. Sin embargo, las reglas se definen en el archivo /.idea/project.prompts.xml de IntelliJ, mientras que los archivos AGENT.md se guardan junto a tu código fuente y son independientes del IDE. Te recomendamos que uses archivos AGENT.md si uno de los propósitos principales es compartir las instrucciones con tu equipo.
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-08-22 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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."]]
