Configurare le impostazioni

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

Prima di iniziare

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

Configurare il progetto e la regione Google Cloud

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 nella 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 l'estensione Data Agent Kit per Antigravity, chiedi all'amministratore di concederti i ruoli IAM (Identity and Access Management) corrispondenti nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire 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 for Apache Airflow Environment per configurare i workflow.
  6. Fai clic su Salva.

Esaminare le competenze dell'agente

L'estensione Data Agent Kit per Antigravity include competenze 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 Competenze.
  4. Per leggere il Markdown che definisce una competenza, fai clic sul titolo della competenza.

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 protocollo MCP (Model Context Protocol) del notebook.

Risoluzione dei problemi

Se riscontri problemi, prova a uscire da Google Cloud Data Agent Kit e dalla 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 all'estensione Data Agent Kit per Antigravity.

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