Questo documento descrive come creare un agente di dati in Spanner Studio utilizzando un file di contesto dell'agente. Un agente di dati è associato a un singolo file di contesto dell'agente.
Per saperne di più sugli agenti di dati, consulta la panoramica sugli agenti di 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'istanza di Spanner
- Assicurati che sia disponibile un'istanza di Spanner. Per saperne di più, vedi Crea un'istanza.
- Assicurati di creare un database nell'istanza in cui creerai le tabelle. Per saperne di più, vedi Crea un database nell'istanza di Spanner.
Ruoli e autorizzazioni richiesti
- Aggiungi un utente IAM o account di servizio al cluster. Per saperne di più, vedi Applica i ruoli IAM.
- Concedi i ruoli
spanner.databaseReaderall'utente IAM a livello di progetto. Per saperne di più, vedi Aggiungi un binding della policy IAM per un progetto. - Concedi ruoli e autorizzazioni all'utente IAM a livello di progetto per i database richiesti.
Crea un agente di dati
Per creare un agente di dati:
Nella Google Cloud console, vai alla pagina Spanner.
Seleziona un'istanza dall'elenco, quindi seleziona un database.
Nel menu di navigazione, fai clic su Spanner Studio.
Nel riquadro Explorer, accanto a Agenti di dati, fai clic su Visualizza azioni.
Fai clic su Crea agente.
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.
(Facoltativo) In Descrizione agente, aggiungi una descrizione per l'agente.
(Facoltativo) Fai clic su Mostra opzioni avanzate e in Seleziona una località, seleziona una regione per archiviare il contesto dell'agente. Puoi selezionare una delle seguenti regioni supportate:
us-central1us-east1europe-west4asia-southeast1
Fai clic su Crea.
Crea il contesto dell'agente
Dopo aver creato un agente, segui i passaggi descritti in Creazione di 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 di dati:
Nella Google Cloud console, vai alla pagina Spanner.
Seleziona un'istanza dall'elenco, quindi seleziona un database.
Nel menu di navigazione, fai clic su Spanner Studio.
Nel riquadro Explorer, accanto a Agenti di dati, fai clic su Visualizza azioni.
Fai clic su Modifica agente.
(Facoltativo) Modifica la Descrizione 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.
Elimina un agente di dati
Per eliminare un agente di dati:
Nella Google Cloud console, vai alla pagina Spanner.
Seleziona un'istanza dall'elenco, quindi seleziona un database.
Nel menu di navigazione, fai clic su Spanner Studio.
Nel riquadro Explorer, accanto a Agenti di dati, 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.