Una automatización es un activador asociado a un flujo de trabajo. El flujo de trabajo dice qué hacer; la automatización dice cuándo iniciar otra ejecución.
Una automatización usa:
- Un flujo de trabajo, incluido el agente que lo posee
- Un propietario, cuyo chat de automatización y accesos conectados se utilizan
- Un activador, como una programación, un evento de un servicio conectado o un webhook entrante
Qué se ejecuta cada vez
Cada disparo inicia una nueva ejecución en el chat de automatización de ese flujo de trabajo y propietario. No crea un chat completamente nuevo en cada disparo. Las automatizaciones del mismo miembro para el mismo flujo de trabajo reutilizan ese chat de automatización.
La ejecución usa la instrucción actual del flujo de trabajo y el payload del activador. Como el chat se reutiliza, las ejecuciones anteriores permanecen en el historial del hilo. Si una tarea debe comportarse sin estado, indícalo en la instrucción del flujo de trabajo y dile que use solo el evento actual o una ventana de tiempo explícita.
El modelo se selecciona en el hilo del chat de automatización, no en el agente ni en el flujo de trabajo. Cuando el chat de automatización se crea por primera vez, su modelo parte del valor predeterminado del miembro y luego del valor predeterminado del espacio de trabajo. Los disparos posteriores reutilizan el modelo elegido para ese hilo.
Abre el chat de automatización para inspeccionar sus ejecuciones, salidas y errores visibles. Un disparo fallido permanece visible allí para que puedas corregir el flujo de trabajo, el acceso al conector o el activador y volver a ejecutarlo.
Referencia de activadores
El selector de automatización de un flujo de trabajo es la fuente de verdad de lo que el espacio de trabajo actual puede crear. Algunos tipos de evento se publican detrás de conmutadores de funciones del espacio de trabajo y, por lo tanto, pueden no aparecer en todas partes.
Programaciones
| Tipo | Comportamiento |
|---|---|
| Scheduled | Se ejecuta en horarios de reloj mediante una programación cron y una zona horaria IANA. |
| Interval | Espera el intervalo configurado después de que una ejecución finaliza y luego programa la siguiente. Las ejecuciones no se superponen consigo mismas. |
| Once | Se ejecuta en la fecha y hora elegidas y luego se desactiva a sí misma. |
Confirma la zona horaria que se muestra en la automatización antes de guardar. Usa una automatización programada para el horario de reloj y una de intervalo para sondeos donde importa el espaciado tras la finalización.
Gmail
| Evento | Filtros |
|---|---|
| New message | Coincidencias opcionales de De, Para, Cc, Asunto y texto del cuerpo. Sin coincidencias, cada mensaje nuevo es elegible. |
| Label applied | Un nombre de etiqueta de Gmail. |
Empieza con filtros de mensaje nuevo estrechos para que una bandeja ocupada no cree una cantidad inesperada de ejecuciones.
GitHub
| Evento | Filtros comunes |
|---|---|
| Pull request | Un repositorio y una acción: opened, reopened, closed, ready for review, converted to draft, synchronized, added to or removed from the merge queue, labeled o unlabeled. Filtra por rama base, autor, número de PR o etiqueta. Para closed, puedes distinguir merged de closed without merging. |
| Workflow run completed | Repositorio, flujo de trabajo, conclusión, rama, evento desencadenante y actor. |
| Workflow job completed | Repositorio, flujo de trabajo, trabajo, conclusión, rama, etiqueta de runner y grupo de runner. |
| Pull request review submitted | Repositorio, estado de revisión, rama base, rama head y autor de confianza. |
| Deployment status created | Repositorio, entorno, estado, ref, creador, app y bandera de entorno de producción. |
| Issue or pull-request comment created | Repositorio, ámbito de issue/PR, autor de confianza y prefijo de comentario. |
No hay un evento separado GitHub label applied. Para reaccionar a una etiqueta de PR, elige Pull request, selecciona la acción Labeled y añade un filtro de etiqueta.
Google Calendar y Meet
- Calendar event created, updated o cancelled, limitado al ID de calendario que elijas
- Google Meet transcript generated, para reuniones organizadas por el miembro conectado
Chat y otras integraciones
- Chat run finished vigila uno de tus hilos de chat. Puede filtrar por estado completed, failed o cancelled y, para ejecuciones completadas, por un comodín
*que no distingue mayúsculas, comparado con la respuesta final. - Webhook received crea una URL entrante firmada y está disponible cuando el plan del espacio de trabajo incluye automatizaciones de webhook.
- Google Forms response submitted, Notion page/database events, Strapi entry published y Stripe invoice paid aparecen solo en espacios de trabajo donde esas funciones de automatización están habilitadas.
Las automatizaciones de eventos también requieren que el conector o la integración correspondiente estén conectados y listos para el propietario de la automatización.
Crear una automatización
Desde un chat que funciona. Ejecuta la tarea como algo puntual primero. Cuando produzca lo que quieres, di:
"Run this every weekday at 8 a.m. Los Angeles time and DM me the result."
Okou confirma el flujo de trabajo, la cadencia y el destino, guarda el flujo de trabajo si aún no existe y adjunta la automatización.
Explícitamente. Abre un flujo de trabajo en tu espacio de trabajo y añádele una automatización, eligiendo el tipo de activador y sus filtros. Útil cuando conoces la forma de antemano y no quieres una prueba en seco.
Las automatizaciones se pueden activar y desactivar individualmente sin eliminarlas: el movimiento correcto antes de unas vacaciones o mientras depuras un activador ruidoso.
Destinos
Una automatización necesita saber a dónde va el resultado. Indícalo en la instrucción del flujo de trabajo:
- Canal o DM de Slack — lo más común; llega al canal como mensaje o hilo
- Feishu o Microsoft Teams — la misma idea para equipos que viven allí
- Telegram o mensaje de texto — para alertas personales, móviles primero
- Una página o base de datos de Notion — para cosas que deben archivarse en lugar de difundirse
- Un Google Doc o Sheet — añadido o sobrescrito
- Un issue o comentario de PR de GitHub — para flujos de trabajo de ingeniería
- Un borrador de Gmail — preparado en tu cuenta para que lo revises y envíes
- Una página alojada — consulta Hosted sites
- Un archivo del espacio de trabajo — cuando el artefacto es un video, una imagen o un activo descargable
"Post to #engineering" o "DM me" es más claro que "send it somewhere."
Consejos operativos
Estos provienen de ejecutar automatizaciones en producción:
- Observa las tres primeras ejecuciones. Las automatizaciones son fáciles de configurar; son más fáciles de refinar una vez que ves lo que Okou produce en tu entorno.
- Mantén cada tarea pequeña. Las automatizaciones largas y de varios pasos son más frágiles. Si una sola debe actualizar cinco sistemas, considera dividirla en dos.
- Fija el destino. Los canales se renombran y la gente se va. Nombra el destino explícitamente en la instrucción del flujo de trabajo; Okou avisará si no puede encontrarlo en la próxima ejecución.
- Limita en el tiempo las consultas largas. Si el prompt pide "los últimos 30 días", repítelo en cada ejecución para que la ventana se mantenga actualizada.
- Confirma la zona horaria. Las automatizaciones programadas y únicas almacenan una zona horaria explícita; comprueba el valor mostrado antes de guardar.
- Pausa antes de las vacaciones. Especialmente en automatizaciones que te envían DM: volver a 14 DM breves no es útil. Desactiva la automatización y vuelve a activarla cuando regreses; el flujo de trabajo permanece intacto.
Costes y volumen
Un disparo de automatización inicia una ejecución normal y puede consumir créditos según la ruta del modelo y los servicios que use. Revisa el chat de automatización y Billing al estimar el coste.
Los intervalos cortos se multiplican rápido: un intervalo de 15 minutos puede ejecutarse hasta 96 veces al día si cada ejecución termina antes del siguiente intervalo. Los filtros de evento amplios pueden ser igual de ruidosos. Empieza estrecho, inspecciona los primeros disparos y luego amplía el filtro o la cadencia deliberadamente.
Desactiva una automatización cuando quieras detener nuevos disparos sin eliminar su flujo de trabajo o historial.
Siguiente
- Consulta Workflows para el procedimiento que ejecuta una automatización.
- Consulta Chat para lo que ocurre dentro de cada ejecución.
- Consulta Example workflows para cinco combinaciones completas de flujo de trabajo más automatización.