Actualizado el Sep 17, 2026

Referencia de Acciones

Las acciones son los bloques de construcción que agregas en:

• Workflows > Pasos
• Agentes de IA > Acciones para pre-acciones y post-acciones
• Botones de notificación que ejecutan lógica de seguimiento

Cada acción hace un trabajo: llamar a una API, enviar un mensaje, actualizar un registro, ejecutar otro workflow o preparar datos para pasos posteriores.

No todas las acciones están disponibles en todos los constructores. Algunas acciones solo tienen sentido en workflows, algunas están diseñadas para pre-acciones o post-acciones de agentes, y algunas requieren un contexto de conversación activo.

Cómo usar esta referencia

Usa estas páginas para responder tres preguntas prácticas:

1. ¿Cuál acción debo elegir?
2. ¿Qué campos necesito completar?
3. ¿Qué resultado puedo reutilizar en un paso posterior?

Si necesitas ayuda para escribir expresiones para campos dinámicos, consulta el Editor de Expresiones CEL.

Reutilizando resultados de pasos anteriores

La mayoría de las acciones ponen datos a disposición de pasos posteriores. Referéncialos con step(0), step(1) y así sucesivamente.

Ejemplos:

• step(0).data
• step(1).status
• step(2).choices[0].message.content

Usa Iniciar depuración o depuración paso a paso para inspeccionar la forma exacta de la salida antes de crear condiciones sobre ella.

Metadatos compartidos de ejecución

Cuando quieres saber cómo se ejecutó un paso en sí, usa el objeto anidado executionContext. Esto mantiene los metadatos del ejecutor separados de las salidas propias de la acción.

Campos comunes:

• step(0).executionContext.status -- running, completed, skipped o failed
• step(0).executionContext.startedAt
• step(0).executionContext.finishedAt
• step(0).executionContext.safeError.code
• step(0).executionContext.safeError.userMessage
• step(0).executionContext.safeError.retryable
• step(0).executionContext.safeResult

Ejemplos:

• get(step(0), 'executionContext.status') == 'completed'
• get(step(1), 'executionContext.safeError.code') == 'unsupported_media_format'
• get(step(2), 'executionContext.safeResult.reason') == 'condition_false'

safeError y safeResult están sanitizados para ramificación y depuración. No incluyen stack traces sin procesar, secretos ni payloads del proveedor.

Algunas acciones ya usan campos de nivel superior como step(N).status para sus propias salidas, por ejemplo, un código de estado HTTP. Prefiere step(N).executionContext.status cuando te refieres al resultado de la acción en sí.

Disponibilidad y contexto

• Usa acciones de conversación solo cuando la ejecución actual ya tiene una conversación con la que trabajar.
• Usa acciones específicas de agente solo donde las acciones de agente están soportadas.
• Si una acción depende de una funcionalidad específica, como memoria de conversación o un workflow hijo, asegúrate de que esa funcionalidad ya esté configurada antes de depender de la acción en producción.

Categorías

Categoría	Uso típico
IA y agentes	Generar texto, enviar trabajo a otro agente, preparar texto escrito para decirlo en voz alta, limpiar memoria o pausar las respuestas del agente
Código	Ejecutar JavaScript o Python en un sandbox sobre datos y archivos de pasos anteriores
Configuración	Cargar variables y secretos de la empresa en expresiones CEL
Datos	Crear, obtener, buscar, contar, actualizar, eliminar o activar workflows en tus datos de la empresa
Mensajes	Enviar respuestas a la conversación actual o enviar mensajes proactivamente a un contacto
Integraciones	Llamar APIs externas con solicitudes HTTP o descargar archivos directamente al storage
MCP	Conectar servidores MCP para que un agente use sus herramientas
Monitores	Registrar una vigía que despierta al agente más tarde — cuando un documento cambie, en un momento definido, o cuando una de las herramientas del propio agente reporte el estado que pediste
Medios	Guardar archivos en storage, generar documentos, leer un documento almacenado como texto, transcribir audio, decir texto como audio, convertir audio y vídeo entre formatos, inspeccionar las dimensiones y la duración de un archivo, reutilizar sus URLs, crear enlaces de descarga firmados y eliminar archivos que ya no necesitas
Notificaciones	Alertar a miembros del equipo dentro de AutoTalk
Seguridad	Generar tokens JWT temporales
Estado de la sesión	Almacenar valores para expresiones CEL posteriores en la misma ejecución

Eligiendo la acción correcta

• Usa Generar Respuesta LLM cuando quieras la salida directa del modelo.
• Usa Enviar Mensaje al Agente cuando quieras que otro agente maneje la solicitud.
• Usa Componer Respuesta de la Conversación cuando quieras responder en la conversación actual.
• Usa Enviar Mensaje al Contacto cuando necesites enviar un mensaje directamente a un contacto específico.
• Usa Buscar Datos de la Empresa cuando necesites una lista.
• Usa Contar Datos de la Empresa cuando solo necesites cuántos coincidieron.
• Usa Obtener Datos de la Empresa cuando ya sepas qué registro quieres.
• Usa Ejecutar Workflow cuando quieras que un workflow llame a otro.
• Usa Leer Archivo como Texto cuando necesites lo que hay dentro de un documento que adjuntó un contacto, y Transcribir Audio cuando el adjunto sea una grabación.
• Usa Crear Monitor cuando la respuesta llega después — nunca consultes en bucle por un trabajo o un estado externo.

Acciones que no retornan campos reutilizables

Algunas acciones son principalmente efectos secundarios y no proporcionan un resultado de paso significativo para reutilizar.

Ejemplos comunes:

• Limpiar Memoria de la Conversación
• Pausar respuestas del agente
• Crear Notificación del Profesional

Úsalas cuando necesites el efecto en sí, no un valor para lógica posterior.