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:

Modulo 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 alle fonti 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 saperne di più, vedi Chattare con Gemini Code Assist.
Genera codice Nella barra di selezione rapida dell'IDE, con o senza codice selezionato, premi Command+Invio (su macOS) o Ctrl+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 confidenza 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 saperne di più, consulta Ottenere completamenti del codice.

Contesto del repository remoto
  1. Inizia il prompt con il simbolo @. Viene visualizzato un elenco di repository remoti disponibili indicizzati.
  2. Seleziona il repository da 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.

Considera quanto segue:

  • Questa opzione è utile quando lavori a un'attività principalmente correlata a un insieme specifico di microservizi, librerie o moduli.

Per ulteriori informazioni, vedi Ricevere 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 fare quanto segue per generare codice nel tuo IDE o nella chat di Gemini Code Assist:

  • Genera codice che utilizzi termini già menzionati nel tuo codebase.
  • Incolla il codice, ad esempio una firma funzionale o un codice con commenti TODO, quindi chiedi a Gemini Code Assist di compilare o sostituire i commenti TODO con il codice. Aggiungi commenti con spiegazione 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 di integrità".
  • "Scrivi un FUNCTION_OR_CLASS nella seguente struttura: EXPLAIN_STRUCTURE."

Dopo aver generato del codice, prova a utilizzare un prompt di follow-up per migliorarlo:

  • "Prova il comando /fix per modificare il codice generato, ad esempio gli errori di sintassi."
  • "Aggiungi 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 funzione FUNCTION_NAME?"
  • "Puoi unire FUNCTION_NAME_1 e FUNCTION_NAME_2 in un'unica funzione?"
  • "Potresti incorporare 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 bianchi 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 darmi un codice utile dal contesto REPOSITORY_NAME_PACKAGE_MODULE per questo codice?"
  • "Cosa 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é?"
  • "Riesci a individuare un errore nella funzione FUNCTION_NAME?"
  • "Come risolveresti il problema della funzione FUNCTION_NAME dato questo messaggio di errore?"
Apprendimento e onboarding

Prova i seguenti prompt nella chat di Gemini Code Assist:

  • "Dividi questo codice in parti e spiega ciascuna di esse utilizzando il nostro codebase."
  • "Mostra come chiamare la funzione FUNCTION_NAME?"
  • "Mostra come eseguire la funzione principale nell'ambiente ENVIRONMENT_NAME?"
  • "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 cos'è 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:

  • "Dammi una strategia per eseguire la migrazione di FILE_NAME da LANGUAGE_1 a LANGUAGE_2", ad esempio da Go a Python.
  • "Data la funzione FUNCTION_NAME nel repository REPOSITORY_NAME, trova 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:

  1. "Prendi il codice FILENAME_COMPONENT già scritto in LANGUAGE_1 e refactor e migralo a LANGUAGE_2", ad esempio, da Go a Python.
  2. Dopo aver eseguito la migrazione di parte del codice, prova a effettuare le seguenti operazioni:
    • Seleziona blocchi più piccoli e utilizza /fix per portarli allo stato che preferisci.
    • Prova i seguenti prompt:
      • "C'è qualcosa che può essere migliorato?"
      • "Dammi possibili pain point."
      • "Come testeresti questo codice se la migrazione è corretta?"
Generazione della documentazione in corso

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 primi cinque metodi 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 unitari per FILENAME."
  • "Aggiungi gli scenari di test più pertinenti per la funzione FUNCTION_NAME."
  • "Rimuovi gli scenari di test che ritieni non apportino molto valore."

Best practice

  • Utilizza nomi di variabili e funzioni o snippet di codice pertinenti. Questa guida alla personalizzazione del codice ti indirizza verso gli esempi di codice più pertinenti.
  • Utilizza i repository di indici che vuoi scalare ed evita di aggiungere funzionalità ritirate. La personalizzazione del codice consente di scalare lo stile del codice, i pattern, la semantica, le conoscenze e le implementazioni del codice in tutto il codebase. Esempi negativi di repository da scalare sono funzionalità ritirate, codice generato e 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".
  • Avere include o importazioni presenti nel file per il codice che vuoi recuperare per migliorare la consapevolezza contestuale di Gemini.
  • 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 dell'errore), utilizza la personalizzazione del codice per la chat, in cui puoi conversare con Gemini con la tua codebase nel contesto.
  • Tieni presente che la generazione di modelli di AI non è deterministica. Se non sei soddisfatto della risposta, l'esecuzione dello stesso prompt potrebbe portare a 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.

Ricevi suggerimenti più pertinenti con il contesto del repository remoto

Puoi ottenere suggerimenti di codice più pertinenti e consapevoli del contesto indirizzando Gemini Code Assist a 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 a un'attività principalmente correlata a 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 di repository remoti disponibili indicizzati.
  2. Seleziona il repository da 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.

Prompt di esempio

Ecco alcuni esempi di come puoi utilizzare questa funzionalità:

  • Per comprendere un repository:
    • "@REPOSITORY_NAME Qual è la struttura complessiva 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 in questo repository."
    • "@REPOSITORY_NAME Rimodella il seguente codice in modo che segua le convenzioni nel 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 mirata di contesto, puoi ottenere suggerimenti più accurati e pertinenti da Gemini Code Assist, che può aiutarti a scrivere codice in modo più rapido ed efficiente.