O trigger Studio Workspace Events executa um workflow quando algo acontece no seu workspace: a execução de outro workflow falha ou é concluída, um workflow é deployado, ou uma condição de alerta é atingida — como um pico de latência ou um limite de custo. Use-o para criar workflows de efeito colateral — alertas, escalonamento, correção automática — montados com qualquer block (Slack, e-mail, webhooks, lógica personalizada).
Eventos
Escolha um evento por block de trigger Studio Workspace Events:
Eventos simples — disparam em toda ocorrência:
- Run Error: a execução de um workflow monitorado falhou
- Run Success: a execução de um workflow monitorado foi concluída com sucesso
- Workflow Deployed: um workflow monitorado foi deployado (incluindo redeploys e rollbacks de versão)
- Workflow Undeployed: um workflow monitorado saiu do ar
Condições de alerta — avaliadas conforme as execuções terminam (condições baseadas em falha são avaliadas em execuções que falharam), com um período de espera para que disparem no máximo uma vez por janela:
- Consecutive Failures: as últimas N execuções falharam
- Failure Rate: a taxa de falha atinge ou passa de uma porcentagem em uma janela de tempo (mínimo de 5 execuções)
- Latency Threshold: uma execução levou mais tempo que uma duração fixa
- Latency Spike: uma execução foi uma porcentagem configurável mais lenta que a média recente (mínimo de 5 execuções)
- Cost Threshold: uma execução custou mais que um limite de créditos
- Error Count: N ou mais erros ocorreram em uma janela de tempo
- No Activity: um workflow monitorado não teve execuções por um número configurável de horas
Escopo de workflows
Por padrão, o trigger monitora todos os workflows do workspace. Selecione workflows específicos para restringir o escopo. O workflow que contém o trigger é sempre excluído — ele nunca recebe eventos sobre si mesmo.
Saídas
Todos os eventos incluem event, timestamp, workflowId e workflowName (o workflow de origem). Os campos adicionais dependem do tipo de evento:
- runId: a execução que terminou
- durationMs: duração da execução em milissegundos
- cost: custo da execução em créditos
- finalOutput: a saída final da execução (truncada quando muito grande)
Condições baseadas em execução aninham a execução que as acionou em triggeringRun:
- triggeringRun.runId, triggeringRun.durationMs, triggeringRun.cost, triggeringRun.finalOutput
No Activity não tem execução acionadora, então carrega apenas os campos básicos.
- version: o número da versão de deploy que foi ativada
Workflow Undeployed carrega apenas os campos básicos.
Comportamento
- O workflow que contém o trigger Studio Workspace Events precisa estar deployado para que os eventos disparem.
- Execuções iniciadas por um trigger Studio Workspace Events nunca emitem eventos de workspace, então workflows de efeito colateral não podem se encadear nem entrar em loop.
- Condições de alerta disparam no máximo uma vez por janela de espera (uma hora, ou a janela de inatividade no caso de No Activity).
- A entrega de eventos é do tipo dispare-e-esqueça: execuções de efeito colateral são cobradas como qualquer outra execução e estão sujeitas aos limites de taxa do workspace.
A configuração do trigger é capturada no momento do deploy. Depois de alterar o tipo de evento, o escopo de workflows ou os limites, faça o redeploy do workflow para as mudanças valerem.