Cómo configurar los parámetros

Vista previa

Este producto está sujeto a las "Condiciones de la oferta previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio y las Condiciones Adicionales para Productos de IA Generativa en Versión Preliminar. Los productos de la fase previa a la DG están disponibles “tal como están” y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

En este documento, se describe cómo configurar los parámetros iniciales después de instalar la extensión del kit de Google Cloud Data Agent para Visual Studio Code.

Antes de comenzar

Antes de comenzar, completa los pasos que se indican en Instala la extensión.

Importante: En tu IDE, Google Cloud Data Agent Kit y Google Cloud CLI deben configurarse para usar la misma cuenta de usuario, el mismo proyecto, la misma región y la misma cuenta de facturación.

Configura Google Cloud el proyecto y la región

Si no configuraste tu proyecto y región, sigue estos pasos.

1. Para abrir el editor de configuración de Data Cloud, haz clic en el ícono de Google Cloud Data Agent Kit en la barra de actividades.
2. Expande Configuración y, luego, haz clic en Configuración.
3. Selecciona Común.
4. Selecciona el ID y la región del proyecto. El ID del proyecto debe coincidir con el que especificaste en gcloud CLI.
5. Haz clic en Guardar.

Revisa los roles obligatorios

1. Para abrir el editor de configuración de Data Cloud, haz clic en el ícono de Google Cloud Data Agent Kit en la barra de actividades.
2. Expande Configuración y, luego, haz clic en Configuración.

3. Navega a Common > Required Permissions.

   La columna Acceso indica si eres principal en un rol requerido.

4. Para obtener los permisos faltantes que necesitas para usar la extensión Data Agent Kit para VS Code, pídele a tu administrador que te otorgue los roles correspondientes de Identity and Access Management (IAM) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Configura la región de BigQuery

1. Para abrir el editor de configuración de Data Cloud, haz clic en el ícono de Google Cloud Data Agent Kit en la barra de actividades.
2. Expande Configuración y, luego, haz clic en Configuración.
3. Selecciona BigQuery.
4. Selecciona una región de BigQuery.
5. Haz clic en Guardar.

Cómo ver los tiempos de ejecución sin servidores para Apache Spark

1. Para abrir el editor de configuración de Data Cloud, haz clic en el ícono de Google Cloud Data Agent Kit en la barra de actividades.
2. Expande Configuración y, luego, haz clic en Configuración.
3. Selecciona Apache Spark. Se muestran todos los tiempos de ejecución sin servidores de tu proyecto.
4. Para ver la configuración de un entorno de ejecución sin servidores, haz clic en su nombre.

Crea un entorno de ejecución sin servidores para Apache Spark

1. Para abrir el editor de configuración de Data Cloud, haz clic en el ícono de Google Cloud Data Agent Kit en la barra de actividades.
2. Expande Configuración y, luego, haz clic en Configuración.
3. Selecciona Apache Spark.
4. Haz clic en Crear.
5. Completa los campos y haz clic en Guardar.

Borra un entorno de ejecución de Serverless para Apache Spark

1. Para abrir el editor de configuración de Data Cloud, haz clic en el ícono de Google Cloud Data Agent Kit en la barra de actividades.
2. Expande Configuración y, luego, haz clic en Configuración.
3. Selecciona Apache Spark.
4. En el tiempo de ejecución sin servidor que deseas borrar, haz clic en Actions y, luego, en Delete.

Configura el programador

1. Para abrir el editor de configuración de Google Cloud Data Agent Kit, haz clic en el ícono de Google Cloud Data Agent Kit en la barra de actividades.
2. Expande Configuración y, luego, haz clic en Configuración.
3. Haz clic en Scheduler.
4. Selecciona un proyecto y una región. El proyecto y la región no tienen que coincidir con el proyecto y la región que seleccionaste en la pestaña Común.
5. Selecciona un entorno de Managed Service para Apache Airflow para configurar flujos de trabajo.
6. Haz clic en Guardar.

Revisa las habilidades del agente

La extensión Data Agent Kit para VS Code incluye habilidades de agente que puedes usar en tus flujos de trabajo.

1. Para abrir el editor de configuración de Data Cloud, haz clic en el ícono de Google Cloud Data Agent Kit en la barra de actividades.
2. Expande Configuración y, luego, haz clic en Configuración.
3. Haz clic en Habilidades.
4. Para leer el código Markdown que define una habilidad, haz clic en el título de la habilidad.

Instala dependencias

Algunas operaciones del kit de agentes de datos de Google Cloud requieren que instales software adicional después de instalar la extensión. En algunos casos, se te pedirá que des tu consentimiento para la instalación automática. En otros casos, debes instalar el software de forma manual.

Canalizaciones de organización

Para trabajar con los canales de Orchestration en tu IDE, instala lo siguiente:

• CLI de dbt
• CLI de Dataform

Notebooks

Cuando intentas realizar una operación que requiere lo siguiente, el IDE te solicita tu consentimiento y, luego, instala el software por ti:

• BigQuery DataFrames (versión 2.36 o posterior)
• Anywidget
• BigQuery ML

Para permitir que el agente ejecute celdas de código en tus notebooks, puedes habilitar el parámetro de configuración google.datacloud.executeCellToolForNotebookMCP en la configuración del IDE. Este parámetro de configuración habilita la herramienta execute_cell para el Protocolo de contexto del modelo (MCP) de Notebook.

Importante: Permitir que el agente ejecute celdas de código en tus notebooks es una capacidad poderosa y se debe habilitar con precaución. Debes reiniciar el IDE después de cambiar este parámetro de configuración.

Solucionar problemas

Si tienes problemas, intenta salir de Google Cloud Data Agent Kit y de la gcloud CLI, y luego vuelve a acceder. Si deseas encontrar métodos adicionales para diagnosticar y resolver errores de configuración, consulta Soluciona problemas de la extensión Data Agent Kit para VS Code.

Informar un problema

Para denunciar un problema, haz lo siguiente:

1. En el menú de Google Cloud Data Agent Kit de la barra de actividades, haz clic en Informar un error.
2. En el formulario que se abre, documenta el problema y haz clic en Enviar.

¿Qué sigue?

• Transforma los datos con la extensión Data Agent Kit para VS Code.