Questo documento descrive come creare un agente di 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 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 cluster e un'istanza AlloyDB per PostgreSQL
- Assicurati di avere accesso a un cluster e a un'istanza AlloyDB esistenti o creane uno nuovo.
- Popola il database con i dati e lo schema a cui l'utente finale vuole accedere.
Ruoli e autorizzazioni richiesti
- Aggiungi un utente o un account di servizio Identity and Access Management (IAM) al cluster a livello di database. Per maggiori informazioni, consulta Gestire gli utenti del database.
- Concedi il ruolo
alloydb.databaseUserall'utente IAM a livello di progetto. Per saperne di più, consulta Aggiungere il binding dei criteri IAM per un progetto.
Crea un agente dati
Per creare un agente dati:
Nella console Google Cloud , vai alla pagina AlloyDB.
Seleziona un cluster dall'elenco.
Nel menu di navigazione, fai clic su AlloyDB 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.
Fai clic su Crea.
Creare 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 AlloyDB.
Seleziona un cluster dall'elenco.
Nel menu di navigazione, fai clic su AlloyDB 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 AlloyDB.
Seleziona un cluster dall'elenco.
Nel menu di navigazione, fai clic su AlloyDB 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.