Personalizzare Gemini utilizzando i file AGENT.md

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:

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

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

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

Gestire i file AGENT.md come contesto
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:

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