Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Fornisci a Gemini in Android Studio istruzioni personalizzate da seguire utilizzando uno o più file AGENT.md. I file AGENT.md vengono inseriti insieme agli altri file nella
base di codice, quindi è semplice archiviarli nel sistema di controllo della versione (VCS) e condividere istruzioni specifiche del progetto, regole di stile di codifica e
altre indicazioni con l'intero team.
Per iniziare, procedi nel seguente modo:
Crea un file AGENT.md in qualsiasi punto del file system del progetto. Gemini
esegue la scansione della directory corrente e di tutte le directory principali alla ricerca di file AGENT.md quando
invii una query. Per maggiori dettagli, vedi Come funzionano i file AGENT.md.
Aggiungi le istruzioni. Scrivi le istruzioni utilizzando Markdown. Per
una maggiore leggibilità, valuta la possibilità di utilizzare intestazioni ed elenchi puntati per le diverse regole.
Vedi le istruzioni di esempio.
Salva ed esegui il commit del file nel tuo sistema di controllo della versione per condividerlo con il tuo team.
Gestire i file AGENT.md come contesto
Puoi applicare o rimuovere file AGENT.md come contesto per una query specifica
utilizzando il riquadro Contesto nel pannello della chat. Le opzioni AGENT.md File
includono tutti i file AGENT.md nella directory corrente e nelle relative directory
principali.
Figura 1. Gestisci i file AGENT.md come contesto.
Esempi di istruzioni
Puoi utilizzare il file AGENT.md per fornire istruzioni all'agente. Di seguito
sono riportati alcuni esempi, ma le istruzioni che fornisci devono essere specifiche per
il tuo progetto.
"L'attività principale è /path/to/MainActivity.kt."
"Il codice per supportare la navigazione tra le schermate è
path/to/navigation/UiNavigation.kt"
"Il codice che gestisce le richieste HTTP si trova in <path>."
Architettura del progetto
"Inserisci tutta la logica di business in ViewModels."
"Segui sempre i consigli ufficiali sull'architettura, incluso l'utilizzo di un'architettura a livelli. Utilizza un flusso di dati unidirezionale (UDF), ViewModels,
raccolta dello stato dell'interfaccia utente in base al ciclo di vita e altri suggerimenti."
Biblioteche preferite: "Usa la biblioteca <nome della biblioteca> per la navigazione".
Definisci i nomi dei segnaposto per i servizi API comuni o la terminologia interna:
"Il servizio di backend principale è denominato "PhotoSift-API"."
Guide di stile dell'azienda: "Tutti i nuovi componenti dell'interfaccia utente devono essere creati con Jetpack
Compose. Non suggerire layout basati su XML."
Modularizzare i file AGENT.md
Puoi suddividere i file AGENT.md di grandi dimensioni in file più piccoli che possono essere riutilizzati
in contesti diversi:
Separa un insieme di istruzioni e salvale in un altro file Markdown,
ad esempio style-guidance.md.
Fai riferimento ai file Markdown più piccoli in un file AGENT.md utilizzando il simbolo @
seguito dal percorso del file che vuoi importare. Sono supportati i seguenti formati di percorso:
Percorsi relativi:
@./file.md - Importa dalla stessa directory
@../file.md: importa dalla directory principale
@./subdirectory/file.md - Importa da una sottodirectory
Percorsi assoluti: @/absolute/path/to/file.md
Ad esempio, il seguente file AGENT.md fa riferimento ad altri due file di istruzioni:
# My AGENT.md
You are an experienced Android app developer.
@./get-started.md
## Coding style
@./shared/style-guidance.md
Come funzionano i file AGENT.md
Gemini esegue automaticamente la scansione della directory corrente e delle directory principali alla ricerca di file
AGENT.md e aggiunge i relativi contenuti all'inizio di ogni prompt come
preambolo. Se non hai aperto un file quando invii una query, il file
AGENT.md nella radice del progetto (se presente) viene incluso per impostazione predefinita.
Qual è la differenza tra i file AGENT.md e le regole?
Le regole ti consentono anche di definire istruzioni e preferenze
che si applicano a tutti i prompt. Tuttavia, le regole sono definite nel file IntelliJ
/.idea/project.prompts.xml, mentre i file AGENT.md vengono salvati accanto al codice sorgente e sono indipendenti dall'IDE. Ti consigliamo di utilizzare i file AGENT.md se uno degli scopi principali è condividere le istruzioni con il tuo team.
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2025-08-22 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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."]]
