L'agente in Android Studio agisce come tuo collaboratore per la programmazione, accelerando il tuo flusso di lavoro di sviluppo generando codice, riassumendo argomenti complessi, trovando risorse specifiche e altro ancora. Una comunicazione efficace è la chiave per sbloccare il pieno potenziale dell'agente.
Questa guida illustra le strategie per configurare l'ambiente di sviluppo e scrivere prompt che generano risposte utili e affidabili. Per più strategie, abbiamo fornito prompt di esempio per diversi casi d'uso. Per altri esempi di prompt, consulta la galleria dei prompt.
Rispondi in modo specifico
L'agente funziona meglio con istruzioni chiare e specifiche. Se ci sono librerie, API o approcci specifici che vorresti utilizzare, includili nella tua domanda o nel file AGENTS.md principale del tuo progetto per mantenerli nelle interazioni. È come presentare una segnalazione di bug: più informazioni fornisci, più velocemente ed efficacemente il problema può essere risolto.
Implementazione di una nuova funzionalità:
Cosa fare
Cosa non fare
Generazione di codice:
Cosa fare
Scrivi una funzione di sospensione Kotlin che utilizzi la libreria Coil per scaricare un'immagine da una stringa URL specificata.
La funzione deve essere denominata fetchImageAsBitmap. Deve accettare un Context e un URL String come argomenti e restituire un Bitmap nullable. Se si verifica un errore di rete o di decodifica, deve rilevare l'eccezione, registrarla e restituire null.
Cosa non fare
Spiegare un concetto:
Cosa fare
Sto creando un'app di riproduzione musicale e devo continuare la riproduzione quando l'app è in background.
Quali sono le opzioni per mantenere l'app in esecuzione mentre l'utente esegue altre operazioni sul dispositivo? Quali sono i requisiti del livello API e le implicazioni sulla durata della batteria per ogni approccio?
Cosa non fare
Descrivi la struttura della risposta
Per impostazione predefinita, l'agente fornisce risposte in un formato conversazionale basato su paragrafi. Sebbene questo sia spesso utile per le spiegazioni, puoi ottenere risultati più efficaci e immediatamente utilizzabili indicando come strutturare la risposta. Specificare il formato di output indica al modello di organizzare le informazioni in modo chiaro e prevedibile, risparmiandoti il tempo di riformattarle manualmente.
Se vuoi inserire il codice generato dall'agente nella tua app e hai bisogno del codice in un determinato formato per poterlo utilizzare immediatamente, fornisci all'agente istruzioni chiare sulla generazione e sulla formattazione del codice.
Strutturazione della risposta:
Cosa fare
Crea un'entità Room per un profilo utente. Deve contenere i campi id, userName, email e memberSince. Il campo id deve essere generato automaticamente. Il campo memberSince deve rappresentare un timestamp.
Cosa non fare
Se stai ponendo una domanda più aperta, chiedi un numero x di opzioni.
Limitazione della risposta:
Cosa fare
Cosa non fare
Suddividi le richieste complesse in attività più semplici
Se l'approccio dell'agente non è quello che ti aspetti, potrebbe essere utile guidarlo attraverso una serie di prompt più piccoli e sequenziali, anziché chiedere tutto in una volta. Questo approccio ti offre un maggiore controllo e ti consente di verificare ogni passaggio prima di procedere con quello successivo.
Applicazione di prompt sequenziali:
Cosa fare
Prompt 1: il modello di dati
Per prima cosa, crea una classe di dati Kotlin denominata User. Deve avere tre proprietà: id (un Int), name (una String) e email (una String).
Prompt 2: il livello di rete
Ora crea un'interfaccia API Retrofit denominata ApiService. Richiede un singolo suspend fun denominato getUsers() che restituisce un List<User>.
Prompt 3: gestione dello stato
Successivamente, scrivi un UsersViewModel che accetta ApiService come dipendenza. UsersViewModel
deve esporre un
StateFlow di una classe UiState sealed che può
rappresentare gli stati Loading, Success(users: List e
Error(message: String). Crea una funzione in ViewModel per recuperare gli utenti e aggiornare lo stato. Scrivi i test delle unità per la nuova funzionalità.
Prompt 4: il livello UI
Infine, scrivi una funzione Jetpack Compose denominata UserListScreen che accetti UiState come parametro. Utilizza un'istruzione when per visualizzare un CircularProgressIndicator per lo stato di caricamento, un LazyColumn di nomi utente per lo stato di esito positivo e un elemento Text con il messaggio di errore per lo stato di errore. Aggiungi test che verifichino la nuova funzionalità.
Cosa non fare
ViewModel che utilizza Retrofit e coroutine, un repository per gestire la logica dei dati, una classe di dati User e deve mostrare gli stati di caricamento e di errore.Gestisci il contesto
Una parte importante del lavoro con l'agente è fornire il contesto giusto. Fornisci snippet di codice pertinenti, contenuti dei file e informazioni sulla struttura del progetto per ottenere le risposte più utili. Potresti dover ripetere l'operazione per trovare il giusto equilibrio: troppe informazioni potrebbero confondere l'agente, mentre troppo poche non fornirebbero un contesto sufficiente per aiutarlo. Utilizza le funzionalità disponibili per consentire all'agente di accedere al contesto necessario:
- Allega immagini per fornire una rappresentazione visiva della UI che stai immaginando o dell'architettura dell'app che stai cercando di comprendere.
- Allega file per evidenziare le parti pertinenti del codebase.
- Utilizza i file
.aiexcludeper fare in modo che l'agente ignori determinate parti del codebase. - Utilizza i file AGENTS.md per fornire istruzioni specifiche per il progetto e condividerle con il tuo team. Quando utilizzi i file AGENTS.md, utilizza le intestazioni e la formattazione Markdown per rendere chiare le istruzioni.
- Quando utilizzi la modalità Agente, configura i server MCP per estendere le conoscenze e le funzionalità dell'agente con l'ambiente esterno.
Chiedi spiegazioni
Se non capisci la risposta dell'agente, chiedi una spiegazione. Questo è un ottimo modo per imparare e verificare che la soluzione proposta sia appropriata per il tuo caso d'uso. Se la risposta non è quella che ti aspettavi, potrebbe essere che l'agente abbia sbagliato e chiedere una spiegazione gli darà l'opportunità di correggersi.
Perfeziona le istruzioni
Come quando collabori con un collega, lavorare con l'agente a volte richiede una comunicazione continua per chiarire l'attività e il risultato previsto. Se la risposta iniziale dell'agente non è sufficiente, rispondi con feedback e suggerimenti su come migliorare. Se la risposta migliora in base ai tuoi suggerimenti, incorpora il suggerimento nel prompt originale aggiornando la voce nella libreria dei prompt o aggiornando i file AGENTS.md.