Configurare le impostazioni

Anteprima

Questo prodotto è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini di servizio specifici e ai Termini aggiuntivi per i prodotti in anteprima dell'AI generativa. I prodotti pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

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

Prima di iniziare

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

Importante :nel tuo IDE, Google Cloud Data Agent Kit e Google Cloud CLI devono essere configurati per utilizzare lo stesso account utente, progetto, regione e account di fatturazione.

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

Esamina i ruoli richiesti

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 Common (Comune) > Required Permissions (Autorizzazioni richieste).

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

4. Per ottenere le autorizzazioni mancanti necessarie per utilizzare l'estensione Data Agent Kit per VS Code, 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.

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 Azioni e poi 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 Programma di pianificazione.
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 Environment per configurare i workflow.
6. Fai clic su Salva.

Rivedere le competenze dell'agente

L'estensione Data Agent Kit per VS Code include le 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.

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:

• dbt CLI
• Dataform CLI

Notebook

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 tuoi notebook, puoi attivare l'impostazione google.datacloud.executeCellToolForNotebookMCP nelle impostazioni dell'IDE. Questa impostazione attiva lo strumento execute_cell per il protocollo di contesto del modello (MCP) del notebook.

Importante: consentire all'agente di eseguire le celle di codice nei notebook è una funzionalità potente e deve essere attivata con cautela. Devi riavviare l'IDE dopo aver modificato questa impostazione.

Risoluzione dei problemi

Se riscontri problemi, prova a uscire da Google Cloud Data Agent Kit e da gcloud CLI, quindi accedi di nuovo. Per trovare altri metodi per diagnosticare e risolvere gli errori di configurazione, consulta Risolvere i problemi dell'estensione Data Agent Kit per VS Code.

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

• Trasforma i dati utilizzando l'estensione Data Agent Kit per VS Code.