Configurare le impostazioni

Questo documento descrive come configurare le impostazioni iniziali dopo aver installato l'estensione IDE Google Cloud Data Agent Kit.

Prima di iniziare

Prima di iniziare, completa i passaggi descritti in Installare Data Agent Kit, inclusa la selezione dei servizi che vuoi utilizzare. Le sezioni del menu Google Cloud Data Agent Kit per i servizi che non hai selezionato mostrano integrazione non attivata finché non li selezioni.

Configura Google Cloud il progetto e la regione

Se non hai configurato il progetto e la regione, segui questi passaggi.

  1. Per aprire l'editor delle impostazioni di Data Cloud, fai clic sull'icona Google Cloud Data Agent Kit nella barra delle attività.
  2. Espandi Impostazioni e poi fai clic su Impostazioni.
  3. Seleziona Comuni.
  4. Seleziona l'ID progetto e la regione. L'ID progetto deve corrispondere a quello specificato nella gcloud CLI.
  5. Fai clic su Salva.

Rivedere i ruoli richiesti

Data Agent Kit controlla i tuoi ruoli Identity and Access Management (IAM) quando selezioni i servizi che vuoi utilizzare.

  1. Per aprire l'editor delle impostazioni di Data Cloud, fai clic sull'icona Google Cloud Data Agent Kit nella barra delle attività.
  2. Espandi Impostazioni e poi fai clic su Impostazioni.
  3. Fai clic su Service Integrations (Integrazioni di servizi).

  4. Seleziona i servizi che vuoi utilizzare e poi fai clic su Avanti.

    Se mancano ruoli o API obbligatori, si apre la pagina Autorizzazioni mancanti. Elenca le autorizzazioni IAM consigliate per ogni servizio selezionato e le API che devono essere abilitate.

  5. Per ottenere le autorizzazioni mancanti necessarie per utilizzare Data Agent Kit, fai clic su Elenco email per inviare l'elenco al tuo amministratore oppure fai clic su Copia elenco. Chiedi all'amministratore di concederti i ruoli IAM corrispondenti nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Configura la regione BigQuery

  1. Per aprire l'editor delle impostazioni di Data Cloud, fai clic sull'icona Google Cloud Data Agent Kit nella barra delle attività.
  2. Espandi Impostazioni e poi fai clic su Impostazioni.
  3. Seleziona BigQuery.
  4. Seleziona una regione BigQuery.
  5. Fai clic su Salva.

Visualizza i runtime serverless per Apache Spark

  1. Per aprire l'editor delle impostazioni di Data Cloud, fai clic sull'icona Google Cloud Data Agent Kit nella barra delle attività.
  2. Espandi Impostazioni e poi fai clic su Impostazioni.
  3. Seleziona Apache Spark. Vengono visualizzati tutti i runtime serverless per il tuo progetto.
  4. Per visualizzare una configurazione di runtime serverless, fai clic sul relativo nome.

Crea un ambiente di runtime serverless per Apache Spark

  1. Per aprire l'editor delle impostazioni di Data Cloud, fai clic sull'icona Google Cloud Data Agent Kit nella barra delle attività.
  2. Espandi Impostazioni e poi fai clic su Impostazioni.
  3. Seleziona Apache Spark.
  4. Fai clic su Crea.
  5. Compila i campi e fai clic su Salva.

Elimina un runtime serverless per Apache Spark

  1. Per aprire l'editor delle impostazioni di Data Cloud, fai clic sull'icona Google Cloud Data Agent Kit nella barra delle attività.
  2. Espandi Impostazioni e poi fai clic su Impostazioni.
  3. Seleziona Apache Spark.
  4. Per il runtime serverless che vuoi eliminare, fai clic su Elimina.

Configurare Scheduler

  1. Per aprire l'editor delle impostazioni di Google Cloud Data Agent Kit, fai clic sull'icona Google Cloud Data Agent Kit nella barra delle attività.
  2. Espandi Impostazioni e poi fai clic su Impostazioni.
  3. Fai clic su Pianificatore.
  4. Seleziona un progetto e una regione. Il progetto e la regione non devono corrispondere a quelli selezionati nella scheda Comune.
  5. Seleziona un ambiente Managed Service for Apache Airflow per configurare i workflow.
  6. Fai clic su Salva.

Installa le dipendenze

Alcune operazioni di Google Cloud Data Agent Kit richiedono l'installazione di software aggiuntivo dopo l'installazione dell'estensione. In alcuni casi, ti viene chiesto di acconsentire all'installazione automatica. In altri casi, devi installare manualmente il software.

Orchestration Pipelines

Per lavorare con le Orchestration Pipelines nel tuo IDE, installa quanto segue:

Notebook

Notebooks generati da Google Cloud Data Agent Kit includono una cella %pip install --upgrade bigframes commentata. Se BigQuery DataFrames non è installato nel kernel, rimuovi il commento e esegui la cella prima di eseguire il resto del notebook.

Per consentire all'agente di eseguire le celle di codice nei tuoi notebook, puoi attivare l'impostazione google.datacloud.executeCellToolForNotebookMCP nelle impostazioni dell'IDE. Questa impostazione attiva lo strumento execute_cell per il Model Context Protocol (MCP) del notebook.

Risoluzione dei problemi

Se riscontri problemi, prova a uscire da Google Cloud Data Agent Kit e da gcloud CLI e poi ad accedere di nuovo. Per trovare altri metodi per diagnosticare e risolvere gli errori di configurazione, consulta Risoluzione dei problemi relativi a Data Agent Kit.

Segnala un problema

Per segnalare un problema:

  1. Nel menu Google Cloud Data Agent Kit nella barra delle attività, fai clic su Segnala bug.
  2. Nel modulo che si apre, documenta il problema e fai clic su Invia.

Passaggi successivi