Modalità agente

La modalità Agente di Gemini in Android Studio è progettata per gestire attività di sviluppo complesse e in più fasi che vanno oltre ciò che puoi fare semplicemente chattando con Gemini. Puoi descrivere un obiettivo di alto livello e l'agente creerà ed eseguirà un piano, richiamando gli strumenti necessari, apportando modifiche a più file e correggendo iterativamente i bug. Questo flusso di lavoro assistito da agenti ti consente di affrontare sfide complesse, accelerando il processo di sviluppo.

Requisiti di sistema

La modalità Agente è disponibile a partire da Android Studio Narwhal Feature Drop Canary 4. Scarica l'ultima versione di anteprima di Android Studio.

Inizia

Per iniziare a utilizzare la modalità Agente in Android Studio, segui questi passaggi:

  1. Fai clic su Gemini nella barra laterale. Accedi ed esegui l'onboarding, se necessario.
  2. Seleziona la scheda Agente.
  3. Descrivi l'attività che vuoi che l'agente esegua.

  4. Man mano che l'agente esegue i passaggi per completare l'attività, avrai la possibilità di rivedere e approvare eventuali modifiche.

    La modalità Agente attende che tu accetti o rifiuti una modifica.

  5. (Facoltativo) Per approvare automaticamente le modifiche, seleziona Opzioni agente > Approva automaticamente le modifiche.

    Approva automaticamente le modifiche suggerite dall'agente.

Casi d'uso

Ecco alcuni esempi di casi d'uso in cui l'agente può aiutarti:

  • Correggi gli errori di build. Quando chiedi all'agente di correggere un errore di build utilizzando un prompt come "Correggi gli errori di build nel mio progetto", applicherà una correzione consigliata, eseguirà la build del progetto per verificare la soluzione e ripeterà l'operazione finché il problema non viene risolto.

    L'agente crea il progetto e valuta se sono presenti errori.

  • La modalità Agente può aggiungere o aggiornare gli elementi dell'interfaccia utente in autonomia. Ad esempio, chiedi all'agente di "Impostare la modalità Buio come predefinita nelle preferenze utente" e l'agente cercherà i file pertinenti e suggerirà le modifiche per completare l'attività. Puoi visualizzare immediatamente l'anteprima degli aggiornamenti dell'interfaccia utente nella finestra dello strumento Dispositivi in esecuzione.

  • È utile disporre di dati simulati durante la prototipazione e il test dell'app. Invece di creare manualmente dati falsi, puoi assegnare questa attività all'agente. Qui abbiamo chiesto all'agente di "Aggiungere altre due sessioni ai dati fittizi". Trova il file pertinente e aggiunge altri due eventi all'elenco mockSessions.

Altri prompt da provare:

  • "Scrivi test delle unità per <class> in <module>."
  • "Genera la documentazione per il file attualmente aperto."
  • "Modifica il titolo dell'app da <nome attuale> a <nuovo nome>."
  • "Risolvi l'eccezione di puntatore nullo".
  • "Refactor my code by moving the <composable name> composable to a new file. Assicurati che tutte le importazioni siano aggiornate."
  • "Aggiungi un nuovo pulsante alla schermata Home dell'app chiamato "Segui" che ti porta a un elenco di argomenti."
  • "Nel composable <nome del composable>, riduci il padding del modificatore <nome del modificatore>."
  • "Crea un pulsante di condivisione per condividere contenuti sui social media."

Aggiungere la chiave API Gemini

La modalità Agente predefinita in Android Studio ha una quota giornaliera senza costi con una finestra contestuale limitata. Per espandere la finestra contestuale, puoi aggiungere la tua chiave API Gemini per sfruttare fino a 1 milione di token con Gemini 2.5 Pro.

Aggiungi la tua chiave API per espandere la finestra contestuale.

Una finestra contestuale più ampia ti consente di inviare più istruzioni, codice e allegati a Gemini, ottenendo risposte di qualità ancora superiore. Ciò è particolarmente utile quando si lavora con gli agenti, perché il contesto più ampio fornisce a Gemini 2.5 Pro la capacità di ragionare su attività complesse o di lunga durata.

Per ottenere una chiave API:

  1. Accedi a Google AI Studio e ottieni una chiave facendo clic sul pulsante Ottieni chiave API.
  2. In Android Studio, vai a File (Android Studio su macOS) > Impostazioni > Strumenti > Gemini per inserire la chiave API Gemini.
  3. Riavvia Gemini in Android Studio e ottieni risposte ancora migliori dalla modalità Agente.
Aggiungi la tua chiave API nelle impostazioni di Gemini.

Assicurati di proteggere la chiave API Gemini perché vengono applicati costi aggiuntivi per l'utilizzo dell'API Gemini associato a una chiave API personale. Puoi monitorare l'utilizzo della chiave API Gemini in AI Studio tramite Ottieni chiave API > Utilizzo e fatturazione.

Aggiungere un server MCP

L'agente di Gemini in Android Studio può interagire con strumenti esterni utilizzando il Model Context Protocol (MCP). Questa funzionalità fornisce una modalità standardizzata per la modalità Agente per utilizzare gli strumenti ed estendere le conoscenze e le funzionalità con l'ambiente esterno.

Esistono molti strumenti che puoi connettere all'host MCP in Android Studio. Ad esempio, puoi eseguire l'integrazione con il server GitHub MCP per creare richieste di pull direttamente da Android Studio. Per altre idee, consulta i server di esempio MCP.

Per aggiungere un server MCP, crea un file mcp.json e inseriscilo nella directory di configurazione di Studio. Il file mcp.json deve seguire questo formato:

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ]
    },
    "sequential-thinking": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sequential-thinking"
      ]
    },
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Consulta la documentazione del server MCP con cui esegui l'integrazione per i valori precisi di command e args da elencare in questo file. Potresti anche dover installare strumenti come Node.js o Docker, a seconda dei requisiti software del server MCP.

Limitazioni

L'integrazione di MCP di Android Studio presenta alcune limitazioni importanti:

  • I server MCP devono implementare il trasporto stdio.
  • Il supporto per il trasporto HTTP in streaming, nonché per le risorse MCP e i modelli di prompt, non è ancora disponibile.

Come funziona l'agente

In modalità Agente, il prompt viene inviato all'API Gemini con un elenco di strumenti disponibili. Puoi considerare gli strumenti come competenze: includono la possibilità di cercare file, leggere file, cercare il testo all'interno dei file, utilizzare i server MCP che hai configurato e altro ancora.

Quando assegni un'attività all'agente, questo elabora un piano e individua gli strumenti necessari. Per alcuni di questi strumenti potrebbe essere necessario concedere l'autorizzazione prima che l'agente possa utilizzarli. Una volta concessa l'autorizzazione, l'agente utilizza lo strumento per eseguire l'azione necessaria e invia il risultato all'API Gemini. Gemini elabora il risultato dell'azione e genera un'altra risposta. Questo ciclo di azione e valutazione continua fino al completamento dell'attività.