Google Agents CLI: kit oficial para crear y desplegar agentes IA

Google liberó recientemente el Agents CLI, una herramienta que apunta a hacer más rápida e intuitiva la construcción, prueba y despliegue de agentes de inteligencia artificial. El CLI ofrece un camino oficial para llevar un agente desde la idea hasta producción sin escribir tanto glue code.

Qué es el Google Agents CLI

Habitualmente, construir un agente de IA requiere escribir mucho glue code, esos scripts de pegamento que conectan un modelo de lenguaje con herramientas externas o bases de datos.

YouTube

Agents CLI elimina esa fricción. Es la herramienta oficial de Google para crear, evaluar y desplegar agentes construidos con el Agent Development Kit (ADK). Funciona como columna programática del Agent Development Lifecycle (ADLC) sobre Google Cloud.

Habilidades empaquetadas para agentes

Agents CLI incluye siete skills (habilidades) que enseñan a los asistentes de código cómo ejecutar cada paso del ADLC:

El asistente de código puede invocar estas habilidades directamente una vez instaladas. También un desarrollador humano puede correr los mismos comandos manualmente.

Cómo instalar Google Agents CLI

Para empezar se requiere un entorno limpio. El CLI depende de algunas herramientas modernas de web y datos.

Prerrequisitos

• Python y PIP: la base de la mayoría del desarrollo en IA.

sudo apt install python3 python3-pip

• Node.js y NPM: requeridos para la interfaz del CLI y las funciones de despliegue.

sudo apt install nodejs npm

• UV: un instalador de paquetes Python ultrarrápido que el CLI usa internamente.

pip install uv

Pasos de instalación

Es buena práctica mantener los proyectos aislados para que no interfieran entre sí. Crea un entorno virtual:

python -m venv agent-env
source agent-env/bin/activate
# En Windows: agent-env\Scripts\activate

El CLI se distribuye a través de uv:

uvx google-agents-cli setup

El CLI soporta macOS y Linux. Windows nativo no está soportado actualmente (se recomienda WSL 2).

Autenticación

Agents CLI toma tus credenciales automáticamente si ya estás autenticado con el CLI de gcloud. Si corres localmente sin gcloud, puedes definir una Gemini API key:

export GEMINI_API_KEY="tu-key"

Para escenarios más detallados de autenticación (service accounts, roles A2A, etc.) la documentación oficial del Authentication guide cubre el tema. El punto clave es que el asistente de código hereda las credenciales del shell: no necesitas embeber secretos en el código.

Construir un primer agente "Weather"

La forma más rápida de aprender es haciendo. El CLI viene con un sistema de plantillas (boilerplate) para arrancar en segundos.

agent-cli create my-first-agent
cd my-first-agent

Instalar dependencias

Dentro de la carpeta del proyecto, instala las librerías específicas:

agent-cli install

El Playground

Una de las mejores funciones del CLI es el Playground. En vez de probar el agente en una terminal en blanco y negro, se puede levantar una interfaz web local.

agent-cli playground

Tras ejecutarlo, aparece una URL local (habitualmente http://127.0.0.1:8000). Se abre en el navegador, se selecciona el agente del menú y comienza el chat. Por defecto, el agente está configurado para responder consultas sobre el clima.

Cuando el agente esté listo para evaluarse:

agents-cli eval run

Despliegue de agentes

Al ejecutar agent-cli deploy, hay dos opciones principales:

• Cloud Run: trata al agente como una aplicación web estándar. Funciona bien si quieres control total sobre el servidor.
• Agent Runtime: un entorno especializado, construido específicamente para IA. Maneja automáticamente memoria (recordar lo que el usuario dijo antes) y orquestación (coordinar varios agentes trabajando en conjunto).

El proceso de despliegue

• Asegúrate de tener un Google Cloud Project configurado.
• Habilita el billing en la Cloud Console.
• Ejecuta:

# Despliega al destino configurado (Agent Runtime, Cloud Run o GKE)
agents-cli deploy

Si quieres registrar tu agente con Gemini Enterprise:

# Registra el agente desplegado en Gemini Enterprise
agents-cli publish gemini-enterprise

Esto permite usar el agente directamente desde https://gemini.google.com/.

Casi todos los comandos aceptan flags como --project, --region, --datastore, --cicd-runner y --deployment-target para personalizar el entorno. La referencia del CLI tiene el detalle completo.

Comandos clave de Agents CLI

• agent-cli setup: instala el entorno base.
• agent-cli create [name]: arranca un nuevo proyecto de agente.
• agent-cli playground: levanta la interfaz web de pruebas.
• agent-cli eval run: verifica si el agente está rindiendo correctamente.
• agent-cli deploy: empuja el agente a Google Cloud.

Construir un agente con tu asistente de código

Tras la instalación, abre tu asistente de código (Codex, Claude Code, Gemini CLI o Copilot) y verifica que las habilidades del Agents CLI estén visibles:

/skills

Deberías ver google-agents-cli-workflow y las demás habilidades empaquetadas. Desde ahí, puedes instruir al agente con lenguaje natural. Por ejemplo:

Construye un agente de soporte que responda consultas a partir de nuestros docs

Gemini CLI (o Claude Code, Codex, etc.) invocará las habilidades del CLI para armar la estructura del proyecto, instalar dependencias, evaluar el rendimiento y preparar el despliegue. Este patrón funciona con cualquier plataforma de agentes que soporte instalación de habilidades.

Si el resultado es satisfactorio, basta con llamar al comando deploy y el agente queda en producción:

# Despliega al destino configurado (Agent Runtime, Cloud Run o GKE)
agents-cli deploy

Conclusión

Los nuevos CLI orientados a agentes de Google muestran cómo la línea de comandos se está convirtiendo en una interfaz universal tanto para operadores humanos como para agentes de IA. Agents CLI ofrece un camino integral, oficialmente soportado, para llevar ideas a agentes listos para producción sobre Google Cloud.