Confirmaciones de acciones
Cómo cambian las confirmaciones según el canal
La forma en que se confirma y se ejecuta una herramienta de acción depende del canal en el que se ejecuta el agente. El agente sigue decidiendo qué acción realizar de la misma manera en todas partes; lo que cambia es si una persona hace clic en una tarjeta primero.
| Canal | Comportamiento |
|---|---|
| Interno (interfaz de Salesforce) | Muestra una tarjeta de confirmación; la acción se ejecuta solo después de que el usuario hace clic en Confirmar. Esta es la experiencia que se describe a lo largo de este artículo. |
| Widget externo y Comunidad | Ejecuta la acción automáticamente (sin tarjeta) y, a continuación, el agente toma automáticamente un turno de seguimiento e informa el resultado real; por ejemplo, «He creado el Caso n.º 00001234». Si la acción falla, lo dice con honestidad en lugar de dar a entender que tuvo éxito. La cantidad de turnos de seguimiento automáticos que el agente puede tomar de forma consecutiva está limitada por una configuración de la plataforma para evitar bucles descontrolados. |
| API / Flow | Con autoExecuteActions=true la acción se ejecuta de forma silenciosa: sin tarjeta ni narración; el Flow que la invoca gestiona el resultado. |
¿Qué es una confirmación de acción?
Una confirmación de acción es una tarjeta de interfaz de usuario que aparece antes de que la IA ejecute cualquier herramienta de la categoría Acción (herramientas que modifican o crean datos de Salesforce). La tarjeta de confirmación muestra:
- Tipo de acción — qué operación se realizará (por ejemplo, «Crear tarea», «Enviar correo», «Actualizar registro»)
- Detalles clave — los principales valores de campo que se crearán o cambiarán
- Botones de confirmación — «Confirmar» (continuar) o «Cancelar» (abortar)
Este mecanismo de seguridad evita que los usuarios hagan que la IA cree registros, envíe correos o modifique datos de forma accidental sin una aprobación explícita.
Cuándo se requieren confirmaciones
Las tarjetas de confirmación aparecen para las herramientas de la categoría Acción:
| Herramienta | ¿Confirmación? | Qué se muestra |
|---|---|---|
| create_record | Sí | Tipo de objeto, campos principales (Nombre, Etapa, Importe, etc.) |
| update_record | Sí | Nombre/ID del registro, qué campos se cambiarán y los nuevos valores |
| delete_record | Sí | Nombre/ID del registro, confirmación de que se eliminará |
| send_email | Sí | Destinatarios, asunto, vista previa del cuerpo del correo |
| create_task | Sí | Asunto, fecha de vencimiento, prioridad, asignado a |
| create_event | Sí | Título del evento, hora de inicio/fin, asistentes, ubicación |
| send_custom_notification | Sí | Título de la notificación, cuerpo y destinatarios |
| link_file_to_record | No | N/D — adjunta un archivo existente a un registro sin tarjeta |
| continue_workflow | No | N/D — solicita un turno autónomo más (solo canal API); por sí misma no modifica datos |
| schedule_action | No (excepción) | N/D — se ejecuta de forma silenciosa |
Las herramientas de solo lectura (soql_query, get_record, describe_object) nunca requieren confirmación porque no modifican datos.
La experiencia del usuario con la tarjeta de confirmación
Esto es lo que el usuario ve y experimenta:
-
El usuario solicita una acción
El usuario escribe: «Crea una tarea para hacer seguimiento con John Smith el próximo martes, prioridad alta».
-
La IA decide llamar a una herramienta
La IA determina que create_task es la herramienta adecuada para esta solicitud.
-
Aparece la tarjeta de confirmación
En lugar de crear la tarea de inmediato, se muestra una tarjeta de confirmación en la ventana de chat con lo siguiente:
- Acción: «Crear tarea»
- Asunto: «Seguimiento: John Smith»
- Fecha de vencimiento: [fecha del próximo martes]
- Prioridad: «Alta»
- Botones: «Confirmar» y «Cancelar»
-
El usuario revisa y aprueba
El usuario lee la confirmación, verifica los detalles y hace clic en «Confirmar» si todo es correcto.
-
La acción se ejecuta
REDA AI ejecuta la herramienta create_task y devuelve un mensaje de éxito en el chat.
-
Alternativa: el usuario cancela
Si el usuario detecta un error, hace clic en «Cancelar». La tarea no se crea y la IA puede pedirle al usuario que aclare o vuelva a intentarlo.
Diseño de la tarjeta de confirmación
Las tarjetas de confirmación se muestran en la interfaz de chat de REDA AI y están diseñadas para ofrecer claridad:
- Etiquetado claro — secciones «Tipo de acción:» y «Detalles:»
- Diseño legible — los campos y valores son fáciles de revisar
- Botones de confirmación destacados — «Confirmar» (por lo general verde/positivo) y «Cancelar» (gris/neutral)
- Sin confirmación automática — el usuario debe hacer clic activamente para confirmar; no hay tiempo de espera ni aprobación automática
Las acciones personalizadas también muestran sus detalles. Una tarjeta de confirmación creada para una de tus propias herramientas de clase Apex ahora enumera los valores que el agente pretende usar, con el mismo diseño que una acción nativa, en lugar de indicar únicamente el nombre de la acción. Esto importa porque una confirmación que no puedes leer no es una decisión: aprobar «Crear orden de trabajo» sin ver de qué propiedad, qué proveedor y qué importe se trata es solo hacer clic en Confirmar. No ha cambiado nada sobre cuándo se requiere una confirmación; solo lo que la tarjeta te muestra antes de que la apruebes.
Excepción de schedule_action
De las tres herramientas que se saltan la tarjeta, schedule_action es la que merece explicación: es la que más parece necesitarla. Se ejecuta sin tarjeta porque:
- schedule_action programa una acción futura (no inmediata)
- El usuario puede cancelar o modificar la acción programada más adelante
- No modifica de inmediato los datos de producción
Ejemplo: «Programa un correo para enviarlo al cliente mañana a las 10 a. m.»: schedule_action se ejecuta de inmediato (programando el correo futuro), pero no se requiere confirmación porque la acción aún no ha ocurrido.
Ejecución automatizada sin confirmación
Cuando el agente se invoca desde Salesforce Flow con el parámetro autoExecuteActions=true, las herramientas de acción se ejecutan sin tarjetas de confirmación. Esto resulta útil para:
- Flujos de trabajo automatizados — Flows que necesitan crear registros sin interacción del usuario
- Operaciones por lotes — procesamiento de varias solicitudes sin aprobación manual
- Integraciones de backend — uso del agente basado en API donde no es posible una confirmación en la interfaz
Cuando autoExecuteActions=true, la IA asume que la solicitud ya se ha validado y ejecuta las acciones de forma silenciosa.
¿Qué sucede si el usuario cancela?
Si el usuario hace clic en «Cancelar» en una tarjeta de confirmación:
- NO se llama a la herramienta de acción
- No se crea, actualiza ni elimina ningún dato
- La IA recibe un estado «cancelado»
- La IA informa al usuario: «Acción cancelada. ¿Quieres que intente algo diferente?»
La conversación continúa normalmente. El usuario puede pedirle a la IA que vuelva a intentarlo con parámetros diferentes o solicitar una acción distinta.
Situaciones de confirmación habituales
La confirmación muestra: Objeto «Oportunidad», Nombre de la cuenta «Acme Corp», Etapa del negocio «Calificación», Importe «$50,000», Fecha de cierre «31 de marzo de 2026».
La confirmación muestra: Destinatarios «john@example.com, jane@example.com», Asunto «Actualización del proyecto», vista previa del cuerpo (primeros 100 caracteres).
La confirmación muestra: Registro «Oportunidad: Acme Deal», Cambios: «StageName: Propuesta → Negociación/Revisión», «Probabilidad: 50% → 75%».
La confirmación muestra: Advertencia «Eliminar Caso n.º 001234», con confirmación requerida porque la eliminación es destructiva.
Prácticas recomendadas para las confirmaciones
Enseña a los usuarios que las tarjetas de confirmación son puntos de control de seguridad críticos. Capacítalos para leer los detalles con atención antes de hacer clic en «Confirmar».
Da instrucciones adecuadas a la IA — cuando le pidas a la IA que cree o modifique datos, sé lo más específico posible. Ejemplo: «Crea una tarea con el asunto 'Seguimiento', fecha de vencimiento mañana, prioridad Alta» en lugar de «Crea una tarea» (demasiado vago).
Supervisa las cancelaciones — si los usuarios cancelan confirmaciones con frecuencia, es posible que la IA no esté entendiendo bien sus solicitudes. Revisa los prompts y las instrucciones de Schema para mejorar la precisión.
Solución de problemas de confirmación
Si se llama a una herramienta de acción pero no aparece ninguna confirmación, comprueba que la herramienta realmente sea de la categoría Acción (no de la categoría Herramienta). Verifica que la configuración del agente sea correcta.
Los detalles de la confirmación están incompletos o son incorrectos — es posible que la IA no esté interpretando bien las solicitudes de los usuarios. Usa los Prompts personalizados para dar instrucciones de Acción más claras. Ejemplo: «Al crear una tarea, incluye siempre el asunto, la fecha de vencimiento y la prioridad».
Los usuarios cancelan con demasiada frecuencia — es posible que la IA esté sugiriendo valores de campo incorrectos. Agrega prompts de Schema para dar contexto sobre los valores de las listas de selección de los campos, o refina los Prompts personalizados para guiar mejor a la IA.
Acciones de correo, registros y programación
El correo distingue al destinatario Contacto o Prospecto del registro de negocio relacionado, admite listas Para/CC y comprueba los casos de exclusión de correo compatibles. Los Contactos/Prospectos enviados como registros relacionados se tratan como destinatarios. Las confirmaciones de registros muestran campos no aplicados. Los pasos del plan se concilian uno a uno y los horarios relativos conservan UTC. Se comprueban agentes desactivados y acciones anidadas no permitidas antes de ejecutar confirmaciones. La confirmación de vínculos de archivos reutiliza la ruta con control de acceso. Las acciones nuevas pendientes o reprogramadas por hora requieren un procesador disponible; el seguimiento de respuestas de correo y las actualizaciones normales de historial/estado continúan. Los trabajos posteriores se ejecutan como su propietario de programación, sin suplantar al solicitante. Las instrucciones reducen duplicados por otros conectores, pero no garantizan el comportamiento del asistente.
Preguntas frecuentes
No de forma global. Las tarjetas de confirmación son una función de seguridad integrada de las herramientas de acción. Sin embargo, puedes desactivar la confirmación mediante programación al usar el agente en Flows con autoExecuteActions=true. Para el chat interactivo, las confirmaciones siempre se muestran.
La acción se ejecuta. Sin embargo, si el usuario se da cuenta del error de inmediato, a menudo puede deshacerlo (según la acción). Por ejemplo, si creó un registro por accidente, puede eliminarlo enseguida. En el caso de los correos enviados, deshacer no siempre es posible.
Tres: schedule_action, link_file_to_record y continue_workflow tienen Requires Confirmation desactivado. Todas las demás herramientas de acción -create_record, update_record, delete_record, create_task, create_event, send_email y send_custom_notification- sí la requieren.
No hay límite de tiempo. La tarjeta de confirmación permanece en pantalla hasta que el usuario hace clic en «Confirmar» o «Cancelar». El usuario puede tomarse todo el tiempo que necesite para revisar los detalles.
Próximos pasos
Explora los campos de contexto para darle a tu agente más contexto de datos, o conoce el acceso a datos y permisos para entender los controles de seguridad.