Personalizzare Gemini utilizzando i file AGENTS.md

Nota: i file degli agenti denominati AGENTS.md sono compatibili con Android Studio Narwhal 4 Feature Drop Canary 4 e versioni successive. Per utilizzare i file degli agenti con Android Studio Narwhal 3 Feature Drop, utilizza il nome AGENT.md anziché AGENTS.md.

Fornisci a Gemini in Android Studio istruzioni personalizzate da seguire utilizzando uno o più file AGENTS.md. I file AGENTS.md vengono inseriti insieme agli altri file nella codebase, quindi è facile inserirli 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:

1. Crea un file AGENTS.md in qualsiasi punto del file system del progetto. Quando invii una query, Gemini esegue la scansione della directory corrente e di tutte le directory principali per trovare i file AGENTS.md. Per maggiori dettagli, consulta la sezione Come funzionano i file AGENTS.md.

   Suggerimento: utilizza più file di istruzioni in directory diverse per un controllo più granulare delle diverse parti della codebase. Ad esempio, puoi avere un file AGENTS.md globale nella root del progetto e file AGENTS.md più specifici nelle sottodirectory per i diversi moduli.

2. Aggiungi le istruzioni. Scrivi le istruzioni utilizzando Markdown. Per una maggiore leggibilità, valuta la possibilità di utilizzare intestazioni ed elenchi puntati per regole diverse. Consulta le istruzioni di esempio.

3. Salva il file ed esegui il commit nel VCS per condividerlo con il tuo team.

Gestire i file AGENTS.md come contesto

Puoi applicare o rimuovere i file AGENTS.md come contesto per una query specifica utilizzando il riquadro Contesto nel pannello della chat. Le opzioni File AGENTS.md includono tutti i file AGENTS.md nella directory corrente e nelle relative directory principali.

Figura 1. Gestire i file AGENTS.md come contesto.

Istruzioni di esempio

Puoi utilizzare il file AGENTS.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 nei ViewModel."
  • "Segui sempre i consigli ufficiali sull'architettura, incluso l'utilizzo di un'architettura a livelli. Utilizza un flusso di dati unidirezionale (UDF), ViewModel, raccolta dello stato dell'UI in base al ciclo di vita e altri consigli."
• Librerie preferite: "Utilizza la libreria <nome libreria> per la navigazione."
• Definizione dei nomi dei segnaposto per i servizi API comuni o la terminologia interna: "Il servizio di backend principale è denominato 'PhotoSift-API'."
• Guide di stile aziendali: "Tutti i nuovi componenti dell'UI devono essere creati con Jetpack Compose. Non suggerire layout basati su XML."

Modularizzare i file AGENTS.md

Puoi suddividere i file AGENTS.md di grandi dimensioni in file più piccoli che possono essere riutilizzati in contesti diversi:

1. Separa un insieme di istruzioni e salvale in un altro file Markdown, ad esempio style-guidance.md.

2. Fai riferimento ai file Markdown più piccoli in un file AGENTS.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 AGENTS.md fa riferimento ad altri due file di istruzioni:

# My AGENTS.md

You are an experienced Android app developer.

@./get-started.md

## Coding style

@./shared/style-guidance.md

Come funzionano i file AGENTS.md

Gemini esegue automaticamente la scansione della directory corrente e delle directory principali per trovare i file AGENTS.md e aggiunge i relativi contenuti all'inizio di ogni prompt come preambolo. Se non hai un file aperto quando invii una query, per impostazione predefinita viene incluso il file AGENTS.md nella root del progetto (se presente).

Nota: se hai un file GEMINI.md e un file AGENTS.md nella stessa directory, il file GEMINI.md ha la precedenza.

Qual è la differenza tra i file AGENTS.md e le regole?

Le regole 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 AGENTS.md vengono salvati accanto al codice sorgente e sono indipendenti dall'IDE. Ti consigliamo di utilizzare i file AGENTS.md se uno degli scopi principali è condividere le istruzioni con il tuo team.

Nota: quando elabora la query, Gemini combina le regole e le istruzioni nei file AGENTS.md.

Qual è la differenza tra i file AGENTS.md e le competenze?

Le competenze rappresentano competenze on demand che vengono richiamate quando la richiesta corrisponde a una descrizione delle competenze, mentre i contenuti in AGENTS.md vengono aggiunti all'inizio di ogni prompt. Ti consigliamo di utilizzare le competenze per attività specifiche e i file AGENTS.md per influenzare il comportamento generale dell'agente. Per saperne di più sulle competenze, consulta Introduzione alle competenze Android.