Aprobación humana
Aprobación humana de acciones de IA: tu equipo decide y luego el agente actúa
Marca una acción de API o un paso de un procedimiento con Requires team approval y el agente deja de ejecutarla por sí solo. La solicitud espera en la página Approvals, con sus datos exactos, hasta que alguien de tu equipo la aprueba o la rechaza, y el visitante ve el resultado en el chat.
Visitante: Mi pedido 48213 llegó con la tapa rota. Me gustaría un reembolso por ese artículo.
Agente: Lo siento. He pasado a nuestro equipo una solicitud de reembolso por el artículo del pedido 48213. Verás el resultado aquí mismo, en el chat. ¿Te ayudo con algo más mientras tanto?
Visitante: Sí, ¿enviáis a Austria?
Agente: Sí. Los pedidos a Austria suelen llegar en 3 a 5 días laborables.
Agente: Buenas noticias: nuestro equipo ha aprobado tu solicitud y ya se ha realizado.
Algunas acciones no deberían ejecutarse solo porque lo diga la IA
Un agente de IA que puede llamar a tu API es útil porque hace cosas: emitir un reembolso, cancelar una suscripción, añadir un abono, ampliar una prueba. Son justo las cosas que quieres que revise una persona, al menos al principio o a partir de cierto importe. Sin un paso de revisión te quedan dos malas opciones: darle la acción al agente y esperar que nunca se equivoque, o mantenerla fuera de su alcance y que tu equipo haga cada solicitud a mano. La aprobación del equipo pone a una persona entre la decisión del agente y tu API. El agente recoge los datos en la conversación, tu equipo aprueba o rechaza con un clic y solo una solicitud aprobada llega a tus sistemas.
Por qué poner a una persona en el circuito de las acciones de IA
El agente lleva la conversación; tu equipo tiene la última palabra sobre lo que cambia.
Nada se ejecuta solo porque lo diga el agente
Cuando el agente llama a una acción que requiere aprobación, no se envía nada a tu API. La llamada se guarda con sus datos y espera a tu equipo. Las solicitudes rechazadas o caducadas nunca se ejecutan.
Exactamente lo que aprobaste, una sola vez
Al aprobar, la acción se ejecuta con exactamente los datos que muestra la página. No se vuelve a preguntar a la IA, así que no puede cambiar el importe ni el número de pedido después de tu decisión, y una solicitud nunca se ejecuta dos veces.
El visitante está informado
El agente le dice al visitante que su solicitud pasó a tu equipo y sigue ayudándole con todo lo demás. Cuando decides, el resultado aparece en el chat en su idioma: español, inglés, alemán, francés o italiano.
Tu equipo se entera
Quien puede decidir recibe un correo con los datos y un enlace. También puedes recibir un aviso en Slack y el webhook action_approval.requested, y la conversación entra en la Inbox como Open.
Encaja en tus procedimientos
Un paso de un procedimiento que llama a una acción también puede esperar la aprobación. Una vez aprobada, el procedimiento sigue con el paso siguiente; un rechazo o una caducidad lo detienen.
Cómo configurar la aprobación del equipo
Crea la acción de API
Crea la acción en la pestaña Actions, por ejemplo una llamada de reembolso a tu tienda o a tu sistema de facturación, con sus datos y su autenticación. Solo las acciones del lado del servidor pueden requerir aprobación; las acciones del lado del cliente y los botones, no.
Activa Requires team approval
En 3. When the AI should use it, activa Requires team approval y elige cuándo caduca una solicitud en espera: tras 1 hora, 4 horas, 24 horas (por defecto) o 3 días. La acción muestra entonces la etiqueta Needs approval en la lista.
Añádela a un procedimiento, si quieres
En un paso Call an action, marca Requires team approval para ese paso. Combínalo con Ask the visitor to confirm first: el visitante confirma y solo entonces la solicitud pasa a tu equipo.
Aprueba o rechaza en la página Approvals
Las solicitudes en espera aparecen en la página Approvals de la barra lateral, con un contador. Cada una muestra la acción, el agente, los datos, la caducidad y un enlace a la conversación. Approve la ejecuta; Reject admite un motivo opcional que el visitante ve.
La aprobación en detalle
Caducidad a tu elección
Cada acción o paso tiene su propia caducidad: 1 hora, 4 horas, 24 horas o 3 días. Una solicitud que nadie decide a tiempo nunca se ejecuta, y el visitante sabe que el equipo no pudo revisarla a tiempo.
Sin solicitudes duplicadas
Una conversación puede tener hasta 3 solicitudes en espera a la vez. Si el agente vuelve a llamar a la misma acción con los mismos datos mientras una espera, no se crea una segunda solicitud.
Solo cuenta una decisión
Si dos compañeros hacen clic a la vez, decide quien hace clic primero y el otro ve «Already decided». La acción nunca se ejecuta dos veces para una misma solicitud.
Rechaza con un motivo
Reject pide un motivo opcional de hasta 500 caracteres. El visitante lo ve en su chat, después del mensaje de que el equipo no pudo aprobar la solicitud.
Las credenciales quedan ocultas
Los datos cuyo nombre o valor parece una credencial, como api_key, password o un token bearer, aparecen como Hidden en la página, en los correos, en Slack y en los webhooks. Las cabeceras y la autenticación de tu acción nunca se guardan con una solicitud.
Quién puede decidir
El owner, los admins y los editors, y cualquier otra persona cuyo rol pueda editar las acciones del agente. Los miembros limitados a ciertos agentes solo ven sus solicitudes, y los viewers no pueden abrir la página.
Decisiones recientes y registro de auditoría
Recent decisions muestra las últimas 50, con quién decidió, cuándo, el motivo y el resultado. Cada aprobación y cada rechazo quedan también en el registro de auditoría.
Se ejecuta como lo habría hecho el agente
Una acción aprobada se ejecuta desde la acción guardada, dentro de su tiempo límite de 30 segundos, con el visitante verificado y el contacto de la conversación para los marcadores. Si mientras tanto la acción se eliminó o se desactivó, la aprobación falla y el visitante lo sabe.
Preguntas frecuentes
¿Qué es la aprobación humana de acciones de IA?
Es un paso de revisión entre la decisión del agente de IA y tus sistemas. Cuando el agente quiere ejecutar una acción marcada con Requires team approval, como un reembolso, la llamada se guarda con sus datos en lugar de enviarse. Alguien de tu equipo la aprueba o la rechaza y solo se ejecuta una solicitud aprobada. A esto se le suele llamar un flujo human in the loop.
¿Qué plan necesito?
La aprobación del equipo forma parte de los planes Pro y Enterprise. En Free y Starter el interruptor no se puede activar. Después de bajar de plan, las acciones que lo tienen lo conservan, pero el agente no las ejecuta desde el chat, y las solicitudes hechas antes se pueden seguir decidiendo.
¿Qué acciones pueden requerir aprobación?
Cualquier acción de API del lado del servidor y cualquier paso Call an action de un procedimiento. Una acción con Requires team approval espera la aprobación en cada paso que la llama, con la caducidad de la acción. Las acciones del lado del cliente, que se ejecutan en el navegador del visitante, y los botones no pueden requerir aprobación.
¿Qué ve el visitante mientras una solicitud espera?
El agente le dice, en su idioma, que la solicitud pasó a tu equipo y que el resultado aparecerá en el chat. Mientras tanto puede preguntar cualquier otra cosa. Un chat abierto muestra el resultado unos 15 segundos después de tu decisión; si no, lo ve la próxima vez que abre el chat.
¿Puede la IA cambiar los datos después de que apruebe?
No. Al aprobar, la acción guardada se ejecuta una vez con exactamente los datos que muestra la página Approvals. No se vuelve a preguntar a la IA, e intoCHAT construye la petición en ese momento a partir de la acción guardada, es decir, con tu endpoint y tu autenticación actuales.
¿Cómo se entera mi equipo?
Por correo a todas las personas que pueden decidir sobre ese agente; cada una puede desactivarlo en Notifications (Approval requests). Salen hasta 30 correos de solicitud por agente cada hora. También puedes activar el aviso de Slack Approval request, y los webhooks envían los eventos action_approval.requested y action_approval.decided.
¿Qué pasa en un procedimiento mientras un paso espera?
El paso sigue siendo el actual y el agente continúa ayudando con otras preguntas. Si la solicitud se aprueba y sale bien, el procedimiento sigue con el paso siguiente en el próximo mensaje del visitante. Si se rechaza, caduca o la acción falla, el procedimiento se detiene. Si el procedimiento termina antes, la solicitud se retira y nunca se ejecuta.
¿Funciona la aprobación en el Playground y en las pruebas?
En el Playground las solicitudes son reales: aparecen en la página Approvals, avisan a tu equipo y al aprobar se ejecuta tu acción real. En las pruebas con clientes simulados no se solicita nada; el agente solo sabe que la solicitud se hizo. En un chat temporal, una acción que requiere aprobación no se ejecuta en absoluto.
El agente pregunta, tu equipo decide
Crea tu agente gratis, añade tu primera acción de API, activa Requires team approval en Pro y prueba una solicitud en el Playground.
Crea tu agente gratisPlan gratuito, sin tarjeta de crédito.