Utilizzare la personalizzazione del codice di Gemini Code Assist

Questo documento descrive come utilizzare la personalizzazione del codice di Gemini Code Assist e fornisce alcune best practice. Questa funzionalità ti consente di ricevere suggerimenti sul codice, che si basano sulle librerie interne, sulle API private e sullo stile di programmazione della tua organizzazione.

Prima di iniziare

1. Configura Gemini Code Assist con un abbonamento Enterprise.

2. Configura la personalizzazione del codice di Gemini Code Assist.

Come utilizzare la personalizzazione del codice

La tabella seguente elenca i modi per utilizzare la personalizzazione del codice di Gemini Code Assist:

Postura	Come attivare	Note e risorse
Chat in linguaggio naturale	Inserisci un prompt in linguaggio naturale nella chat di Gemini Code Assist nell'IDE.	Considera quanto segue: La cronologia chat non è disponibile. Evita le query in più passaggi. Puoi chiedere maggiori dettagli sulle fonti, inclusi i link a quelle specifiche. Se evidenzi o selezioni il codice quando invii un messaggio nella chat, Gemini Code Assist utilizza questo codice per migliorare la personalizzazione del codice e la qualità della chat. Per ulteriori informazioni, consulta Chat con Gemini Code Assist.
Genera codice	Nella barra di selezione rapida dell'IDE, con o senza codice selezionato, premi Command+Invio (su macOS) o Control+Invio.	Per ulteriori informazioni, consulta Generare codice con i prompt.
Trasforma codice	Nella barra di selezione rapida dell'IDE, con o senza codice selezionato, inserisci /fix.	Per ulteriori informazioni, consulta Generare codice con i prompt.
Completamento automatico	La personalizzazione del codice viene attivata automaticamente e fornisce suggerimenti in base a ciò che scrivi.	Considera quanto segue: Il completamento del codice richiede un certo livello di attendibilità per proporre un suggerimento. Assicurati che sia disponibile una quantità significativa di codice in modo che vengano recuperati gli snippet pertinenti. Il completamento del codice verifica se hai le librerie richieste per utilizzare determinati elementi della funzione. Per ulteriori informazioni, consulta Ottenere completamenti del codice.
Contesto del repository remoto	Inizia il prompt con il simbolo @. Viene visualizzato un elenco dei repository remoti indicizzati disponibili. Seleziona il repository che vuoi utilizzare per il contesto dall'elenco. Puoi anche iniziare a digitare il nome del repository per filtrare l'elenco. Dopo aver selezionato il repository, scrivi il resto del prompt.	Il contesto del repository remoto è utile quando lavori su un'attività che riguarda principalmente un insieme specifico di microservizi, librerie, o moduli. Per ulteriori informazioni, consulta Ottenere suggerimenti più pertinenti con il contesto del repository remoto.

Casi d'uso ed esempi di prompt

La tabella seguente fornisce indicazioni ed esempi sull'utilizzo della personalizzazione del codice in casi d'uso specifici:

