Uma automação é um acionador anexado 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, com seu procedimento atual
- Um proprietário, cujos chats de automação e acesso conectado são usados
- Um acionador, como uma agenda, 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. As automações do mesmo membro para o mesmo fluxo de trabalho reutilizam esse chat de automação.
A execução usa a instrução atual do workflow e a carga útil do acionador. Como o chat é reutilizado, execuções anteriores permanecem no histórico da conversa. Se uma tarefa precisar se comportar sem estado, especifique isso na instrução do workflow e diga 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 ou no fluxo de trabalho. Quando o chat de automação é criado pela primeira vez, seu modelo começa com o padrão do membro e depois com o padrão do espaço de trabalho. Disparos posteriores reutilizam o modelo selecionado para aquele thread.
Abra o chat de automação para inspecionar suas execuções, saídas e erros visíveis. Um disparo com falha continua visível ali para que você possa corrigir o workflow, o acesso ao conector ou o acionador e executá-lo novamente.
Referência de acionadores
O seletor de automação em um fluxo de trabalho é a fonte da verdade sobre o que o espaço de trabalho atual pode criar. Alguns tipos de evento são liberados atrás de switches de recurso do espaço de trabalho e, portanto, podem não aparecer em todos os lugares.
Agendas
| Tipo | Comportamento |
|---|---|
| Agendado | Executa em horários de relógio usando uma agenda cron e um fuso horário IANA. |
| Intervalo | Aguarda o intervalo configurado depois que uma execução termina e então agenda a próxima execução. As execuções não se sobrepõem a si mesmas. |
| Uma vez | Executa na data e hora selecionadas e então se desativa. |
Confirme o fuso horário exibido na automação antes de salvar. Use uma automação agendada para horários de relógio e uma automação por intervalo para sondagem, quando o espaçamento após a conclusão importar.
Gmail
| Evento | Filtros |
|---|---|
| Nova mensagem | Correspondências opcionais para De, Para, Cc, Assunto e texto do corpo. Sem correspondências, toda nova mensagem é elegível. |
| Rótulo aplicado | Um nome de rótulo do Gmail. |
Comece com filtros estreitos para novas mensagens para que uma caixa de entrada movimentada não crie um número inesperado de execuções.
GitHub
Os eventos do GitHub exigem que o Okou's GitHub App esteja instalado em sua organização do GitHub. Se não estiver, a tela de configuração da automação informa isso — um admin da organização recebe ali um botão Install GitHub App, e todo o resto é orientado a pedir a um admin. Instale uma vez e cada acionador do GitHub abaixo ficará disponível.
| Evento | Filtros comuns |
|---|---|
| Solicitação de pull request | Um repositório e uma ação: aberta, reaberta, fechada, pronta para revisão, convertida em rascunho, sincronizada, adicionada à fila de merge ou removida dela, rotulada ou com rótulo removido. Restrinja por branch base, autor, número da PR ou rótulo. Para closed, é possível distinguir entre merge concluído e fechamento sem merge. |
| Execução de workflow concluída | Repositório, workflow, conclusão, branch, evento que a acionou e autor da ação. |
| Tarefa de workflow concluída | Repositório, workflow, tarefa, conclusão, branch, rótulo do executor e grupo do executor. |
| Revisão de pull request enviada | Repositório, estado da revisão, branch base, branch de origem e autor confiável. |
| Status de implantação criado | Repositório, ambiente, estado, ref, criador, aplicativo e indicador de ambiente de produção. |
| Comentário criado em issue ou pull request | 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 do calendário que você escolher
- Google Meet transcript generated, para reuniões organizadas pelo membro conectado
Chat e outras integrações
- Chat run finished monitora um dos seus threads de chat. Ele pode filtrar por status completed, failed ou cancelled e, para execuções completed, um
*sem distinção entre maiúsculas e minúsculas correspondido por curinga contra a resposta final. - Webhook received cria uma URL de entrada assinada e fica disponível quando o plano do espaço de trabalho inclui automações por webhook.
- Google Forms response submitted, Notion page/database events, Strapi entry published e Stripe invoice paid aparecem somente em espaços de trabalho em que esses recursos de automação estão habilitados.
As automações de evento também exigem que o conector ou integração relevante esteja conectado e pronto para o proprietário da automação.
As mensagens de automação descrevem o que aconteceu em linguagem simples, e uma execução iniciada por um acionador chat run finished aponta de volta para o thread de origem.
Criando uma automação
A partir de um chat que funciona. Execute a tarefa primeiro como uma vez só. Quando ela produzir o que você quer, diga:
"Execute isso todo dia útil às 8 a.m. no horário de Los Angeles e me envie o resultado por DM."
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, clique em Add automation e escolha o tipo de acionador e seus filtros. Útil quando você já conhece a estrutura com antecedência e não quer uma execução de teste.
O procedimento vem do fluxo de trabalho. Em My Okou, a execução usa as instruções pessoais (Instructions), a memória, as contas conectadas e as permissões do proprietário da automação naquele espaço de trabalho. Em Legacy Agents, o agente proprietário fornece o contexto do agente. Um acionador de agenda pergunta quando executar e em qual fuso horário.
Um fluxo de trabalho público compartilha um método, não as suas automações nem o acesso de quem o criou. Cada membro cria e gerencia suas próprias automações. Não presuma que copiar um fluxo de trabalho transfira os acionadores, credenciais ou o chat de automação de outro membro.
As Automações podem ser ativadas e desativadas individualmente sem excluí-las — a decisão certa antes de férias, ou enquanto você depura um acionador barulhento.
Destinos
Uma automação precisa saber para onde o resultado vai. Especifique isso na instrução do fluxo de trabalho:
- Canal ou DM do Slack — o mais comum; chega no canal como uma mensagem ou thread
- Feishu ou Microsoft Teams — a mesma ideia para equipes que vivem lá
- Telegram ou mensagem de texto — para alertas pessoais, com foco em dispositivos móveis
- Uma página ou banco de dados do Notion — para coisas que devem ser arquivadas em vez de divulgadas
- Um Google Doc ou Sheet — anexado ou sobrescrito
- Um comentário em issue ou PR do GitHub — para fluxos de trabalho de engenharia
- Um rascunho de e-mail no Gmail — preparado em sua conta para você revisar e enviar
- Uma página hospedada — veja Sites hospedados
- Um arquivo do espaço de trabalho — quando o artefato é um vídeo, imagem ou ativo para download
"Publique em #engineering" ou "me envie por DM" é mais claro do que "envie para algum lugar."
Dicas de operação
Estas vêm de executar automações em produção:
- Acompanhe as três primeiras execuções. As automações são fáceis de configurar; ficam 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 com várias etapas são mais frágeis. Se uma única automação tiver de 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 conseguir encontrá-lo na próxima execução.
- Delimite consultas longas por tempo. Se o prompt pedir "os últimos 30 dias", reafirme isso em toda execução para que a janela permaneça atualizada.
- Confirme o fuso horário. Automações agendadas e de uma única vez armazenam um fuso horário explícito; verifique o valor exibido antes de salvar.
- Pause antes das férias. Especialmente para automações que lhe enviam DMs — voltar para 14 DMs curtas não é útil. Desative a automação e reative-a 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 que ele usa. Revise o chat de automação e Billing ao estimar o custo.
Intervalos curtos se multiplicam rapidamente: um intervalo de 15 minutos pode ser executado até 96 vezes em um dia se cada execução terminar antes de o próximo intervalo decorrer. Filtros amplos de eventos podem ser igualmente barulhentos. Comece de forma restrita, inspecione os primeiros disparos e depois amplie o filtro ou a cadência deliberadamente.
Desative uma automação quando quiser interromper novos disparos sem excluir o fluxo de trabalho ou o histórico.
Próximos passos
- Veja Fluxos de trabalho para o procedimento que uma automação executa.
- Veja Chat para o que acontece dentro de cada execução.
- Veja Fluxos de trabalho de exemplo para cinco combinações completas de workflow + automação.
