Trabajo externo con agentes

Antes de empezar#

• La entrega debe decir Alcance aprobado: consulta Revisión y planificación.
• El proyecto necesita un activador del agente de desarrollo. Solo la persona que opera la instalación puede configurarlo, en Infraestructura. Sin él, la entrega muestra «Para iniciar hace falta un activador del agente de desarrollo. La persona propietaria lo configura en Infraestructura.»
• Toda entrega a la que esta espera debe tener todos sus resultados aceptados.
• Necesitas el permiso Tomar decisiones.

Iniciar el desarrollo#

1. Abre Entregas planificadas y busca la entrega con Alcance aprobado.
2. En Rama de desarrollo, conserva el nombre sugerido o escribe otro. «Una rama de trabajo. No se puede usar la rama principal.» Una rama llamada main o master se rechaza con «Revisa los campos obligatorios y sus formatos.»
3. Elige Iniciar desarrollo.

Resultado esperado: «Guardado.», la entrega dice En desarrollo, y aparece el panel Actividad del código y de los agentes con una entrada de Envío a agentes externos en el estado En cola.

Lo que hiciste es solicitar trabajo. Que un agente haya empezado de verdad es un hecho aparte:

Si al iniciar la respuesta es «Una entrega planificada de la que depende esta aún no está terminada.», acepta primero los resultados de la entrega anterior.

Seguir el trabajo#

En Actividad del código y de los agentes hay dos tipos de registro que se mantienen visiblemente separados, porque ninguno prueba al otro:

• «GitHub · commit observado»: commits que Delegate leyó de la rama. Elige Obtener commits de GitHub para leerlos de nuevo.
• «MCP · informe del agente · {actor}»: lo que informó el propio agente.

Si no hay ninguno de los dos, el panel dice «Aún no se observaron commits ni informes de agentes.»

Cada requisito de la entrega pasa por estos estados en Requisitos:

Responder un bloqueo#

Un requisito bloqueado muestra Pregunta del agente con la pregunta tal como la escribió el agente, y aparece en Requiere mi atención como Agente bloqueado · se necesita una decisión.

1. Escribe tu Decisión.
2. Elige Responder y solicitar la continuación.

Resultado esperado: «Respondida por {actor}», y el estado A la espera de que el agente reanude. La ayuda dice exactamente qué pasa después: «Tu respuesta pone en cola la continuación. El trabajo solo se reanuda cuando el agente asignado lo confirma.» Tu respuesta no reinicia al agente por sí sola, y el estado no vuelve a En desarrollo hasta que el agente lo confirma.

Revisar un resultado#

Un requisito en Resultado por revisar muestra Resultado del agente: «Informado por {actor}», el resumen del agente, Revisar la propuesta de código (un enlace a un pull request del repositorio del proyecto; cualquier otra cosa se rechaza cuando el agente la entrega), la revisión, y Evidencia de pruebas informada.

La evidencia de pruebas es lo que el agente informó. No es una verificación de Delegate. Abre el pull request y júzgalo tú.

Aceptar un resultado no es un despliegue. El paso siguiente es una versión.

Autorizar trabajo de corrección#

Un resultado aceptado se puede reabrir solo en dos situaciones, y el formulario explica cuál corresponde:

• «Este resultado fue aceptado y todavía no está en una versión. El trabajo de corrección devuelve el requisito al alcance aprobado de su entrega planificada.»
• «La versión {name} no pasó su prueba. El trabajo de corrección devuelve este requisito al alcance aprobado de su entrega planificada; la versión rechazada y su revisión no cambian.»

Escribe Qué debe cambiar y elige Autorizar trabajo de corrección. «El resultado aceptado se conserva como evidencia. Se le pide al agente asignado volver a trabajar en este requisito.» Las correcciones anteriores quedan en «1 corrección autorizada».

Mientras la versión más reciente con el requisito siga en entrega, o su prueba haya sido aceptada, la corrección se rechaza: «La versión más reciente con este requisito sigue en entrega, o su prueba fue aceptada. Corrige una versión rechazada o planifica una entrega nueva.»

Un envío incierto#

Un envío dice Requiere atención cuando Delegate mandó una solicitud al proveedor y no sabe si empezó una sesión: se cortó la conexión, el proveedor respondió algo ilegible, o el proceso se detuvo a mitad de camino. Aparece en Requiere mi atención como Envío a un agente con resultado desconocido, y la línea de error dice «El resultado del envío es desconocido. Revisa el proveedor antes de que se envíe algo de nuevo.»

1. Abre la cuenta del propio proveedor y busca la sesión.
2. En Delegate, abre Resolver este envío: «Es posible que el proveedor haya iniciado una sesión, o que no. Nada se vuelve a enviar automáticamente. Revisa el proveedor y registra lo que encontraste.»
3. En ¿Qué encontraste?, elige una opción:
   • Se creó una sesión · registrar su enlace, y pega el Enlace de la sesión externa («Obligatorio si se creó una sesión.»).
   • No existe ninguna sesión · poner en cola un nuevo envío. Aceptas que, si te equivocaste, puede existir una sesión duplicada.
   • No existe ninguna sesión · no hace falta un nuevo envío.
4. Escribe ¿Qué revisaste? y elige Registrar resolución.

Resultado esperado: «Resuelto por {actor}: {outcome}.» Delegate registra lo que encontraste; no puede confirmarlo. Si el proveedor responde más tarde, la entrada suma «Un proceso de envío respondió después de que esto se resolvió (…). Se conserva como evidencia; la resolución se mantiene.»

Si al poner en cola un nuevo envío la respuesta es «Esta acción no está disponible en el estado actual. Actualiza la página.», el trabajo que describía ya no hace falta, por ejemplo porque el agente ya reanudó y su resultado fue aceptado. Elige en su lugar la opción que cierra.

Límites#

Siguiente acción#

Cuando una entrega diga Resultados aceptados · lista para una versión, continúa con Versiones y estado de la entrega.

Relacionado: Vocabulario de estados del trabajo · Recuperación en Delegate · Revisión y planificación