El Google Cloud Data Agent Kit te permite trabajar con tus recursos de datos Google Cloud en tu IDE o entorno de programación con agentes preferido. Según tu configuración, instalarás una extensión del IDE o un complemento.
El Data Agent Kit viene preinstalado con los siguientes servicios: Google Cloud
- Cloud Shell
- Cloud Workstations
Antes de comenzar
Antes de instalar Data Agent Kit, haz lo siguiente.
Cómo configurar tu entorno local
En tu máquina local, instala tu IDE o agente de programación preferido y Node.js.
- Instala y configura tu IDE, CLI agentic o agente de programación. Si ya está instalada, actualízala a la versión más reciente.
- Instala Node.js.
Configura Google Cloud
- Si aún no tienes uno, crea un proyecto Google Cloud .
- Habilita la facturación.
Roles obligatorios
El Kit de Data Agent te notifica cuando necesitas permisos adicionales para completar una tarea. Solo necesitas permisos para los servicios que usas. Para obtener una lista completa de los permisos y las APIs que se requieren para cada servicio en Data Agent Kit, consulta Permisos.
Instala la extensión o el complemento
El proceso de instalación depende del IDE o del agente de programación que uses.
VS Code
Para usar Data Agent Kit en VS Code, instala la extensión:
- En el IDE, haz clic en Extensiones o presiona
Ctrl/Cmd+Shift+X. - Busca
Google Cloud Data Agent Kit. - Haz clic en Instalar.
- Si se te solicita, reinicia el IDE. Después de que la extensión se instale correctamente, se agregará el ícono de Google Cloud Data Agent Kit a la barra de actividades.
También puedes instalar la extensión desde Visual Studio Marketplace.
Antigravity
Haz clic para expandir las instrucciones de la herramienta Antigravedad que estás usando.
IDE de Antigravity
Para usar Data Agent Kit en el IDE de Antigravity, instala la extensión.
- En el IDE, haz clic en Extensiones o presiona
Ctrl/Cmd+Shift+X. - Busca
Google Cloud Data Agent Kit. - Haz clic en Instalar.
- Si se te solicita, reinicia el IDE. Después de que la extensión se instale correctamente, se agregará el ícono de Google Cloud Data Agent Kit a la barra de actividades.
CLI de Antigravity
Para usar Data Agent Kit con la CLI de Antigravity, instala el complemento. En tu terminal, ejecuta el siguiente comando:
agy plugin install https://github.com/GoogleCloudPlatform/data-agent-kit-plugin
Antigravity 2.0
Para usar Data Agent Kit con la CLI de Antigravity, instala el complemento.
- Haz clic en Configuración.
- En el panel Configuración, haz clic en Personalizaciones.
- Busca Build with Google Plugins y haz clic en Personalizar.
- Busca Google Cloud Data Agent Kit en la lista y haz clic en Descargar.
Extensión de Antigravity para VS Code
Para usar Data Agent Kit en VS Code cuando usas la extensión Antigravity para VS Code, haz lo siguiente:
- En la barra de estado de VS Code, haz clic en Antigravity - Settings.
- En el panel Configuración, haz clic en Personalizaciones.
- Busca Build with Google Plugins y haz clic en Personalizar.
- Busca Google Cloud Data Agent Kit en la lista y haz clic en Descargar.
CLI de Claude Code
Para usar Data Agent Kit con la CLI de Claude Code, instala el complemento. Ejecuta el siguiente comando en tu terminal:
claude plugin marketplace add https://github.com/GoogleCloudPlatform/data-agent-kit-plugin
claude plugin install dak@dak-marketplace
CLI de Codex
Para usar Data Agent Kit con la CLI de Codex, instala el complemento. Ejecuta los siguientes comandos en tu terminal:
codex plugin marketplace add GoogleCloudPlatform/data-agent-kit-plugin
codex plugin add dak@dak-marketplace
Cursor
Para usar Data Agent Kit en Cursor, instala la extensión.
- En el IDE, haz clic en Extensiones o presiona
Ctrl/Cmd+Shift+X. - Busca
Google Cloud Data Agent Kit. - Haz clic en Instalar.
- Si se te solicita, reinicia el IDE. Después de que la extensión se instale correctamente, se agregará el ícono de Google Cloud Data Agent Kit a la barra de actividades.
IDE basados en VS Code
Para usar Data Agent Kit con todos los demás IDE basados en VS Code, instala la extensión.
- En el IDE, haz clic en Extensiones o presiona
Ctrl/Cmd+Shift+X. - Busca
Google Cloud Data Agent Kit. - Haz clic en Instalar.
- Si se te solicita, reinicia el IDE. Después de que la extensión se instale correctamente, se agregará el ícono de Google Cloud Data Agent Kit a la barra de actividades.
Accede a Data Agent Kit
Después de instalar la extensión o el complemento, debes acceder a tu cuenta.
Acceso a la extensión
Si instalaste la extensión del IDE, debes autenticarte en Google Cloud Data Agent Kit.
Si el diálogo de acceso no se abre automáticamente, busca un vínculo de acceso al kit de Google Cloud Data Agent en la barra de estado cerca de la parte inferior de la ventana del IDE y haz clic en él.
Como alternativa, puedes presionar
Ctrl/Cmd+Shift+Ppara abrir la paleta de comandos, buscar y seleccionar Google Cloud Data Agent Kit: Sign in.Sigue las instrucciones y completa el acceso.
Se mostrará una página web que confirma que se completó la autenticación.
Cierra la página y regresa al IDE.
Acceso al complemento
Instala Google Cloud CLI y accede a ella. El complemento Data Agent Kit usa credenciales de gcloud CLI y credenciales predeterminadas de la aplicación (ADC).
- Abre la terminal en tu máquina local o en tu IDE.
- Si no instalaste gcloud CLI anteriormente, sigue los pasos que se indican en Instala la CLI de gcloud para descargar e instalar gcloud CLI.
- En la terminal, ejecuta
gcloud initpara inicializar gcloud CLI:gcloud init
- Ejecuta el siguiente comando y sigue las instrucciones para autenticarte y configurar las credenciales predeterminadas de la aplicación:
gcloud auth login && gcloud auth application-default login
- Actualiza gcloud CLI a la versión más reciente:
gcloud components update
Solucionar problemas
Si tienes problemas, intenta salir y volver a acceder. Si deseas encontrar métodos adicionales para diagnosticar y resolver errores de instalación, consulta Solución de problemas.