Uma automação é um gatilho ligado a um fluxo de trabalho. O fluxo de trabalho diz o que fazer; a automação diz quando iniciar outra execução.
Uma automação usa:
- Um fluxo de trabalho, incluindo o agente que o possui
- Um proprietário, cujo chat de automação e acessos conectados são usados
- Um gatilho, como uma programação, um evento de um serviço conectado ou um webhook de entrada
O que é executado a cada vez
Cada disparo inicia uma nova execução no chat de automação daquele fluxo de trabalho e proprietário. Ele não cria um chat totalmente novo a cada disparo. Automações do mesmo membro para o mesmo fluxo de trabalho reutilizam aquele chat de automação.
A execução usa a instrução atual do fluxo de trabalho e o payload do gatilho. Como o chat é reutilizado, as execuções anteriores permanecem no histórico do thread. Se uma tarefa precisa se comportar sem estado, diga isso na instrução do fluxo de trabalho e peça para usar apenas o evento atual ou uma janela de tempo explícita.
O modelo é selecionado no thread do chat de automação, não no agente nem no fluxo de trabalho. Quando o chat de automação é criado pela primeira vez, o modelo dele parte do padrão do membro e depois do padrão do espaço de trabalho. Disparos posteriores reutilizam o modelo escolhido para aquele thread.
Abra o chat de automação para inspecionar execuções, saídas e erros visíveis. Um disparo com falha permanece visível lá, para que você possa corrigir o fluxo de trabalho, o acesso ao conector ou o gatilho e executá-lo novamente.
Referência de gatilhos
O seletor de automação em um fluxo de trabalho é a fonte da verdade do que o espaço de trabalho atual pode criar. Alguns tipos de evento são publicados atrás de feature switches do espaço de trabalho e, por isso, podem não aparecer em todos os lugares.
Programações
| Tipo | Comportamento |
|---|---|
| Scheduled | Executa em horários de relógio usando uma programação cron e um fuso horário IANA. |
| Interval | Espera o intervalo configurado após a conclusão de uma execução e então agenda a próxima. As execuções não se sobrepõem. |
| Once | Executa na data e hora escolhidas e então se desativa. |
Confirme o fuso horário mostrado na automação antes de salvar. Use uma automação programada para horário de relógio e uma de intervalo para sondagem onde o espaçamento após a conclusão importa.
Gmail
| Evento | Filtros |
|---|---|
| New message | Correspondências opcionais de De, Para, Cc, Assunto e texto do corpo. Sem correspondências, toda mensagem nova é elegível. |
| Label applied | Um nome de rótulo do Gmail. |
Comece com filtros de mensagem nova estreitos para que uma caixa de entrada movimentada não crie um número inesperado de execuções.
GitHub
| Evento | Filtros comuns |
|---|---|
| Pull request | Um repositório e uma ação: opened, reopened, closed, ready for review, converted to draft, synchronized, added to or removed from the merge queue, labeled ou unlabeled. Filtre por branch base, autor, número do PR ou rótulo. Para closed, você pode distinguir merged de closed without merging. |
| Workflow run completed | Repositório, workflow, conclusão, branch, evento de gatilho e ator. |
| Workflow job completed | Repositório, workflow, job, conclusão, branch, rótulo do runner e grupo do runner. |
| Pull request review submitted | Repositório, estado da revisão, branch base, branch head e autor confiável. |
| Deployment status created | Repositório, ambiente, estado, ref, criador, app e flag de ambiente de produção. |
| Issue or pull-request comment created | Repositório, escopo de issue/PR, autor confiável e prefixo do comentário. |
Não existe um evento separado GitHub label applied. Para reagir a um rótulo de PR, escolha Pull request, selecione a ação Labeled e adicione um filtro de rótulo.
Google Calendar e Meet
- Calendar event created, updated ou cancelled, limitado ao ID de calendário que você escolher
- Google Meet transcript generated, para reuniões organizadas pelo membro conectado
Chat e outras integrações
- Chat run finished observa um dos seus threads de chat. Ele pode filtrar por status completed, failed ou cancelled e, para execuções concluídas, por um curinga
*sem diferenciar maiúsculas, comparado à resposta final. - Webhook received cria uma URL de entrada assinada e está disponível quando o plano do espaço de trabalho inclui automações de webhook.
- Google Forms response submitted, Notion page/database events, Strapi entry published e Stripe invoice paid aparecem apenas em espaços de trabalho onde esses recursos de automação estão habilitados.
Automações de evento também exigem que o conector ou a integração relevante esteja conectado e pronto para o proprietário da automação.
Criando uma automação
A partir de um chat que funciona. Execute a tarefa como algo pontual primeiro. Quando ela produzir o que você quer, diga:
"Run this every weekday at 8 a.m. Los Angeles time and DM me the result."
O Okou confirma o fluxo de trabalho, a cadência e o destino, salva o fluxo de trabalho se ele ainda não existir e anexa a automação.
Explicitamente. Abra um fluxo de trabalho no seu espaço de trabalho e adicione uma automação a ele, escolhendo o tipo de gatilho e seus filtros. Útil quando você conhece a forma de antemão e não quer um teste a seco.
As automações podem ser ativadas e desativadas individualmente sem excluí-las — o movimento certo antes de férias ou enquanto você depura um gatilho barulhento.
Destinos
Uma automação precisa saber para onde o resultado vai. Diga isso na instrução do fluxo de trabalho:
- Canal ou DM do Slack — o mais comum; chega ao canal como mensagem ou thread
- Feishu ou Microsoft Teams — a mesma ideia para times que vivem lá
- Telegram ou mensagem de texto — para alertas pessoais, mobile-first
- Uma página ou banco de dados do Notion — para coisas que devem ser arquivadas em vez de transmitidas
- Um Google Doc ou Sheet — anexado ou sobrescrito
- Uma issue ou comentário de PR do GitHub — para fluxos de trabalho de engenharia
- Um rascunho do Gmail — preparado na sua conta para você revisar e enviar
- Uma página hospedada — veja Hosted sites
- Um arquivo do espaço de trabalho — quando o artefato é um vídeo, imagem ou ativo baixável
"Post to #engineering" ou "DM me" é mais claro do que "send it somewhere."
Dicas operacionais
Estas vêm de executar automações em produção:
- Observe as três primeiras execuções. Automações são fáceis de configurar; são ainda mais fáceis de refinar quando você vê o que o Okou realmente produz no seu ambiente.
- Mantenha cada tarefa pequena. Automações longas e de várias etapas são mais frágeis. Se uma só precisa atualizar cinco sistemas, considere dividi-la em duas.
- Fixe o destino. Canais são renomeados e pessoas saem. Nomeie o destino explicitamente na instrução do fluxo de trabalho; o Okou avisará se não o encontrar na próxima execução.
- Limite no tempo consultas longas. Se o prompt pede "os últimos 30 dias", repita isso a cada execução para que a janela permaneça atual.
- Confirme o fuso horário. Automações programadas e únicas armazenam um fuso explícito; confira o valor mostrado antes de salvar.
- Pause antes das férias. Especialmente para automações que enviam DMs a você — voltar para 14 DMs curtos não é útil. Desative a automação e reative quando voltar; o fluxo de trabalho permanece intacto.
Custos e volume
Um disparo de automação inicia uma execução normal e pode consumir créditos de acordo com a rota do modelo e os serviços usados. Revise o chat de automação e Billing ao estimar o custo.
Intervalos curtos se multiplicam rápido: um intervalo de 15 minutos pode rodar até 96 vezes por dia se cada execução terminar antes do próximo intervalo. Filtros de evento amplos podem ser igualmente barulhentos. Comece estreito, inspecione os primeiros disparos e então amplie o filtro ou a cadência deliberadamente.
Desative uma automação quando quiser parar novos disparos sem excluir seu fluxo de trabalho ou histórico.
Próximo
- Veja Workflows para o procedimento que uma automação executa.
- Veja Chat para o que acontece dentro de cada execução.
- Veja Example workflows para cinco combinações completas de fluxo de trabalho mais automação.