Gestisci i set di contesto in Cloud SQL Studio

Anteprima

Queste funzionalità sono ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini di servizio specifici e ai Termini aggiuntivi per i prodotti in anteprima dell'AI generativa. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Questo documento descrive come creare set di contesto in Cloud SQL per MySQL Studio utilizzando un file di set di contesto. I nomi dei set di contesto devono essere univoci all'interno di un progetto.

Per scoprire di più sui set di contesto, consulta la panoramica dei set di contesto.

Prima di iniziare

Completa i seguenti prerequisiti prima di creare un agente.

Attiva i servizi richiesti

Abilita i seguenti servizi per il tuo progetto:

• API Data Analytics con Gemini
• API Gemini for Google Cloud
• API Knowledge Catalog

Prepara un'istanza Cloud SQL

• Assicurati di avere accesso a un'istanza Cloud SQL esistente o creane una nuova. Per saperne di più, consulta Crea istanze per Cloud SQL.
• Assicurati di creare un database nell'istanza in cui creerai le tabelle. Per saperne di più, consulta Crea un database nell'istanza Cloud SQL.

Ruoli e autorizzazioni richiesti

• Abilita l'autenticazione del database IAM sull'istanza impostando il flag di database cloudsql_iam_authentication su on (cloudsql_iam_authentication=on). Per saperne di più, consulta Configura le istanze esistenti per l'autenticazione del database IAM.
• Aggiungi un utente o un account di servizio IAM a livello di istanza. Per saperne di più, consulta Aggiungi un'associazione di policy IAM a un utente, un account di servizio o un gruppo.
• Concedi i ruoli cloudsql.studioUser, cloudsql.instanceUser e geminidataanalytics.queryDataUser all'utente o al account di servizio IAM a livello di progetto. Per saperne di più, consulta Aggiungi l'associazione delle policy IAM per un progetto.
• Per creare, caricare e gestire i set di contesto, concedi il ruolo Dataplex Catalog Editor (roles/dataplex.catalogEditor) o Dataplex Catalog Admin (roles/dataplex.catalogAdmin) all'utente IAM o al account di servizio a livello di progetto. Per saperne di più, consulta Autorizzazioni dei set di contesto.
• Un utente con privilegi deve concedere i privilegi del database all'utente o al service account IAM.
  
  GRANT SELECT PRIVILEGES ON * TO "IAM_USERNAME";.
  
  Per saperne di più, consulta Concedi i privilegi del database a un singolo utente o service account IAM.

Concedi l'autorizzazione executesql all'istanza Cloud SQL

Per concedere l'autorizzazione executesql all'istanza Cloud SQL e abilitare l'API di dati Cloud SQL, esegui questo comando:

gcloud sql instances patch INSTANCE_ID --project=PROJECT_ID --data-api-access=ALLOW_DATA_API

Sostituisci quanto segue:

• PROJECT_ID: l'ID del tuo progetto Google Cloud .
• INSTANCE_ID: l'ID dell'istanza Cloud SQL.

Per eseguire i passaggi di questo tutorial, accedi a Google Cloud, quindi esegui l'autenticazione nel database utilizzando l'autenticazione IAM.

Crea un set di contesti

Per creare un set di contesti, segui questi passaggi:

1. Nella console Google Cloud , vai alla pagina Cloud SQL.

   Vai a Cloud SQL

2. Seleziona un'istanza dall'elenco.

3. Nel menu di navigazione, fai clic su Cloud SQL Studio.

4. Accedi a Studio utilizzando l'autenticazione IAM.

5. Nel riquadro Explorer, accanto a Set di contesto, fai clic su Visualizza azioni.

6. Fai clic su Crea set di contesti.

7. In Nome set di contesti, fornisci un nome univoco per il set di contesti. Il nome del set di contesti è sensibile alle maiuscole e può contenere lettere, numeri, trattini e trattini bassi. I nomi devono avere una lunghezza compresa tra 4 e 30 caratteri.

   L'ID del set di contesti deriva dal nome del set di contesti, ma non è necessariamente identico. Per l'ID del set di contesti, il nome del set di contesti viene convertito in minuscolo e i caratteri non alfanumerici vengono sostituiti con il carattere -. Ad esempio, il nome del set di contesti querydata_e2e_test ha l'ID set di contesti querydata-e2e-test.

8. Facoltativo. In Descrizione set di contesti, aggiungi una descrizione per il set di contesti.

9. Facoltativo. Per caricare un file del set di contesto, fai clic su Sfoglia nella sezione Carica file del set di contesto e seleziona il file del set di contesto.

10. Fai clic su Crea.

Nota: la creazione del primo set di contesti in un progetto può richiedere diversi minuti.

Crea set di contesti

Dopo aver creato un set di contesti, segui i passaggi descritti in Crea contesti utilizzando Gemini CLI per creare un file del set di contesti. Puoi quindi modificare il set di contesto per caricare il file del set di contesto.

Modifica un set di contesti

Per modificare un set di contesti, segui questi passaggi:

1. Nella console Google Cloud , vai alla pagina Cloud SQL.

   Vai a Cloud SQL

2. Seleziona un'istanza dall'elenco.

3. Nel menu di navigazione, fai clic su Cloud SQL Studio.

4. Accedi a Studio utilizzando l'autenticazione IAM.

5. Fai clic su Visualizza azioni accanto al set di contesti da modificare.

6. Fai clic su Modifica set di contesti.

7. Facoltativo. Modifica la descrizione del set di contesti.

8. Fai clic su Sfoglia nella sezione Carica file del set di contesto e seleziona il file del set di contesto.

9. Fai clic su Salva.

Elimina un set di contesti

Per eliminare un set di contesti, segui questi passaggi:

1. Nella console Google Cloud , vai alla pagina Cloud SQL.

   Vai a Cloud SQL

2. Seleziona un'istanza dall'elenco.

3. Nel menu di navigazione, fai clic su Cloud SQL Studio.

4. Accedi a Studio utilizzando l'autenticazione IAM.

5. Fai clic su Visualizza azioni accanto all'insieme di contesti che vuoi eliminare.

6. Fai clic su Elimina set di contesti.

7. Nella finestra di dialogo di conferma Elimina set di contesti, inserisci l'ID del set di contesti.

8. Fai clic su Conferma per eliminare il set di contesti.

Nota: prima di eliminare un database, devi eliminare tutti i set di contesto associati a quel database.

Passaggi successivi

• Scopri di più sui set di contesti.
• Scopri come testare un set di contesti.
• Scopri come creare contesti utilizzando Gemini CLI.