Caso d'uso	Cose da provare
Scrittura di nuovo codice	Prova a eseguire le seguenti operazioni per generare codice nell'IDE o nella chat di Gemini Code Assist: Genera codice che utilizzi termini già menzionati in your codebase. Incolla il codice, ad esempio una firma funzionale o un codice con TODO commenti, quindi chiedi a Gemini Code Assist di compilare o sostituire TODO commenti con il codice. Aggiungi commenti con spiegazioni dal contesto. Prova a generare codice con i seguenti prompt nella chat di Gemini Code Assist: "Scrivi una funzione principale in cui viene creata una connessione a DATABASE. Includi i controlli dello stato." Scrivi un FUNCTION_OR_CLASS nella seguente struttura: EXPLAIN_STRUCTURE. Dopo aver generato del codice, prova a utilizzare un prompt aggiuntivo per migliorare: Prova il comando /fix per modificare il codice generato, ad esempio gli errori di sintassi. "Aggiungi le importazioni mancanti." "Prova /fix sul codice generato dalla chat."
Pulizia, semplificazione e refactoring del codice	Prova i seguenti prompt nella chat di Gemini Code Assist: "Puoi unire IMPORTS_VARIABLES_OR_NOTE_EXPORTED_FUNCTIONS in questo file?" "Come semplificheresti la FUNCTION_NAME funzione?" "Puoi unire FUNCTION_NAME_1 e FUNCTION_NAME_2 in una sola funzione?" "Potresti inserire alcune variabili in FUNCTION_NAME?" "Potresti semplificare la denominazione delle variabili nella funzione FUNCTION_NAME?"
Leggibilità	Prova i seguenti prompt nella chat di Gemini Code Assist: Scrivi la funzione FUNCTION_NAME in meno righe di codice, se possibile. "Aggiungi commenti alla funzione FUNCTION_NAME." Rimuovi gli spazi vuoti non necessari nella funzione FUNCTION_NAME. "Formatta la funzione FUNCTION_NAME in modo simile al resto del codice."
Revisione del codice	Prova i seguenti prompt nella chat di Gemini Code Assist: "Dividi il codice in parti e spiega ogni parte utilizzando il nostro codebase." "Esistono variabili o parole chiave che potrebbero essere più brevi e più autoesplicative?" "Puoi fornirmi codice utile dal REPOSITORY_NAME_PACKAGE_MODULE contesto per questo codice?" "Cosa ne pensi della funzione FUNCTION_NAME?"
Debug	Prova i seguenti prompt nella chat di Gemini Code Assist: "Ricevo un errore quando provo a eseguire X/aggiungere Y. Perché?" "Puoi individuare un errore nella funzione FUNCTION_NAME?" "Come correggeresti la funzione FUNCTION_NAME dato questo errore messaggio?"
Apprendimento e onboarding	Prova i seguenti prompt nella chat di Gemini Code Assist: "Dividi questo codice in parti e spiega ognuna di esse utilizzando il nostro codebase." Mostra come chiamare la funzione FUNCTION_NAME? "Mostra come eseguire la funzione principale nell' ENVIRONMENT_NAME ambiente?" "Qual è il miglioramento tecnico chiave che possiamo apportare per rendere questo codice più efficiente?" "Mostrami l'implementazione di FUNCTION_OR_CLASS_NAME per ottenere risultati migliori e aggiungi di cosa si tratta di questo elemento specifico", ad esempio, "Mostrami l'implementazione della funzione foo, dove foo è il nome della funzione".
Migrazione	Prova i seguenti prompt nella chat di Gemini Code Assist: "Forniscimi una strategia per eseguire la migrazione FILE_NAME da LANGUAGE_1 a LANGUAGE_2", ad esempio da Go a Python. "Data la funzione FUNCTION_NAME in repository REPOSITORY_NAME, trovami una funzione equivalente nel linguaggio LANGUAGE_NAME che posso utilizzare." Prova il seguente flusso di lavoro di trasformazione basato sulla chat o sulla generazione di codice utilizzando i prompt: "Prendi il codice FILENAME_COMPONENT già scritto in LANGUAGE_1, esegui il refactoring e la migrazione a LANGUAGE_2", ad esempio da Go a Python. Dopo aver eseguito la migrazione di parte del codice, prova a: Seleziona blocchi più piccoli e utilizza /fix per portarlo allo stato desiderato. Prova i seguenti prompt: "C'è qualcosa che può essere migliorato?" "Forniscimi i possibili punti critici." "Come testeresti questo codice se la migrazione è corretta?"
Generazione della documentazione	Prova i seguenti prompt nella chat di Gemini Code Assist: "Riassumi il codice nel pacchetto o nella cartella X e fornisci la documentazione per i cinque metodi più importanti." "Genera la documentazione per FUNCTION_OR_CLASS_NAME." "Abbrevia la documentazione mantenendo le informazioni chiave."
Generazione di test delle unità	Prova i seguenti prompt nella chat di Gemini Code Assist: "Genera test delle unità per FILENAME." "Aggiungi i casi di test più pertinenti per la FUNCTION_NAME funzione." "Rimuovi i casi di test che ritieni non apportino molto valore."

