Ir al contenido

Guías

Agentes de IA en revisión de código, pruebas y despliegues

· 7 min de lectura

Los agentes de IA ayudan a los equipos de ingeniería cuando asumen tareas acotadas y repetitivas, como una primera revisión del código, el esqueleto de las pruebas o las tareas rutinarias de cada publicación de versión, con herramientas limitadas y una persona que aprueba cada cambio. Exija que presenten un plan antes de actuar, registre cada llamada a herramientas, reciba el trabajo en forma de diffs y pruébelos con ejemplos reales de su propio historial antes de ampliar su alcance.

Empiece por tareas repetitivas, verificables y de bajo riesgo

Las mejores primeras tareas para un agente son las que su equipo ya hace igual cada semana y puede verificar rápido. Si un ingeniero no es capaz de decir en un minuto si el resultado es correcto, el agente genera trabajo de revisión en lugar de ahorrarlo.

Deje para más adelante los cambios en datos de producción, los cambios de infraestructura y todo lo irreversible, hasta que el agente haya demostrado su fiabilidad en tareas más seguras.

  • Primera revisión de las pull requests: pruebas que faltan, patrones arriesgados, nombres poco claros, problemas de estilo
  • Generación de pruebas para funciones existentes, sobre todo casos límite y pruebas de regresión para errores ya corregidos
  • Pull requests de actualización de dependencias, con un resumen del registro de cambios de cada una
  • Notas de versión redactadas a partir de las pull requests fusionadas
  • Clasificación de las ejecuciones de CI fallidas: agrupar los fallos y señalar el commit que probablemente los causó

Elija la capa adecuada: API del modelo, framework de agentes o herramienta de flujos

Para una tarea única y bien definida bastan las llamadas directas a las API de OpenAI o de Anthropic Claude con uso de herramientas. LangChain añade integraciones y componentes habituales, y LangGraph modela un agente como un grafo explícito de pasos con un estado compartido, lo que facilita razonar sobre las bifurcaciones, los reintentos y los puntos de aprobación humana.

n8n encaja en todo lo que rodea al agente: activarse con un webhook de GitHub o GitLab, llamar al modelo, publicar un comentario de revisión, avisar en un canal. Un reparto habitual es dejar la orquestación a n8n y el paso de razonamiento en el código, donde se puede versionar y probar como el resto de su software.

En NorthStar Network, nuestros ingenieros crearon herramientas internas basadas en IA que automatizaban tareas de ingeniería recurrentes para el equipo de herramientas de la plataforma.

Dé al agente el conjunto mínimo de herramientas que necesita

Un agente solo puede causar daños a través de sus herramientas, así que la lista de herramientas es su principal control de seguridad. Defina cada herramienta con un propósito acotado y entradas validadas, en lugar de dar al agente una shell genérica o un token de API con permisos amplios.

Trate todo lo que lee el agente, incluidos el texto de las incidencias, los comentarios del código y las páginas web, como una entrada no fiable. Unas instrucciones ocultas en un archivo pueden intentar desviar al agente, un riesgo conocido como inyección de prompts, y lo que impide que ese intento cause daños son unos límites estrictos en las herramientas.

  • Solo lectura por defecto: leer archivos, diffs y registros de CI
  • Permisos de escritura limitados a una rama de trabajo, nunca a la rama principal ni a producción
  • Credenciales propias y de corta duración para cada agente, con los permisos mínimos
  • Ningún despliegue directo: el agente abre una pull request y su pipeline habitual despliega tras la aprobación
  • Una lista de comandos permitidos para ejecutar las pruebas, que se lanzan en un contenedor aislado

Primero el plan, después la acción, y cada llamada a herramientas registrada

Pida al agente que elabore un plan antes de cambiar nada: qué archivos va a leer, qué piensa cambiar y cómo comprobará el resultado. Los planes de bajo riesgo pueden ejecutarse automáticamente. Todo lo que toque código compartido espera a que una persona apruebe el plan.

Registre cada llamada a herramientas con sus entradas, sus salidas, la marca de tiempo y la tarea a la que pertenece. Ese registro le permite depurar un mal resultado, responder a una pregunta de auditoría y detectar a un agente que se sale de su tarea. Protéjalo como los demás registros de ingeniería, porque puede contener código fuente.

