É possível configurar o fluxo de trabalho para ser executado automaticamente quando os dados mudarem em um conector.
Os gatilhos de evento usam sondagem para detectar mudanças, como novos e-mails, eventos de agenda atualizados 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.
- Confirme se um administrador do Gemini Enterprise ativou o recurso 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 acionador 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 são compatíveis com 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 Qual é o gatilho do 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 acionador é adicionado à parte de cima do fluxo de trabalho no criador de fluxos.
- Clique em Adicionar etapa para incluir etapas do fluxo de trabalho que são executadas quando o gatilho é acionado.
Testar um agente com gatilhos de evento
Antes de ativar o fluxo de trabalho, teste a funcionalidade dele visualizando os eventos de acionamento e executando simulações com dados de eventos de amostra.
Visualizar os resultados do acionador de eventos
App
- Na tela do fluxo de trabalho, clique no nó do acionador de eventos na parte de cima do fluxo.
- 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 prévia 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 ver os detalhes do evento.
Testar o fluxo de trabalho do agente
App
- Mude para a guia Teste na tela do fluxo de trabalho.
- Na seção de entrada do gatilho, selecione um evento de amostra na lista de eventos pré-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, abra o resumo da simulação para inspecionar as saídas e verificar se cada etapa processou o payload 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: pode levar até 10 minutos para os eventos aparecerem.
- Editar um gatilho de evento: abra o agente no modo de edição, clique no nó do gatilho na tela e atualize as configurações ou os critérios de filtro no painel de configuração.
- Ativar um acionador de evento: para ativar o acionador 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 sondagem 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 do 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 ver os agentes pausados na galeria.
- Novas tentativas de sessão com falha: se a execução de um agente falhar devido a erros ao buscar dados de um conector associado em um gatilho de evento, uma sessão será criada com o status de falha. No momento, não é possível repetir manualmente as sessões com falha.
- Filtros: sempre adicione filtros aos gatilhos de eventos para garantir a execução oportuna do agente nos eventos mais importantes.
- Acionadores do Gmail:
- A inicialização do agente pode ser mais lenta para usuários com um grande volume de e-mails.
- O Gmail é compatível com 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, use Quando um e-mail é enviado. Se você usar Quando um e-mail é recebido, isso não aciona o agente.
Para 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 agente.
- Saiba como pesquisar com filtros.
- Saiba como ver os registros de execução do agente.
- Saiba como ativar ou desativar um fluxo de trabalho.