Revisión humana

Qué hace una revisión humana

Un Human review es una acción de respuesta. Cuando el flujo llega a este punto, el asistente se detiene y solicita una decisión a los compañeros designados. El visitante lee un mensaje de espera. El flujo solo continúa después de que el primer compañero dé su aprobación. Si un compañero rechaza la solicitud, o si nadie responde a tiempo, el Flow se detiene con un mensaje que tú configures.

La solicitud se envía por correo electrónico desde tu propio buzón de Microsoft 365, o por Slack a través de la conexión de Slack de la organización. Ambos incluyen el título, tu mensaje, un resumen de la conversación y un enlace firmado a una página de decisión en la consola.

Configura la acción

1. Añade Human review desde la paleta o desde el selector de acciones.
2. Introduce un Title y un Message to the reviewer. Las variables de plantilla funcionan en ambos.
3. Introduce a los revisores en Assigned to, como direcciones de correo electrónico. Cada dirección debe pertenecer a un Member de la Organization.
4. Selecciona el Channel.
   • Email: conecta tu buzón de Microsoft 365 con Connect y, a continuación, selecciónalo en Sent from. La solicitud se envía desde tu cuenta.
   • Slack: introduce el ID del canal o el ID del miembro. La conexión de Slack de la organización debe tener el ámbito chat:write.
5. Añade al menos un Input para que el revisor lo rellene: texto corto, texto largo, un menú desplegable o sí/no. Cada entrada tiene un id.
6. Establece Expires after en horas. El valor predeterminado es 24.
7. Introduce lo que lee el Visitor mientras espera y si se rechaza o caduca.

El nodo muestra Needs setup hasta que se hayan rellenado todos los campos obligatorios. Publish rechaza un Flow cuyos revisores no sean Members o cuyo remitente no esté conectado.

Previsualiza la solicitud

En el lienzo, selecciona el nodo y abre Run node. El panel muestra el correo electrónico o el mensaje de Slack tal y como lo leerá el revisor. Desde ahí no se envía nada.

Decide sobre una solicitud

El enlace abre una página en la consola. Debes haber iniciado sesión. La página muestra el mensaje, la conversación hasta el momento, las entradas y Approve / Reject.

• Solo una persona asignada, o bien un Owner o un Admin, puede tomar la decisión.
• La primera decisión cierra la solicitud. Los visitantes posteriores ven quién tomó la decisión.
• Se rechaza la aprobación si una entrada obligatoria está vacía.

Una solicitud pendiente también aparece en el Inbox. Abre la conversación para ver su estado y las aportaciones del revisor, o filtra la Bandeja de entrada por Human review → Pending reviews.

Qué sucede después de la decisión

• Approved: las acciones posteriores a la ejecución de la revisión humana. Las entradas del revisor están disponibles como variables de plantilla, {{review.<id>}}, junto con {{review.decidedBy}} y {{review.approved}}. La respuesta se añade a la conversación como el siguiente mensaje del asistente.
• Rejected o expired: en su lugar, se añade el mensaje de detención.

La solicitud pendiente conserva las acciones del flujo, la configuración del asistente, las habilidades y las variables extraídas que se admitieron cuando se inició. Las modificaciones ordinarias se aplican a las nuevas solicitudes. Deshabilitar o eliminar el Flow, o anular la publicación del Assistant, detiene de forma permanente el trabajo pendiente. Volver a habilitar o publicar no reinicia ese trabajo. Las credenciales y los permisos actuales siguen aplicándose cuando el Flow continúa. Las credenciales de autenticación introducidas pueden rotar mientras una solicitud está en espera. Los cambios en los encabezados de solicitud de formato libre o en los parámetros de consulta detienen la solicitud de forma segura. Esos campos pueden contener credenciales personalizadas, por lo que Ciele no conserva ningún valor en bruto en la continuación. No se conservan los archivos adjuntos originales ni la prueba de identidad guardada. Una acción dependiente de la identidad requiere una nueva solicitud atendida. Las solicitudes anteriores que no tengan una continuación guardada se detienen con una explicación. Inicia una nueva solicitud para continuar.

El Visitor ve el resultado la próxima vez que escriba o vuelva a abrir el chat.

Vista previa

En la vista previa, la solicitud se simula. No se envía nada. La transcripción muestra la solicitud con los botones Approve y Reject, y el Flow continúa en el mismo chat. Un chat de Teammate no tiene Flows, por lo que nunca llega a una revisión humana.

API, CLI y MCP

Una clave API no tiene correo electrónico, por lo que solo puede tomar decisiones cuando su Role es Owner o Admin.