Fije límites estrictos para cada ejecución: un número máximo de pasos, de tokens y de minutos, y una parada tras varios fallos seguidos en lugar de un bucle infinito de reintentos.

Entregue cada cambio como un diff que revisa una persona

El resultado del agente debe llegar allí donde los ingenieros ya revisan el trabajo: una pull request, un comentario de revisión, un borrador de notas de versión. El diff muestra exactamente qué ha cambiado, la CI se ejecuta sobre él y se aplican sus reglas de aprobación habituales.

Mantenga los diffs del agente pequeños y con un único objetivo. Una pull request que añade pruebas a un módulo es fácil de revisar; otra que toca diez archivos para una mejora general acaba aprobada sin mirar o rechazada. Etiquete los cambios escritos por un agente para que los revisores comprueben las suposiciones, no solo la sintaxis.

Las pruebas generadas requieren un cuidado especial. Compruebe que verifican el comportamiento esperado y que fallarían si el código fuera incorrecto, en lugar de limitarse a registrar lo que devuelve el código actual.

Evalúe con su propio historial antes de ampliar el alcance

Cree un pequeño conjunto de evaluación a partir de sus propios repositorios: pull requests antiguas con problemas conocidos, funciones con errores conocidos, fallos de CI con causas conocidas. Ejecute el agente sobre ese conjunto cada vez que cambie el prompt, el modelo o las herramientas, y compare los resultados con la ejecución anterior.

En el día a día, mida con qué frecuencia los revisores aceptan las sugerencias del agente, cuántas pull requests del agente se fusionan sin cambios y con qué frecuencia se rechazan los planes. Dé al agente una tarea nueva o más accesos solo cuando esas señales sean estables.

Ponga por escrito la política de datos antes de la primera ejecución

Decida qué código y qué datos pueden enviarse a qué proveedor de modelos, con qué condiciones contractuales, y déjelo por escrito. Revise la configuración de conservación de datos y de entrenamiento de cada proveedor para el uso por API, y mantenga los secretos, las credenciales y los datos personales fuera de los prompts y de los registros.

Si un agente da servicio a varios equipos o clientes, aísle los datos, las credenciales y los registros de cada uno. SDK Pilot, nuestro agente de ingeniería con IA, ahora en acceso anticipado gratuito, sigue estas reglas: muestra su plan antes de ejecutar, registra cada llamada a herramientas, produce diffs revisables y aísla los datos de cada organización.

Puntos clave

  • Empiece con agentes en tareas repetitivas cuyo resultado un ingeniero pueda verificar en un minuto aproximadamente.
  • La lista de herramientas es el principal control de seguridad: herramientas acotadas, de solo lectura por defecto y con escritura limitada a una rama.
  • Exija un plan antes de actuar y registre cada llamada a herramientas con sus entradas y salidas.
  • Entregue todo el trabajo de los agentes como diffs pequeños, a través de su proceso habitual de revisión y CI.
  • Evalúe los agentes con ejemplos reales de su propio historial antes de darles más alcance.

Preguntas frecuentes

¿Pueden los agentes de IA sustituir la revisión de código humana?

No. Los agentes son útiles para una primera pasada que detecta pruebas que faltan, patrones arriesgados y problemas de estilo, para que los revisores humanos se centren en el diseño y la intención. Una persona debe seguir aprobando cada cambio que se fusiona.

¿Es seguro dejar que un agente de IA despliegue en producción?

No directamente. Deje que el agente abra una pull request o una solicitud de cambio y despliegue después con su pipeline actual, tras la aprobación de una persona. Así conserva intactos su registro de auditoría, sus pruebas y su procedimiento de vuelta atrás.

¿LangGraph o n8n para automatizar tareas de ingeniería?

Resuelven problemas distintos. LangGraph estructura el razonamiento del agente en pasos explícitos con estado y puntos de aprobación, mientras que n8n conecta sistemas mediante disparadores y acciones. Muchos equipos usan n8n para lanzar y encaminar el trabajo, y LangGraph o llamadas directas a la API del modelo para el propio agente.

Cuéntenos qué necesita.

Algo que desarrollar, personas que encontrar o una pregunta que resolver. En una llamada de 30 minutos le escuchamos y le decimos con franqueza cómo podemos ayudarle y qué haría falta.