En este documento, se describe cómo configurar los parámetros iniciales después de instalar la extensión del IDE de Google Cloud Data Agent Kit.
Antes de comenzar
Antes de comenzar, completa los pasos que se indican en Cómo instalar la extensión.
Configura Google Cloud el proyecto y la región
Si no configuraste tu proyecto y región, sigue estos pasos.
- 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.
- Expande Configuración y, luego, haz clic en Configuración.
- Selecciona Común.
- Selecciona el ID del proyecto y la región. El ID del proyecto debe coincidir con el que especificaste en gcloud CLI.
- Haz clic en Guardar.
Revisa los roles obligatorios
- 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.
- Expande Configuración y, luego, haz clic en Configuración.
Navega a Common > Required Permissions.
La columna Acceso indica si eres un principal con un rol obligatorio.
Para obtener los permisos faltantes que necesitas para usar el Data Agent Kit, pídele a tu administrador que te otorgue los roles de Identity and Access Management (IAM) correspondientes 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
- 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.
- Expande Configuración y, luego, haz clic en Configuración.
- Selecciona BigQuery.
- Selecciona una región de BigQuery.
- Haz clic en Guardar.
Cómo ver los tiempos de ejecución sin servidores para Apache Spark
- 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.
- Expande Configuración y, luego, haz clic en Configuración.
- Selecciona Apache Spark. Se muestran todos los tiempos de ejecución sin servidores de tu proyecto.
- Para ver la configuración de un entorno de ejecución sin servidores, haz clic en su nombre.
Crea un entorno de ejecución de Serverless para Apache Spark
- 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.
- Expande Configuración y, luego, haz clic en Configuración.
- Selecciona Apache Spark.
- Haz clic en Crear.
- Completa los campos y haz clic en Guardar.
Borra un entorno de ejecución de Serverless para Apache Spark
- 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.
- Expande Configuración y, luego, haz clic en Configuración.
- Selecciona Apache Spark.
- En el caso del entorno de ejecución sin servidores que deseas borrar, haz clic en Actions y, luego, en Delete.
Configura el programador
- 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.
- Expande Configuración y, luego, haz clic en Configuración.
- Haz clic en Scheduler.
- 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.
- Selecciona un entorno de Managed Service para Apache Airflow para configurar flujos de trabajo.
- Haz clic en Guardar.
Revisa las habilidades del agente
Data Agent Kit incluye habilidades de agente que puedes usar en tus flujos de trabajo.
- 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.
- Expande Configuración y, luego, haz clic en Configuración.
- Haz clic en Habilidades.
- Para leer el lenguaje de 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, deberás instalar el software de forma manual.
Canalizaciones de organización
Para trabajar con Canalizaciones de organización en tu IDE, instala lo siguiente:
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) del notebook.
Solucionar problemas
Si tienes problemas, intenta salir de Google Cloud Data Agent Kit y de la gcloud CLI, y luego vuelve a acceder. Para encontrar métodos adicionales para diagnosticar y resolver errores de configuración, consulta Soluciona problemas del kit del agente de datos.
Informar un problema
Para denunciar un problema, haz lo siguiente:
- En el menú de Google Cloud Data Agent Kit de la barra de actividades, haz clic en Informar un error.
- En el formulario que se abre, documenta el problema y haz clic en Enviar.
¿Qué sigue?
- Transforma datos con el kit de Data Agent
- Mitiga los riesgos de inyección de instrucciones
- Prueba un codelab que use el Kit de Data Agent