Una automatización es un disparador adjunto a un flujo de trabajo. El flujo de trabajo indica qué hacer; la automatización indica cuándo iniciar otra ejecución.
Una automatización usa:
- Un flujo de trabajo, con su procedimiento actual
- Un propietario, cuya conversación de automatización y acceso conectado se usan
- Un disparador, como un horario, un evento de un servicio conectado o un webhook entrante
Qué se ejecuta cada vez
Cada activación inicia una nueva ejecución en la conversación de automatización para ese flujo de trabajo y propietario. No crea una conversación completamente nueva en cada activación. Las automatizaciones propiedad del mismo miembro para el mismo flujo de trabajo reutilizan esa conversación de automatización.
La ejecución usa la instrucción actual del flujo de trabajo y la carga útil del disparador. Como la conversación se reutiliza, las ejecuciones anteriores permanecen en su historial de hilos. 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 temporal explícita.
El modelo se selecciona en el hilo de la conversación de automatización, no en el agente ni en el flujo de trabajo. Cuando la conversación 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. Las activaciones posteriores reutilizan el modelo seleccionado para ese hilo.
Abre la conversación de automatización para inspeccionar sus ejecuciones, resultados y errores visibles. Una activación fallida sigue siendo visible allí para que puedas corregir el flujo de trabajo, el acceso del conector o el disparador y ejecutarlo de nuevo.
Referencia de disparadores
El selector de automatizaciones en un flujo de trabajo es la fuente de verdad sobre lo que el espacio de trabajo actual puede crear. Algunos tipos de evento se lanzan detrás de interruptores de funciones del espacio de trabajo y, por lo tanto, pueden no aparecer en todas partes.
Horarios
| Tipo | Comportamiento |
|---|---|
| Programado | Se ejecuta en horas de reloj usando una programación cron y una zona horaria IANA. |
| Intervalo | Espera el intervalo configurado después de que una ejecución termina y luego programa la siguiente ejecución. Las ejecuciones no se solapan entre sí. |
| Una vez | Se ejecuta en la fecha y hora seleccionadas y luego se desactiva. |
Confirma la zona horaria que se muestra en la automatización antes de guardar. Usa una automatización programada para la sincronización basada en hora de reloj y una automatización de intervalo para sondeos cuando importe el espaciamiento tras la finalización.
Gmail
| Evento | Filtros |
|---|---|
| Nuevo mensaje | Coincidencias opcionales para De, Para, Cc, Asunto y texto del cuerpo. Sin coincidencias, cualquier mensaje nuevo es elegible. |
| Etiqueta aplicada | Un solo nombre de etiqueta de Gmail. |
Empieza con filtros de mensajes nuevos restrictivos para que una bandeja de entrada ocupada no cree una cantidad inesperada de ejecuciones.
GitHub
Los eventos de GitHub requieren que la GitHub App de Okou esté instalada en tu organización de GitHub. Si no lo está, la pantalla de configuración de la automatización lo indica: un administrador de la organización obtiene allí un botón Instalar GitHub App, y al resto se le indica que pida a un administrador que lo haga. Instálala una vez y cada disparador de GitHub que aparece abajo estará disponible.
| Evento | Filtros habituales |
|---|---|
| Solicitud de extracción | Un repositorio y una acción: abierta, reabierta, cerrada, lista para revisión, convertida en borrador, sincronizada, añadida a la cola de fusión o eliminada de ella, etiquetada o sin etiqueta. Acótalo por rama base, autor, número de PR o etiqueta. Para closed, puedes distinguir entre fusionada y cerrada sin fusionar. |
| Ejecución de flujo de trabajo completada | Repositorio, flujo de trabajo, resultado, rama, evento desencadenante y actor. |
| Trabajo de flujo de trabajo completado | Repositorio, flujo de trabajo, trabajo, resultado, rama, etiqueta del runner y grupo del runner. |
| Revisión de solicitud de extracción enviada | Repositorio, estado de la revisión, rama base, rama principal y autor de confianza. |
| Estado de despliegue creado | Repositorio, entorno, estado, ref, creador, aplicación e indicador de entorno de producción. |
| Comentario creado en incidencia o solicitud de extracción | Repositorio, ámbito de incidencia o PR, autor de confianza y prefijo del comentario. |
No existe un evento separado GitHub label applied. Para reaccionar a una etiqueta de un PR, elige Pull request, selecciona la acción Labeled y añade un filtro de etiqueta.
Google Calendar and 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 supervisa uno de tus hilos de chat. Puede filtrar por estado completed, failed o cancelled y, para ejecuciones completed, por una coincidencia comodín sin distinción entre mayúsculas y minúsculas
*aplicada a la respuesta final. - Webhook received crea una URL entrante firmada y está disponible cuando el plan del espacio de trabajo incluye automatizaciones por webhook.
- Google Forms response submitted, Notion page/database events, Strapi entry published y Stripe invoice paid solo aparecen en los espacios de trabajo en los que esas funciones de automatización están habilitadas.
Las automatizaciones de eventos también requieren que el conector o la integración correspondiente esté conectado y listo para el propietario de la automatización.
Los mensajes de automatización describen lo que ocurrió en lenguaje claro, y una ejecución iniciada por un disparador chat run finished apunta de vuelta al hilo de origen.
Crear una automatización
Desde un chat que funciona. Ejecuta la tarea primero como algo puntual. Cuando produzca lo que quieres, di:
"Ejecuta esto todos los días laborables a las 8 a. m., hora de Los Ángeles, y envíame el resultado por DM."
Okou confirma el flujo de trabajo, la cadencia y el destino, guarda el flujo de trabajo si todavía no existe y adjunta la automatización.
Explícitamente. Abre un flujo de trabajo en tu espacio de trabajo, haz clic en Add automation y elige el tipo de disparador y sus filtros. Es útil cuando ya conoces la estructura por adelantado y no quieres una ejecución de prueba.
El procedimiento proviene del flujo de trabajo. En My Okou, la ejecución usa las instrucciones personales, la memoria, las cuentas conectadas y los permisos del propietario de la automatización en ese espacio de trabajo. En Legacy Agents, el agente propietario proporciona el contexto del agente. Un disparador de horario pregunta cuándo ejecutar y en qué zona horaria.
Un flujo de trabajo público comparte un método, no las automatizaciones ni el acceso de su creador. Cada miembro crea y administra sus propias automatizaciones. No asumas que copiar un flujo de trabajo transfiere los disparadores, credenciales o la conversación de automatización de otro miembro.
Las automatizaciones se pueden habilitar y deshabilitar de forma individual sin eliminarlas, lo que resulta útil antes de unas vacaciones o mientras depuras un disparador ruidoso.
Destinos
Una automatización necesita saber adónde va el resultado. Indícalo en la instrucción del flujo de trabajo:
- Canal de Slack o DM — lo más común; llega al canal como un mensaje o un hilo
- Feishu o Microsoft Teams — la misma idea para equipos que viven allí
- Telegram o mensaje de texto — para alertas personales y orientadas al móvil
- 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 al final o sobrescrito
- Un issue de GitHub o comentario de PR — 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 Sitios alojados
- Un archivo del espacio de trabajo — cuando el artefacto es un video, una imagen o un recurso descargable
"Publica en #engineering" o "Envíamelo por DM" es más claro que "envíalo a algún sitio."
Consejos de operación
Estos provienen de ejecutar automatizaciones en producción:
- Observa las tres primeras ejecuciones. Las automatizaciones son fáciles de configurar; es más fácil afinarlas una vez que ves lo que Okou realmente produce en tu entorno.
- Mantén pequeña cada tarea. Las automatizaciones largas y de varios pasos son más frágiles. Si una sola tiene que actualizar cinco sistemas, considera dividirla en dos.
- Fija el destino. Los canales cambian de nombre 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 siguiente ejecución.
- Delimita las consultas de larga duración en el tiempo. Si el prompt pide "los últimos 30 días", vuelve a indicar eso en cada ejecución para que la ventana siga actualizada.
- Confirma la zona horaria. Las automatizaciones programadas y de una sola vez guardan una zona horaria explícita; comprueba el valor que se muestra antes de guardar.
- Pausa antes de las vacaciones. Especialmente para las automatizaciones que te envían DM: volver a 14 DM breves no es útil. Deshabilita la automatización y vuelve a habilitarla cuando regreses; el flujo de trabajo permanece intacto.
Costes y volumen
La activación de una automatización inicia una ejecución normal y puede consumir créditos según la ruta del modelo y los servicios que use. Revisa la conversación de automatización y Billing al estimar el coste.
Los intervalos cortos se multiplican rápidamente: un intervalo de 15 minutos puede ejecutarse hasta 96 veces en un día si cada ejecución termina antes de que venza el siguiente intervalo. Los filtros de eventos amplios pueden ser igual de ruidosos. Empieza de forma restrictiva, inspecciona las primeras pocas activaciones y luego amplía el filtro o la cadencia deliberadamente.
Desactiva una automatización cuando quieras detener nuevas activaciones sin eliminar su flujo de trabajo ni su historial.
Qué sigue
- Consulta Flujos de trabajo para ver el procedimiento que ejecuta una automatización.
- Consulta Chat para ver qué sucede dentro de cada ejecución.
- Consulta Flujos de ejemplo para cinco combinaciones completas de flujo de trabajo y automatización.
