Gatilhos de agentes
Os gatilhos permitem que os agentes sejam executados automaticamente com base em eventos ou programações. Em vez de iniciar cada execução manualmente, configure um gatilho uma vez e o agente será executado sempre que as condições do gatilho forem atendidas. Atualmente, o August oferece suporte a gatilhos manuais, programados e de upload.
Tipos de gatilho
Os agentes podem ser acionados de três maneiras:
Tipo de gatilho | Quando é executado |
|---|---|
Manual | Quando um usuário clica em 'Executar agora' no painel Agents |
Programação | Em intervalos configurados: a cada hora, diariamente, em dias úteis, semanalmente ou mensalmente |
Upload | Quando arquivos são carregados em pastas monitoradas |
As execuções manuais estão sempre disponíveis. Os gatilhos programados são executados na frequência que você definir. Os gatilhos de upload são executados automaticamente quando novos arquivos aparecem em uma pasta monitorada.
Somente os proprietários do agente podem criar e gerenciar gatilhos. Os colaboradores podem executar um agente manualmente, mas não podem modificar seus gatilhos.
Gerenciando gatilhos
Todos os gatilhos são gerenciados no modal Gatilhos de cada agente:
Abra seu agente
No painel Agents, selecione o agente que deseja automatizar.
Clique em Gatilhos
Abra o modal Gatilhos na página do agente para visualizar e gerenciar todos os tipos de gatilho.
Adicione ou edite gatilhos
Crie novos gatilhos, ative ou desative os existentes ou remova os gatilhos que não são mais necessários.
Cada gatilho exibe seu tipo, configuração e status atual. Ative ou desative os gatilhos sem excluí-los.
Gatilhos programados
Os gatilhos programados executam os agentes em intervalos definidos. Configure a frequência, o horário e o fuso horário para a execução automática.
Configurando um gatilho programado
Adicione um gatilho programado
No modal Gatilhos, crie um novo gatilho e selecione Programação como tipo.
Defina a frequência
Escolha com que frequência o agente deve ser executado: a cada hora, diariamente, em dias úteis, semanalmente ou mensalmente.
Defina o horário
Especifique o horário de início. A programação usa o fuso horário selecionado, exibindo o nome do dia e o horário na sua visualização local.
Ativar
Novos gatilhos programados são ativados por padrão. Desative-os para pausá-los sem perder sua configuração.
Comportamento da programação
Ciente do fuso horário: As programações são executadas no fuso horário selecionado. O gatilho exibe o nome do dia e o horário para facilitar a compreensão.
Ignorar se estiver em execução: Se um agente ainda estiver sendo executado devido a uma execução programada anterior quando o próximo gatilho for acionado, a nova execução será ignorada para evitar o acúmulo de execuções.
Somente gatilhos ativados: Um gatilho programado precisa estar ativado para que o agente seja executado automaticamente.
Escolha a frequência com base no ritmo do caso e nas necessidades das partes interessadas. Valide as primeiras execuções programadas antes de depender da automação.
Gatilhos de upload
Os gatilhos de upload executam os agentes automaticamente quando arquivos são carregados em pastas monitoradas. Isso é útil para o processamento contínuo de documentos — pastas de recebimento, data rooms ou uploads de documentos de clientes.
Configurando um gatilho de upload
Adicione um gatilho de upload
No modal Gatilhos, crie um novo gatilho e selecione Upload como tipo.
Selecione as pastas a serem monitoradas
Escolha as pastas do SharePoint ou OneDrive que deseja monitorar. O nome do gatilho é gerado automaticamente como "Upload para [nome da pasta]".
Salve e ative
Novos gatilhos são ativados por padrão. Desative-os para pausá-los sem excluí-los.
Monitoramento recursivo de pastas
Os gatilhos de upload monitoram a pasta selecionada e todas as subpastas dentro dela. Isso significa:
Arquivos carregados em
/Matters/ABCacionam o gatilho se você configurar/MattersArquivos carregados em
/Matters/ABC/Contractstambém acionam o gatilhoArquivos em qualquer nível de aninhamento abaixo da pasta monitorada acionarão o gatilho
Não é necessário configurar cada subpasta separadamente — a recursão é automática.
Organize sua estrutura de pastas intencionalmente. Se quiser que apenas determinados tipos de documento acionem um agente, coloque-os em uma pasta dedicada em vez de depender de exceções de subpastas.
Processamento em lote
Quando você carrega um arquivo zip contendo vários documentos, o gatilho é acionado uma vez para todo o lote, e não uma vez por arquivo extraído. O agente recebe todos os documentos extraídos como um único lote de entrada.
As execuções acionadas usam somente os arquivos carregados como entrada — elas não os mesclam nem recorrem aos documentos padrão salvos do agente.
Permissões e acesso
Gerenciamento exclusivo do proprietário: Somente os proprietários do agente podem criar, ativar, desativar ou excluir gatilhos de upload.
Requisito de acesso à pasta: O proprietário do agente precisa ter acesso à pasta onde os arquivos são carregados. Se o acesso for revogado, o gatilho não será acionado.
Se um gatilho de upload não estiver sendo acionado conforme esperado, verifique se o proprietário do agente ainda tem acesso à pasta configurada.
Visualizando execuções acionadas
As execuções do agente iniciadas por gatilhos aparecem no Histórico de execuções com o rótulo e o ícone Acionado, distinguindo-as das execuções iniciadas manualmente. Clique em qualquer execução para ver seus detalhes, incluindo:
Qual gatilho foi acionado
Quais entradas o gatilho forneceu
Status da execução etapa a etapa
Saídas finais
Consulte Visão geral dos agentes para obter detalhes das execuções.
Ativando e desativando gatilhos
Cada gatilho tem um controle para ativá-lo/desativá-lo:
Ativado: O gatilho é acionado quando suas condições são atendidas.
Desativado: A configuração é preservada, mas o gatilho não será acionado. Use esta opção para pausar a automação sem perder as configurações.
Gatilhos desativados são úteis durante suspensões de casos, na depuração de agentes ou em alterações temporárias nos processos de recebimento.
Limites de taxa e simultaneidade
Os gatilhos têm limites de taxa para evitar a execução descontrolada de agentes durante eventos em massa:
Enfileiramento: Se muitos gatilhos forem acionados rapidamente, as execuções serão enfileiradas em vez de executadas simultaneamente.
Proteção contra execuções em andamento: Para gatilhos programados, se um agente ainda estiver sendo executado devido a uma execução programada anterior, o novo gatilho será ignorado para evitar execuções sobrepostas.
Isso protege os recursos do sistema e garante um processamento confiável.
Casos de uso comuns
Revisão automatizada de due diligence
Gatilho de upload: direcione um gatilho para a pasta do seu data room. Cada novo upload executa automaticamente seu agente de extração de due diligence, encaminhando os termos principais para sua tabela de revisão.
Triagem de contratos recebidos
Gatilho de upload: monitore uma pasta de recebimento. Novos contratos são analisados automaticamente em busca de disposições importantes e sinalizados para revisão por um advogado.
Atualizações semanais de status
Gatilho programado: configure um agente semanal para resumir os acontecimentos em uma pasta de caso e produzir uma atualização de status para a equipe da transação.
O que ler em seguida
Visão geral dos agentes para criar e executar agentes
Etapas de controle do agente para entrada humana e ramificação condicional
Visão geral do gerenciamento de documentos para organizar arquivos em pastas