Questo documento descrive come creare un agente dati in Cloud SQL per MySQL 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 Panoramica degli agenti dati.Prima di iniziare
Completa i seguenti prerequisiti prima di creare un agente.
Attivare i servizi richiesti
Attiva i seguenti servizi per il tuo progetto:
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.
- Popola il database con i dati e lo schema a cui l'utente finale vuole accedere.
Ruoli e autorizzazioni richiesti
- Aggiungi un utente IAM o un account di servizio al cluster a livello di istanza. Per maggiori informazioni, consulta Gestire gli utenti con l'autenticazione IAM dei database.
- Concedi i ruoli
cloudsql.studioUserecloudsql.instanceUserall'utente IAM a livello di progetto. Per saperne di più, consulta Aggiungere l'associazione di policy IAM per un progetto. Devi inoltre concedere i privilegi del database a
un utente IAM o a un account di servizio. Per maggiori informazioni, vedi Concedere privilegi di database a un singolo utente IAM o service account.
Concedi l'autorizzazione executesql all'istanza Cloud SQL
Per concedere l'autorizzazione executesql all'istanza Cloud SQL e abilitare l'API Cloud SQL
Data, esegui questo comando:
gcloud beta sql instances patch INSTANCE_ID --data-api-access=ALLOW_DATA_API
INSTANCE_ID con l'ID dell'istanza Cloud SQL.
Crea un agente dati
Per creare un agente dati, svolgi i seguenti passaggi:
Nella console Google Cloud , vai alla pagina Cloud SQL.
Seleziona un'istanza dall'elenco.
Nel menu di navigazione, fai clic su Cloud SQL Studio.
Accedi a Studio utilizzando l'autenticazione Identity and Access Management (IAM).
Nel riquadro Explorer, accanto a Data Agents, fai clic su Visualizza azioni.
Fai clic su Crea agente.
In Nome agente, fornisci un nome univoco per l'agente. Il nome dell'agente fa distinzione tra maiuscole e minuscole e può contenere lettere, numeri, trattini e trattini bassi.
Facoltativo. In Descrizione agente, aggiungi una descrizione dell'agente.
Facoltativo. Fai clic su Mostra opzioni avanzate e in Seleziona una località, seleziona una regione per archiviare il contesto dell'agente. Puoi scegliere dall'elenco seguente di regioni supportate:
- us-central1
- us-east1
- europe-west4
- asia-southeast1
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. A questo punto puoi modificare l'agente per caricare il file di contesto.
Modificare un agente
Per modificare un agente dati:
Nella console Google Cloud , vai alla pagina Cloud SQL.
Seleziona un'istanza dall'elenco.
Nel menu di navigazione, fai clic su Cloud SQL Studio.
Accedi a Studio utilizzando l'autenticazione Identity and Access Management (IAM).
Nel riquadro Explorer, accanto a Data Agents, fai clic su Visualizza azioni.
Fai clic su Modifica agente.
(Facoltativo) Modifica la descrizione dell'agente.
Fai clic su Sfoglia nella sezione Carica file di contesto dell'agente e seleziona il file di contesto dell'agente.
Fai clic su Salva.
Eliminare un agente di dati
Per eliminare un agente dati:
Nella console Google Cloud , vai alla pagina Cloud SQL.
Seleziona un'istanza dall'elenco.
Nel menu di navigazione, fai clic su Cloud SQL Studio.
Accedi a Studio utilizzando l'autenticazione Identity and Access Management (IAM).
Nel riquadro Explorer, accanto a Data Agents, fai clic su Visualizza azioni.
Fai clic su Elimina agente.
Nella finestra di dialogo di conferma Elimina agente, inserisci il nome dell'agente.
Fai clic su Conferma per eliminare l'agente.
Passaggi successivi
- Scopri di più sugli agenti di dati.
- Scopri come ispezionare e chiamare un agente dati.