Apidog CLI ha sido durante mucho tiempo el punto de entrada de línea de comandos para ejecutar pruebas de API desde un terminal, pipeline de CI, flujo de trabajo de automatización o sistema externo.
apidog run --project <projectId> --test-scenario <scenarioId> --environment <environmentId>Esa base sigue siendo importante. Los equipos aún necesitan una forma fiable de ejecutar pruebas de API, generar informes y mantener puertas de calidad dentro de la CI. Pero el desarrollo de API está cambiando. Los Agentes de IA ahora participan en el diseño de API, la generación de pruebas, la depuración, la migración y el mantenimiento.
Para esos flujos de trabajo, una CLI no puede ser solo el último paso que ejecuta las pruebas existentes. También debe proporcionar a los Agentes una forma estable de leer activos de API, crear o actualizar activos de prueba, validar cambios estructurados, volver a escribirlos y verificar el resultado.
La Apidog CLI actualizada mantiene la base original de ejecución de pruebas y la expande a una capa de flujo de trabajo para desarrolladores, scripts y Agentes de IA. Este artículo explica por qué la CLI es más importante en la era de los Agentes de IA, qué cambió en Apidog CLI y cómo los equipos pueden empezar a usarla para la automatización de pruebas de API.
Por qué la CLI es más importante en la era de los Agentes de IA
Las interfaces gráficas están diseñadas para personas. Son visuales, flexibles y útiles para la exploración. Los Agentes de IA, sin embargo, funcionan mejor con comandos estructurados, entradas predecibles, salidas predecibles y pasos de validación claros.
Ahí es donde la CLI se vuelve importante. Una CLI proporciona a los Agentes y scripts una interfaz repetible a los mismos recursos que los desarrolladores gestionan en Apidog: APIs, entornos, variables, casos de prueba, escenarios de prueba, suites de prueba, informes, datos de importación/exportación y más.
En la práctica, esto significa que Apidog puede servir tanto a usuarios humanos como a flujos de trabajo automatizados. Las personas continúan diseñando, depurando, revisando y colaborando en la interfaz del producto. Los Agentes y la automatización pueden usar la CLI para realizar operaciones controladas sobre esos mismos activos.
De apidog run a flujos de trabajo completos de API y pruebas
La experiencia CLI anterior se centraba principalmente en la ejecución de pruebas. Esto hizo que apidog run fuera útil como puerta de calidad de CI, pero también significó que la CLI solía aparecer cerca del final del flujo de trabajo. La CLI actualizada amplía la cobertura a más recursos centrales de Apidog, por lo que la automatización puede participar antes: leyendo el contexto del proyecto, preparando activos de prueba, validando cambios estructurados y luego ejecutando la verificación.
Con la CLI actualizada, los usuarios y los Agentes pueden trabajar con recursos como:
- Proyectos y metadatos de proyecto
- APIs y definiciones de API
- Entornos y variables
- Casos de prueba
- Escenarios de prueba
- Suites de prueba
- Informes
- Flujos de trabajo de importación y exportación
- Cuentas, ramas, ejecutores y recursos relacionados del proyecto
Esto cambia el rol de Apidog CLI. No es simplemente una forma de ejecutar pruebas después de que todo lo demás esté hecho. Ahora puede participar antes en el ciclo de desarrollo, donde un Agente necesita comprender el proyecto, generar o actualizar activos de prueba, validar cambios y luego ejecutar la verificación.
Un ciclo más seguro para las pruebas impulsadas por Agentes
Cuando un Agente de IA ayuda con el desarrollo o las pruebas de API, la parte arriesgada no es solo generar contenido. La parte arriesgada es escribir contenido generado en un proyecto real sin suficiente estructura o verificación.
La CLI actualizada hace posible un ciclo más seguro:
Este ciclo es importante porque muchos recursos de Apidog están estructurados. Los casos de prueba y los escenarios de prueba pueden incluir datos de solicitud, aserciones, extracción de variables, pre-procesadores, post-procesadores, orden de los pasos, referencias a entornos y otros detalles. Si un Agente adivina la estructura, pequeños errores pueden causar escrituras fallidas, una visualización incompleta en la UI o pruebas que no se comportan como se esperaba.
Es por eso que cli-schema es una parte importante de la actualización. Antes de escribir un archivo JSON complejo en Apidog, un Agente puede pedir a la CLI que valide si los campos y la estructura coinciden con el esquema esperado.
apidog cli-schema validate test-case-create --file ./test-case-create.json
apidog cli-schema validate test-scenario-update --file ./scenario-update.jsonEn resumen: deja que el Agente genere, pero deja que la CLI valide antes de que ocurra la escritura.
La CLI también puede proporcionar sugerencias orientadas al Agente en la salida de comandos. Después de que se crea o actualiza un recurso, el siguiente paso a menudo no es “detenerse”. Un Agente más fiable debería leer el recurso guardado, confirmar la estructura y ejecutar pruebas cuando sea apropiado. Estas sugerencias ayudan a los Agentes a avanzar en el flujo de trabajo con menos puntos ciegos.
Las Habilidades dan a los Agentes juicio operativo
Los comandos de la CLI dan a un Agente poder de ejecución. Las Habilidades dan a un Agente juicio operativo.
Una HABILIDAD no es solo una referencia de comando. Se acerca más a una guía operativa escrita para Agentes de IA: cuándo usar un comando, qué comando debe ir primero, qué campos no deben adivinarse, cuándo validar, cuándo volver a leer y cuándo ejecutar pruebas.
Por ejemplo, un Agente fiable no siempre debería escribir un escenario de prueba grande desde cero. Un patrón más seguro suele ser:
- Crear el escenario básico.
- Importar pasos de APIs o casos de prueba existentes.
- Leer la estructura completa del escenario.
- Actualizar aserciones, extracción de variables o procesadores en pasos más pequeños.
- Validar y ejecutar el escenario.
Las Habilidades hacen explícitos estos patrones. Ayudan a los Agentes a evitar errores comunes como usar el nombre de campo incorrecto, elegir el valor enumerado equivocado, omitir la validación del esquema o asumir que una escritura exitosa significa que el recurso final ya es correcto.
Apidog proporciona 8 Habilidades complementarias para ayudar a los Agentes a comprender los comandos de la CLI, las estructuras de recursos y los flujos de trabajo de tareas. Juntos, la CLI y las Habilidades hacen que Apidog sea más práctico para el desarrollo y las pruebas de API asistidos por IA.
Cambios de proyecto más seguros con Ramas de IA
Cuando un Agente modifica los recursos del proyecto, la seguridad y la capacidad de revisión son importantes. Por esa razón, la CLI actualizada también se puede usar junto con las **Ramas de IA**.
El Agente puede realizar cambios primero en una rama aislada. El equipo puede revisar las diferencias, confirmar el resultado y luego fusionar en la rama de destino. Esto ayuda a evitar que los cambios automatizados afecten directamente la rama principal o una rama de colaboración compartida.
Lo que esto desbloquea en flujos de trabajo reales
El valor de la CLI actualizada se ve más fácilmente en flujos de trabajo concretos.
Generar pruebas a partir de definiciones de API
Un Agente puede leer definiciones de API de un proyecto, generar casos de prueba, validar el JSON generado con cli-schema, escribir los casos de prueba en Apidog, leerlos de nuevo y ejecutar la verificación. Esto convierte la generación de pruebas de una sugerencia puntual en un flujo de trabajo controlado.
Mantener escenarios de prueba complejos
Para escenarios de múltiples pasos, el Agente puede importar pasos de APIs o casos de prueba existentes primero, luego actualizar aserciones, variables o procesadores después de leer la estructura completa. Esto reduce el riesgo de construir un escenario grande incorrectamente en una sola pasada.
apidog test-scenario import-steps <scenarioId> --project <projectId> --source endpoint --ids <endpointIds> --sync manual
apidog test-scenario get <scenarioId> --project <projectId> --with-case-detailMover y reproducir activos de proyecto
La CLI actualizada también mejora los flujos de trabajo de importación y exportación para los datos nativos de Apidog. Esto es útil para la migración de proyectos, la reproducción de entornos de clientes, la copia de configuraciones de prueba o el movimiento de APIs, esquemas, casos de prueba y escenarios entre proyectos.
apidog export --project <projectId> --format apidog --output ./project.apidog.json
apidog import --project <projectId> --format apidog --file ./project.apidog.jsonMantener puertas de calidad de CI
Las nuevas capacidades preparadas para Agentes no reemplazan a la CI. La complementan. Los equipos aún pueden usar apidog run como el punto de entrada principal para la ejecución de pruebas automatizadas y los informes.
apidog run --project <projectId> --test-scenario <scenarioId> --environment <environmentId> -r "cli,html,junit" --out-dir ./apidog-reportsPrimeros pasos
Si ya tienes Apidog CLI instalado, verifica tu versión actual primero:
apidog -vSi tu **versión de Apidog CLI** es anterior a la 2.2.5, actualiza la CLI antes de usar las nuevas capacidades. Este número de versión se refiere a Apidog CLI, no a la aplicación Apidog.
Puedes pedir al Agente de IA que estés usando que instale tanto Apidog CLI como las Habilidades complementarias copiando este mensaje:
Read the instructions and help me install Apidog CLI:
https://apidog.com/apidog-cli-installation-guide.mdSi prefieres instalarlo o actualizarlo manualmente, ejecuta:
npm install -g apidog-cli@latestPara la referencia completa de comandos, consulta Opciones de Apidog CLI.
Prueba tu primera tarea de Agente
Después de instalar la CLI y las Habilidades, la forma más fácil de comenzar es dar a tu Agente una tarea de API pequeña y de bajo riesgo. Por ejemplo, pídele que cree un endpoint de verificación de estado simple GET /health en un proyecto de Apidog, luego léelo de nuevo para confirmar el resultado.
Copia este mensaje en tu Agente de IA:
Use Apidog CLI to help me create my first API endpoint in Apidog. First, check my Apidog CLI setup and list the projects I can access. Ask me which project to use. After I confirm, create a simple GET /health endpoint named Health Check with a 200 response example. Validate any structured input before writing, then read the endpoint back and summarize what was created.Esto proporciona a los nuevos usuarios un punto de partida concreto: el Agente verifica la configuración, pregunta antes de escribir en un proyecto, crea una pequeña definición de API y confirma el resultado guardado.
Próximos pasos:
- Descarga Apidog para diseñar, depurar, probar y documentar APIs en un solo espacio de trabajo.
- Obtén más información sobre Apidog CLI para pruebas de API de línea de comandos, automatización de CI y flujos de trabajo de Agentes de IA.
Preguntas Frecuentes
¿Qué es Apidog CLI?
Apidog CLI es una herramienta de línea de comandos para ejecutar pruebas de API, trabajar con recursos de proyectos de Apidog y conectar activos de API y pruebas de Apidog a flujos de trabajo de automatización.
¿Puede Apidog CLI ejecutar pruebas de API en CI?
Sí. Los equipos pueden usar apidog run en pipelines de CI para ejecutar pruebas de API, generar informes y mantener puertas de calidad automatizadas en sus flujos de trabajo de prueba.
¿Cómo ayuda Apidog CLI a los Agentes de IA?
Apidog CLI proporciona a los Agentes de IA una forma estructurada de leer información de API, generar o actualizar activos de prueba, validar cambios, escribirlos en Apidog, leer el resultado y ejecutar pruebas para su verificación.
¿Qué es cli-schema en Apidog CLI?
cli-schema ayuda a validar archivos JSON complejos antes de que se escriban en Apidog. Esto reduce las escrituras fallidas, los campos inválidos y los bucles de reintento innecesarios cuando los Agentes crean o actualizan casos de prueba y escenarios de prueba.
¿Cómo instalo Apidog CLI?
Puedes pedir a un Agente de IA que siga la guía de instalación de Apidog CLI e instale tanto la CLI como las Habilidades complementarias, o instalarla manualmente con npm install -g apidog-cli@latest.