Questo documento descrive come creare un agente di dati in Spanner 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 di Spanner
- Assicurati che sia disponibile un'istanza Spanner. Per saperne di più, vedi Crea un'istanza.
- Compila il database con i dati e lo schema a cui l'utente finale vuole accedere.
Ruoli e autorizzazioni richiesti
- Aggiungi un utente IAM o account di servizio al cluster. Per ulteriori informazioni, consulta Applicare i ruoli IAM.
- Concedi i ruoli
spanner.databaseReaderall'utente IAM a livello di progetto. Per saperne di più, consulta Aggiungere un binding di policy IAM per un progetto. - Concedi ruoli e autorizzazioni all'utente IAM a livello di progetto per i database richiesti.
Crea un agente dati
Per creare un agente dati:
Nella console Google Cloud , vai alla pagina Spanner.
Seleziona un'istanza dall'elenco e poi seleziona un database.
Nel menu di navigazione, fai clic su Spanner Studio.
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 Spanner.
Seleziona un'istanza dall'elenco e poi seleziona un database.
Nel menu di navigazione, fai clic su Spanner Studio.
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 Spanner.
Seleziona un'istanza dall'elenco e poi seleziona un database.
Nel menu di navigazione, fai clic su Spanner Studio.
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.