Configurare le impostazioni

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

Prima di iniziare

Prima di iniziare, completa i passaggi descritti in Installare l'estensione.

Configurare il Google Cloud 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 Comune.
  4. Seleziona l'ID progetto e la regione. L'ID progetto deve corrispondere all'ID progetto specificato in gcloud CLI.
  5. Fai clic su Salva.

Esaminare i ruoli obbligatori

  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. Vai a Comune > Autorizzazioni richieste.

    La colonna Accesso indica se sei un'entità in un ruolo obbligatorio.

  4. Per ottenere le autorizzazioni mancanti necessarie per utilizzare Data Agent Kit, chiedi all'amministratore di concederti i ruoli IAM (Identity and Access Management) corrispondenti nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle, e organizzazioni.

Configurare 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.

Visualizzare 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 la configurazione di un runtime serverless, fai clic sul relativo nome.

Creare 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. Fai clic su Crea.
  5. Compila i campi e fai clic su Salva.

Eliminare 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 Azioni e poi su Elimina.

Configurare lo 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 Scheduler.
  4. Seleziona un progetto e una regione. Il progetto e la regione non devono necessariamente corrispondere a quelli selezionati nella scheda Comune.
  5. Seleziona un ambiente Managed Service per Apache Airflow per configurare i workflow.
  6. Fai clic su Salva.

Esaminare le skill dell'agente

Data Agent Kit include skill dell'agente che puoi utilizzare nei tuoi workflow.

  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 Skill.
  4. Per leggere il Markdown che definisce una skill, fai clic sul titolo della skill.

Installare 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 utilizzare Orchestration Pipelines nell'IDE, installa quanto segue:

Notebooks

Quando tenti un'operazione che richiede quanto segue, l'IDE ti chiede il consenso e poi installa il software per te:

  • BigQuery DataFrames (versione 2.36 o successive)
  • Anywidget
  • BigQuery ML

Per consentire all'agente di eseguire le celle di codice nei 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 Risolvere i problemi relativi a Data Agent Kit.

Segnalare 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