Gestisci gli agenti di dati in AlloyDB Studio

Questo documento descrive come creare un agente dati in AlloyDB per PostgreSQL Studio utilizzando un file di contesto dell'agente. Un agente dati è associato a un singolo file di contesto dell'agente.

Per scoprire di più sugli agenti dati, consulta la panoramica degli agenti dati.

Prima di iniziare

Completa i seguenti prerequisiti prima di creare un agente.

Abilita i servizi richiesti

Abilita i seguenti servizi per il tuo progetto:

Prepara un cluster e un'istanza AlloyDB per PostgreSQL

Assicurati di avere accesso a un cluster e a un'istanza AlloyDB esistenti o creane uno nuovo.

Ruoli e autorizzazioni richiesti

Concedi l'autorizzazione executesql all'istanza AlloyDB per PostgreSQL

Per concedere l'autorizzazione executesql all'istanza AlloyDB per PostgreSQL e impostare l'impostazione dell'istanza data_api_access sul valore ALLOW_DATA_API, utilizza il seguente comando curl : 
   curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     https://alloydb.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/clusters/CLUSTER_ID/instances/INSTANCE_ID?updateMask=dataApiAccess \
     -d '{
       "dataApiAccess": "ENABLED",
     }'
Sostituisci quanto segue:
  • PROJECT_ID: l'ID del tuo Google Cloud progetto.
  • LOCATION: la regione in cui si trova il cluster AlloyDB.
  • CLUSTER_ID: l'ID del cluster AlloyDB.
  • INSTANCE_ID: l'ID dell'istanza AlloyDB.
Per eseguire i passaggi di questo tutorial, accedi a Google Cloud e poi autenticati al database utilizzando l'autenticazione IAM.

Crea un agente dati

Per creare un agente dati, svolgi i seguenti passaggi:

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

    Vai ad AlloyDB

  2. Seleziona un cluster dall'elenco.

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

  4. Accedi a Studio utilizzando l'autenticazione Identity and Access Management (IAM).

  5. Nel riquadro Explorer, accanto ad Agenti dati, fai clic su Visualizza azioni.

  6. Fai clic su Crea agente.

  7. In Nome agente, fornisci un nome agente univoco. Il nome dell'agente fa distinzione tra maiuscole e minuscole e può contenere lettere, numeri, trattini e trattini bassi.

  8. (Facoltativo) In Descrizione agente, aggiungi una descrizione per l'agente.

  9. (Facoltativo) Fai clic su Mostra opzioni avanzate e in Seleziona una località seleziona una regione in cui archiviare il contesto dell'agente. Puoi selezionare una delle seguenti regioni supportate:

    • us-central1
    • us-east1
    • europe-west4
    • asia-southeast1

  10. Fai clic su Crea.

Crea il contesto dell'agente

Dopo aver creato un agente, segui i passaggi descritti in Creare contesti utilizzando Gemini CLI per creare un file di contesto dell'agente. Puoi quindi modificare l'agente per caricare il file di contesto.

Modifica un agente

Per modificare un agente dati, svolgi i seguenti passaggi:

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

    Vai ad AlloyDB

  2. Seleziona un cluster dall'elenco.

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

  4. Accedi a Studio utilizzando l'autenticazione Identity and Access Management (IAM).

  5. Nel riquadro Explorer, accanto ad Agenti dati, fai clic su Visualizza azioni.

  6. Fai clic su Modifica agente.

  7. (Facoltativo) Modifica la Descrizione agente.

  8. Fai clic su Sfoglia nella sezione Carica file di contesto dell'agente e seleziona il file di contesto dell'agente.

  9. Fai clic su Salva.

Elimina un agente dati

Per eliminare un agente dati, svolgi i seguenti passaggi:

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

    Vai ad AlloyDB

  2. Seleziona un cluster dall'elenco.

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

  4. Accedi a Studio utilizzando l'autenticazione Identity and Access Management (IAM).

  5. Nel riquadro Explorer, accanto ad Agenti dati, fai clic su Visualizza azioni.

  6. Fai clic su Elimina agente.

  7. Nella finestra di dialogo di conferma Elimina agente, inserisci il nome dell'agente.

  8. Fai clic su Conferma per eliminare l'agente.

Passaggi successivi