Gestire i set di contesto in Spanner 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.

Nota sull'interfaccia PostgreSQL: Gli esempi riportati in questo argomento sono destinati ai database con dialetto GoogleSQL. Questa funzionalità non supporta l'interfaccia PostgreSQL.

Questo documento descrive come creare set di contesto in Spanner 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 Spanner

• Assicurati che sia disponibile un'istanza Spanner. Per saperne di più, consulta Crea un'istanza.
• Assicurati di creare un database nella tua istanza in cui creerai le tabelle. Per saperne di più, consulta Crea un database nell'istanza Spanner.

Questo tutorial richiede un database nell'istanza Spanner. Per saperne di più, consulta Crea un database.

Ruoli e autorizzazioni richiesti

• Aggiungi un utente o account di servizio IAM al cluster. Per saperne di più, consulta Applica i ruoli IAM.
• Concedi i ruoli spanner.databaseReader e geminidataanalytics.queryDataUser all'utente IAM a livello di progetto. Per saperne di più, consulta Aggiungi l'associazione della 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 a livello di progetto. Per saperne di più, consulta Autorizzazioni per i set di contesti.
• Concedi ruoli e autorizzazioni all'utente IAM a livello di progetto per i database richiesti.

Crea un set di contesti

Per creare un set di contesti, segui questi passaggi:

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

   Vai a Spanner

2. Seleziona un'istanza dall'elenco, quindi seleziona un database.

3. Nel menu di navigazione, fai clic su Spanner Studio.

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

5. Fai clic su Crea set di contesti.

6. 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.

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

8. 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.

9. 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 Spanner.

   Vai a Spanner

2. Seleziona un'istanza dall'elenco, quindi seleziona un database.

3. Nel menu di navigazione, fai clic su Spanner Studio.

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

5. Fai clic su Modifica set di contesti.

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

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

8. 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 Spanner.

   Vai a Spanner

2. Seleziona un'istanza dall'elenco, quindi seleziona un database.

3. Nel menu di navigazione, fai clic su Spanner Studio.

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

5. Fai clic su Elimina set di contesti.

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

7. 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.