Vercel CLI - agentes de código - vibe coding - deploy - seguridad
4 min lectura

Vercel CLI ya busca comandos por tarea: prueba antes de dejar actuar a tu agente

Prueba vercel help search con JSON y --with-help. Resultado local con CLI 66.6.0 y una regla para revisar rollback antes de tocar producción.

Vercel CLI ya busca comandos por tarea: prueba antes de dejar actuar a tu agente

Le pides a un agente de código que investigue un error en producción. Recuerda a medias un comando de Vercel y propone ejecutar algo que no corresponde. Desde el 19 de noviembre de 2026, la CLI ofrece vercel help search: busca comandos por la tarea descrita en lenguaje natural y puede devolver resultados JSON. La decisión práctica para un fundador es sencilla: hacer que el agente consulte la ayuda antes de tocar un despliegue, y mantener la ejecución de comandos que cambian producción bajo revisión.

Qué cambió y qué no

Según el changelog oficial de Vercel, la búsqueda encuentra comandos de la CLI e incluso rutas de la API con los campos requeridos. --with-help añade la ayuda del primer resultado; --json sirve para procesar la lista sin intentar leer una salida diseñada para humanos. Vercel también incluye una skill que recomienda esta búsqueda a los agentes.

La búsqueda ayuda a encontrar la sintaxis. No decide si una operación es segura para tu proyecto. Un resultado puede ser vercel rollback o una ruta POST que cambia el destino del tráfico de producción. Para ejecutarlo hay que verificar el proyecto, la cuenta, el estado del incidente y los permisos. La documentación de rollback distingue además el límite de Hobby: solo permite volver al despliegue de producción anterior.

Prueba reproducible sin iniciar sesión

En una terminal con Node y npm, consulta la CLI actual sin instalarla dentro de tu proyecto:

npx --yes vercel@latest --version
npx --yes vercel@latest help search 'show project logs' --json
npx --yes vercel@latest help search 'roll back production' --with-help --json

Ejecuté esas consultas localmente con Vercel CLI 66.6.0. Para “show project logs”, la respuesta comenzó con logs runtime, ci logs y logs; no eligió automáticamente cuál corresponde al incidente. Para “roll back production”, el primer resultado fue rollback, con su resumen y página de ayuda, y también apareció una ruta de API POST. La consulta no inició sesión ni hizo rollback. Es una prueba de descubrimiento de comandos, no de recuperación de una app real.

Si tu agente consume JSON, esta variante muestra solo tres candidatos y sus descripciones; requiere jq:

npx --yes vercel@latest help search 'show project logs' --json \
  | jq -r '.commands[:3][] | [(.path | join(" ")), .summary] | @tsv'

La probé localmente: devolvió una línea por candidato. El resultado de búsqueda puede variar con la versión de la CLI. Si tu equipo fija una versión en CI, prueba con esa versión en lugar de @latest, y registra cuál usaste.

Instrucción útil para tu agente

Copia esta instrucción a la tarea concreta, a AGENTS.md o al archivo de reglas que use tu agente:

Antes de proponer un comando de Vercel, ejecuta
vercel help search "<tarea>" --with-help --json.
Muestra los dos primeros candidatos, la sintaxis y la fuente.
Puedes ejecutar consultas de ayuda y lectura.
Si el comando cambia despliegues, dominios, variables, datos o permisos,
detente y presenta: proyecto, entorno, efecto esperado, alternativa
y cómo verificar el resultado. Espera mi aprobación explícita.

La instrucción no sustituye las restricciones reales de la cuenta ni los controles del repositorio. Su valor es obligar al agente a mostrar qué encontró y por qué eligió una opción. Para tareas repetidas, convierte el flujo en una herramienta de solo lectura que devuelva candidatos; no expongas a un agente un token de producción con permiso de escritura solo para buscar ayuda.

Qué probar antes de confiarle una operación

  1. Da una tarea ambigua, como “revisa los logs del proyecto”, y comprueba si el agente distingue logs de runtime, solicitudes CDN y tareas de CI.
  2. Da “retrocede producción” y verifica que muestre rollback como posibilidad, pero que no lo ejecute. Revisa el despliegue objetivo y el alcance de Hobby/Pro en la documentación.
  3. Cambia a una tarea de lectura, como inspeccionar un despliegue, y comprueba que use la ayuda del subcomando antes de inventar flags.
  4. Guarda la versión de CLI y la salida relevante de la búsqueda en el registro de la incidencia. Si un comando falla, consulta la ayuda de nuevo: no reintentes ciegamente una mutación.

El límite de esta guía es deliberado: se probó la búsqueda local y su JSON; no se conectó a una cuenta Vercel, no se inspeccionaron logs privados y no se alteró producción. La utilidad inmediata es reducir comandos inventados durante un incidente y hacer visible la decisión antes de ejecutarla. Si tu app está caída, sigue el procedimiento de recuperación del equipo y usa la guía oficial de Vercel para validar la secuencia.

Recibe lo nuevo en tu correo

Workshops gratis, herramientas y novedades de IA aplicadas a negocio, sin humo.

🎓 Workshops en vivo🛠️ Herramientas nuevas⚡ Novedades de IA

Sin spam. Te das de baja cuando quieras.

Comentarios

Aún no hay comentarios. Sé el primero.

Deja un comentario