Best practice

• Utilizza nomi di variabili e funzioni o snippet di codice pertinenti. In questo modo, la personalizzazione del codice viene indirizzata verso gli esempi di codice più pertinenti.
• Utilizza i repository di indici che vuoi scalare ed evita di aggiungere funzionalità obsolete. La personalizzazione del codice consente di scalare lo stile del codice, i pattern, la semantica del codice, le conoscenze e le implementazioni nel codebase. Esempi di repository da non scalare sono le funzionalità obsolete, il codice generato e le implementazioni legacy.
• Per i casi d'uso di recupero del codice, utilizza la funzionalità di generazione del codice anziché il completamento del codice. Prompt che utilizzano un linguaggio come "Utilizzando la definizione di FUNCTION_NAME, genera esattamente la stessa funzione" o "Genera l'implementazione esatta di FUNCTION_NAME".
• Per migliorare la consapevolezza del contesto di Gemini, assicurati che nel file siano presenti include o importazioni per il codice che vuoi recuperare.
• Esegui una sola azione per ogni prompt. Ad esempio, se vuoi recuperare il codice e implementarlo in una nuova funzione, esegui questi passaggi in due prompt.
• Per i casi d'uso in cui vuoi qualcosa di più del semplice codice (ad esempio spiegazione del codice, piano di migrazione o spiegazione degli errori), utilizza la personalizzazione del codice per la chat, in cui puoi conversare con Gemini con il codebase nel contesto.
• Tieni presente che la generazione del modello AI non è deterministica. Se non sei soddisfatto della risposta, l'esecuzione dello stesso prompt potrebbe produrre un risultato migliore.
• Tieni presente che la generazione di test delle unità in genere funziona meglio se apri il file localmente e poi, dalla chat, chiedi di generare test delle unità per questo file o per una funzione specifica.

Ottenere suggerimenti più pertinenti con il contesto del repository remoto

Puoi ottenere suggerimenti sul codice più pertinenti e consapevoli del contesto chiedendo a Gemini Code Assist di concentrarsi su repository remoti specifici. Utilizzando il simbolo @ nella chat, puoi selezionare uno o più repository da utilizzare come fonte principale di contesto per i tuoi prompt. Questa opzione è utile quando lavori su un'attività che riguarda principalmente un insieme specifico di microservizi, librerie o moduli.

Per utilizzare un repository remoto come contesto, segui questi passaggi nella chat dell'IDE:

1. Inizia il prompt con il simbolo @. Viene visualizzato un elenco dei repository remoti indicizzati disponibili.
2. Seleziona il repository che vuoi utilizzare per il contesto dall'elenco. Puoi anche iniziare a digitare il nome del repository per filtrare l'elenco.
3. Dopo aver selezionato il repository, scrivi il resto del prompt.

Gemini darà la priorità al repository selezionato durante la generazione di una risposta.

Esempi di prompt

Ecco alcuni esempi di come puoi utilizzare questa funzionalità:

• Per comprendere un repository:
  • "@REPOSITORY_NAME Qual è la struttura generale di questo repository?"
  • "@REPOSITORY_NAME Sono un nuovo membro del team. Puoi darmi una panoramica dello scopo e dei moduli chiave di questo repository?"
• Per la generazione e la modifica del codice:
  • "@REPOSITORY_NAME Implementa una funzione di autenticazione simile a quella di questo repository."
  • "@REPOSITORY_NAME Esegui il refactoring del seguente codice in modo che segua le convenzioni del repository selezionato."
  • "@REPOSITORY_A_NAME Come posso utilizzare le ultime funzioni di questo repository per migliorare il mio codice in REPOSITORY_B_NAME?"
• Per i test:
  • "@UNIT_TEST_FILE_NAME Genera test delle unità per MODULE in base agli esempi nel file selezionato."

Utilizzando i repository remoti come fonte di contesto mirata, puoi ottenere suggerimenti più accurati e pertinenti da Gemini Code Assist, che può aiutarti a scrivere codice in modo più rapido ed efficiente.