El modo agente de GitHub Copilot es un bucle: edita archivos, ejecuta comandos de terminal, lee la salida y decide qué hacer a continuación. Entonces, ¿por qué sus pruebas de API no están en ese bucle? Se encuentran en Apidog detrás de una GUI, se ejecutan cuando alguien se acuerda de hacer clic. Copilot nunca los toca.
La solución es un archivo de configuración. La CLI de Apidog es un paquete npm, apidog-cli, que ejecuta los escenarios de prueba que usted construyó en Apidog directamente desde una terminal. Una vez que la CLI está instalada y Copilot sabe que existe, el modo agente ejecuta un escenario de Apidog de la misma manera que ejecuta sus pruebas unitarias: dispara el comando, lee el código de salida, corrige el código si está en rojo.
Si aún no ha instalado la CLI, hágalo primero. Cómo instalar la CLI de Apidog con un agente de codificación de IA explica la instalación con npm, el inicio de sesión y la primera ejecución, con un agente realizando la escritura. Este artículo asume que apidog --version imprime un número y su cuenta de Apidog está autenticada.
De qué Copilot se trata
Copilot son varios productos, y el nombre se superpone de manera confusa. Este artículo trata sobre las superficies que pueden ejecutar comandos de shell.
La principal es el modo agente en VS Code. Abre la vista de Chat de Copilot, cambia el desplegable de modo a Agente, y puede editar varios archivos, ejecutar comandos de terminal e iterar hasta que la tarea esté hecha. Cuando quiere ejecutar un comando, le muestra el comando y le pide confirmación antes de ejecutarlo. Ese paso de confirmación es exactamente donde encaja apidog run.
Dos superficies relacionadas merecen ser nombradas para que sepa en cuál se encuentra. El agente de codificación de Copilot se ejecuta asincrónicamente en GitHub Actions después de asignarle una incidencia; produce una solicitud de extracción en lugar de trabajar en su editor. La CLI de Copilot es un cliente de terminal separado. Ambos pueden ejecutar comandos, pero este artículo se centra en el modo agente en VS Code, porque ahí es donde usted se sienta mientras codifica y donde el bucle de editar-probar-corregir es más estricto. La configuración que se describe a continuación también funciona para el agente de codificación, que lee el mismo archivo de instrucciones. Para una visión más amplia de lo que cambió cuando Copilot se volvió agentivo, consulte El nuevo agente de codificación de GitHub Copilot.
La distinción importa porque Copilot tiene su propia forma de aprender las reglas del proyecto, y ese mecanismo convierte un "ejecutar mis pruebas" puntual en algo que Copilot utiliza por sí solo. Ese mecanismo es un archivo de instrucciones personalizado.
Paso 1: Añadir las reglas de Apidog al archivo de instrucciones de Copilot
Copilot lee las instrucciones personalizadas del repositorio desde un único archivo: .github/copilot-instructions.md en la raíz de su repositorio. El modo agente, Copilot Chat, la revisión de código y el agente de codificación lo cargan automáticamente, según la documentación de GitHub sobre instrucciones personalizadas del repositorio. Piense en ello como CLAUDE.md para Claude Code o AGENTS.md para Codex: un archivo de Markdown simple con instrucciones del proyecto que Copilot carga en el contexto antes de empezar a trabajar.
Cree el archivo y añada un breve bloque de Apidog:
## Pruebas de API con la CLI de Apidog
Cuando cambie un endpoint de API, verifíquelo con la CLI de Apidog antes
de declarar que la tarea está hecha. Ejecute:
apidog run -t 812345 -e 671234 -r cli
- `apidog run` sale con 0 cuando todas las aserciones pasan, con un valor no cero en caso de cualquier fallo.
Trate una salida no cero como una prueba fallida, incluso si el texto del resumen parece correcto.
- La máquina ya está autenticada a través de `apidog login`. NO añada una
bandera `--access-token` y nunca ponga un token en este archivo.
- Si encuentra un error de "opción desconocida", ejecute `apidog run --help` y use las
banderas reales. No adivine.
Reemplace los valores de -t y -e con sus IDs de escenario y entorno reales del siguiente paso.
Escríbalo en el archivo de instrucciones en lugar de mencionarlo en el chat porque un ID de escenario escrito en el chat desaparece cuando termina la sesión. Uno en .github/copilot-instructions.md está ahí para cada compañero de equipo, cada sesión en modo agente y cada solicitud de extracción que el agente de codificación abra de ahora en adelante. Si desea que la regla se aplique solo a ciertos archivos, GitHub también admite instrucciones específicas de ruta en .github/instructions/NAME.instructions.md, pero un único archivo a nivel de repositorio es suficiente aquí.
Paso 2: Obtener el comando de Apidog
No tiene que escribir el comando apidog run a mano. Apidog lo genera por usted.
Abra el escenario de prueba en Apidog, vaya a su pestaña CI/CD y copie el comando. Se genera completamente con el ID de escenario (-t), el ID de entorno (-e) y una bandera de reportero correctos:
apidog run -t 812345 -e 671234 -r cli
Pegue esos IDs exactos en el bloque de su archivo .github/copilot-instructions.md. Estos IDs son la fuente de la verdad; cuando Copilot y su archivo de instrucciones no concuerdan, la pestaña CI/CD prevalece. Para el conjunto completo de banderas y reporteros, consulte la referencia del comando apidog run.
Paso 3: Hacer que el modo agente ejecute la prueba
Abra la vista de Chat de Copilot en VS Code y cambie el menú desplegable de modo a Agente. Debido a que el modo agente carga .github/copilot-instructions.md al iniciarse, ya sabe que la CLI está ahí. Realice un cambio que afecte su API o pregúntele directamente:
Ejecuta el escenario de prueba de API de Apidog y dime el resultado.
Copilot emite el comando apidog run de su archivo de instrucciones. El modo agente no ejecuta comandos de terminal en silencio; le muestra el comando y le pide que confirme antes de ejecutarlo, para que vea exactamente lo que está a punto de ejecutarse. Apruebe. El reportero -r cli luego imprime un resultado paso a paso y un resumen directamente en la terminal integrada, donde observa cada solicitud y aserción a medida que ocurre.
Usted quiere ver dos cosas: la ejecución en curso y Copilot informando tanto el resumen como el código de salida. Si aprueba el comando una vez, VS Code puede recordar su elección para ese comando en el espacio de trabajo, de modo que las llamadas posteriores de apidog run se ejecuten sin volver a preguntar. Un escenario de prueba de solo lectura contra staging es exactamente el tipo de comando seguro y dentro del espacio de trabajo que está bien permitir.
Paso 4: Leer el informe dentro de Copilot
Cuando una ejecución se pone en rojo, el informe tiene la respuesta. Con -r cli, Copilot obtiene un desglose legible en la terminal: cada solicitud, cada aserción y cuál falló con el valor esperado frente al real. La aserción fallida nombra el campo o código de estado exacto, lo que suele ser suficiente para que Copilot encuentre la solución en su siguiente iteración.
Para un informe que pueda abrir en un navegador o entregar a un compañero de equipo, agregue el reportero HTML:
apidog run -t 812345 -e 671234 -r cli,html
El reportero html escribe un archivo autocontenido en ./apidog-reports. Mantenga cli en la lista para que Copilot siga obteniendo la salida en línea que lee para decidir su siguiente paso. Para todos los formatos de reportero, incluida la salida de JUnit que analizan los paneles de CI, consulte la guía completa de la CLI de Apidog y cómo leer los informes de prueba de la CLI de Apidog.
Pruebas de Copilot dentro de su propio bucle
El punto es lo que sucede cuando dejas de preguntar y Copilot ejecuta el escenario por su cuenta porque el archivo de instrucciones se lo indicó.
Imagínese el modo agente editando un controlador que construye una respuesta de pago. Su bucle cambia. Edita el código, luego, en lugar de declarar la victoria, ejecuta su escenario de Apidog contra el entorno de prueba (staging), lee el código de salida y actúa en consecuencia. Si está en verde, continúa. Si está en rojo, abre el informe, lee qué aserción falló (el código de estado, el campo faltante, el valor incorrecto), intenta una corrección y vuelve a ejecutar. La prueba de API se convierte en parte del mismo bucle de editar-probar-corregir que Copilot ya usa para sus pruebas unitarias. Usted escribió una instrucción y Copilot incorporó el comando a cómo ya funciona.
Este es el modelo de delegar-luego-verificar que hace que cualquier flujo de trabajo de agente sea seguro. Copilot ejecuta el comando y lee el resultado; usted sigue creando escenarios visualmente en Apidog y verifica que el agente lea los códigos de salida honestamente. Para el patrón más amplio, consulte cómo usar agentes de IA para pruebas de API y el arnés de pruebas de IA de Apidog.
Verifique que Copilot realmente está ejecutando la CLI
Los agentes reportan éxitos que no merecen, y Copilot no es una excepción. Tres comprobaciones, en orden de frecuencia con la que detectan problemas.
Primero, confirme que el comando se ejecutó. El modo agente muestra los comandos que ejecutó y su salida en línea en la terminal. Busque la línea literal apidog run ... y un resultado debajo. Si Copilot dice que ejecutó las pruebas pero usted no ve el comando, resumió algo que nunca hizo. Pídale que vuelva a ejecutar y muestre la salida sin procesar.
Segundo, confirme el código de salida, el que importa:
¿Cuál fue el código de salida de ese comando apidog run?
apidog run sale con 0 cuando todas las aserciones pasan y con un valor distinto de cero cuando algo falla. Ese comportamiento único permite que Copilot, o una pipeline, traten la ejecución como una puerta limpia. Cuando la prosa de Copilot dice "pruebas pasadas" pero el código de salida es distinto de cero, el código de salida es el correcto.
Tercero, confirme que usó el escenario real. Si una ejecución falla con "escenario no encontrado", es posible que Copilot haya inventado o recordado mal un ID. Vuelva a verificar los valores de -t y -e contra su archivo de instrucciones y el comando que Apidog generó en la pestaña CI/CD. Los IDs de Apidog son la verdad.
Opcional: conectar el servidor MCP de Apidog
Ejecutar apidog run desde su archivo de instrucciones cubre la mayor parte de lo que necesita. Para ir un paso más allá, conecte el servidor MCP de Apidog.
El modo agente en VS Code lee los servidores MCP de un archivo .vscode/mcp.json del espacio de trabajo en la raíz de su repositorio, según la documentación de GitHub sobre cómo extender Copilot con MCP. El servidor MCP de Apidog expone sus especificaciones de API a través de MCP, de modo que Copilot puede leer su esquema mientras escribe código, no solo después del hecho. La división del trabajo es clara: la CLI ejecuta las pruebas y MCP alimenta al agente con la especificación.
Si, en cambio, ejecuta el agente de codificación de Copilot en GitHub Actions, su configuración de MCP se encuentra en un lugar diferente. La añade como JSON en la sección de Configuración del repositorio, en la sección de Copilot bajo "Cloud agent", con cualquier secreto almacenado como secretos de Actions con el prefijo COPILOT_MCP_. El archivo .vscode/mcp.json es para el modo agente en su editor.
Cuando Copilot se equivoca
Algunos fallos aparecen con frecuencia durante la configuración.
Ignora el archivo de instrucciones. Si Copilot ejecuta un comando genérico o ninguno en absoluto, es posible que el archivo no se esté cargando. Confirme que se llama exactamente .github/copilot-instructions.md, que se encuentra en el directorio .github en la raíz de su repositorio y que las instrucciones personalizadas están habilitadas en la configuración de su VS Code. Una ruta incorrecta significa que Copilot nunca lo lee.
De todos modos, pasa un token de acceso. Si Copilot intenta agregar --access-token, está adivinando a partir de ejemplos públicos. El bloque ya le dice que no lo haga, ya que la máquina está autenticada a través de apidog login. Refuerce la línea y nunca ponga un token real en el archivo de instrucciones. Para el modelo de autenticación, consulte Autenticación de la CLI de Apidog.
Inventa una bandera. Un error de "opción desconocida" significa que Copilot adivinó una bandera que su versión no tiene. Dígale que ejecute apidog run --help y copie la bandera exacta de allí, lo cual siempre es correcto para su versión instalada.
Reporta un pase en una ejecución fallida. El más costoso, y la razón por la que la regla del código de salida está tanto en su archivo de instrucciones como en su paso de verificación. Cuando el resumen y el código de salida no concuerdan, el código de salida tiene la razón.
De un agente diario a un bucle probado
Esa es la configuración. Instale apidog-cli una vez siguiendo la guía de instalación, añada un breve bloque de Apidog a .github/copilot-instructions.md de su repositorio, y Copilot sabrá cómo ejecutar sus pruebas de API y leer el resultado dentro del mismo bucle que ya usa para editar código. Un endpoint roto se detecta mientras Copilot todavía está trabajando en el cambio, no después de que se implementa.
Una prueba detrás de una GUI se ejecuta cuando un humano hace clic; un comando de una línea se ejecuta cuando Copilot lo decide. Usted sigue construyendo escenarios visualmente en Apidog, y su agente los ejecuta donde usted no está mirando. Descargue Apidog, cree un escenario, inserte su comando apidog run en .github/copilot-instructions.md y observe cómo Copilot lo retoma en el siguiente cambio. Cuando esté listo para ejecutar el mismo comando en una pipeline sin Copilot presente, Apidog CLI en GitHub Actions cubre los secretos, los reporteros y el control de códigos de salida.