É possível configurar o fluxo de trabalho para ser executado automaticamente quando os dados mudam em um conector.
Os gatilhos de eventos usam a pesquisa para detectar mudanças, como novos e-mails, eventos atualizados na agenda ou novos arquivos em um repositório de dados conectado. Quando uma mudança é detectada, o fluxo de trabalho configurado é executado.
Antes de começar
Antes de usar esse recurso, siga estas etapas:
- Verifique se você tem um app da Web com as fontes de dados necessárias conectadas. Para mais informações, consulte Criar um app, Conectar uma fonte de dados do Google e Conectar uma fonte de dados de terceiros.
- Verifique se um administrador do Gemini Enterprise ativou a opção do Workflow Builder nas configurações de gerenciamento de recursos do app. Para mais informações, consulte Gerenciar recursos do app da Web.
- Verifique se o conector que você quer usar como fonte de acionamento está conectado como um repositório de dados no app do Gemini Enterprise. Para mais informações, consulte Conectar um repositório de dados de terceiros.
Conectores compatíveis
Os seguintes conectores oferecem suporte a gatilhos de eventos:
- Confluence
- Gmail
- Google Agenda
- Google Drive
- Jira Cloud
- OneDrive
- Outlook
- ServiceNow
- SharePoint
- Equipes
Configurar um gatilho de evento
App
- Abra o app da Web do Gemini Enterprise em um navegador.
- No menu de navegação, clique em Agentes.
- Clique em Criar agente.
- Clique em Iniciar manualmente.
- Na página O que deve acionar seu agente?, clique em Evento do app.
- No painel de detalhes, em Evento do app: escolha um app para começar, procure ou pesquise o conector que você quer usar. Clique no nome do conector para selecioná-lo.
- Selecione o evento que aciona o fluxo de trabalho. Os eventos são organizados por categoria.
- Depois de selecionar um evento, o gatilho é adicionado à parte de cima do fluxo de trabalho no criador de fluxos.
- Clique em Adicionar etapa para incluir etapas de fluxo de trabalho que são executadas quando o gatilho é disparado.
Testar um agente com gatilhos de eventos
Antes de ativar o fluxo de trabalho, você pode testar a funcionalidade dele visualizando eventos de acionamento e executando simulações com dados de eventos de amostra.
Visualizar resultados do gatilho de evento
App
- No canvas do fluxo de trabalho, clique no nó do gatilho de evento na parte de cima do fluxo de trabalho.
- No painel de configuração à direita, clique em Visualizar resultados.
- O Gemini Enterprise busca eventos recentes do conector. Cada item mostra o título e o carimbo de data/hora do evento. Os resultados da visualização do Google Agenda são baseados em eventos atualizados recentemente e podem não refletir eventos recentes.
- Clique em um resultado de visualização para conferir os detalhes do evento.
Testar o fluxo de trabalho do agente
App
- Mude para a guia Teste no canvas do fluxo de trabalho.
- Na seção de entrada do gatilho, selecione um evento de amostra na lista de eventos visualizados usando o seletor Selecionar entrada.
- Clique em Iniciar manualmente para executar a simulação do fluxo de trabalho usando os dados de eventos de amostra.
- Quando a execução terminar, expanda o resumo da simulação para inspecionar as saídas e verificar se cada etapa processou a carga útil do gatilho corretamente.
Gerenciar gatilhos de eventos
É possível gerenciar gatilhos de eventos editando a configuração, ativando ou desativando fluxos de trabalho ou excluindo gatilhos.
OBSERVAÇÃO: os eventos podem levar até 10 minutos para aparecer.
- Editar um gatilho de evento:abra o agente no modo de edição, clique no nó do gatilho no canvas e atualize as configurações ou os critérios de filtro no painel de configuração.
- Ativar um gatilho de evento:para ativar o gatilho e começar a pesquisar eventos, ative os fluxos de trabalho. Para mais informações, consulte Ativar ou desativar um fluxo de trabalho.
- Desativar um gatilho de evento:para pausar ou desativar a pesquisa de eventos, desative o fluxo de trabalho.
Limitações e problemas conhecidos
Estes são problemas e limitações conhecidos ao trabalhar com gatilhos de eventos.
- Desvinculação de conector:quando um administrador desvincula um conector do mecanismo ou app, o gatilho de evento é pausado automaticamente. No entanto, nenhuma notificação é enviada ao usuário, e os usuários não podem visualizar agentes pausados na galeria.
- Falha nas novas tentativas de sessão:se uma execução de agente falhar devido a erros na busca de dados de um conector associado em um gatilho de evento, uma sessão será criada com um status de falha. As novas tentativas manuais em sessões com falha não são aceitas no momento.
- Filtros:sempre adicione filtros aos gatilhos de eventos para garantir a execução oportuna do agente nos eventos mais importantes.
- Gatilhos do Gmail
- A inicialização do agente pode ser mais lenta para usuários com um grande volume de e-mails.
- O Gmail oferece suporte a dois gatilhos: Quando um e-mail é enviado e Quando um e-mail é recebido. Se você quiser acionar um agente enviando um e-mail para si mesmo, use Quando um e-mail é enviado. Se você usar Quando um e-mail é recebido, o agente não será acionado.
Para conferir uma lista completa de restrições do sistema, consulte Cotas e limites do Workflow Builder.
A seguir
- Saiba como configurar conectores e ações de nós de agentes.
- Saiba como pesquisar com filtros.
- Saiba como visualizar registros de execução de agentes.
- Saiba como ativar ou desativar um fluxo de trabalho.