Adicionar um gatilho de evento

Os gatilhos de evento permitem ao agente reagir automaticamente quando um evento ocorre em outros sistemas. Você pode acabar definindo um fluxo específico de ações para o agente executar em resposta ou dar instruções ao agente sobre como determinar as melhores ações a serem tomadas.

Para obter orientações detalhadas sobre como os gatilhos de eventos funcionam e se relacionam com outros componentes de um agente, vá para Visão geral do gatilho de evento.

Para adicionar um gatinho de evento a seu agente:

1. Na página Visão geral do seu agente, vá para a seção Gatilhos.

2. Selecione Adicionar gatinho.

3. Selecione o gatinho desejado.

4. Dê os detalhes da autenticação, se necessário.

5. Selecione Avançar.

   Observação

   Você só pode autenticar conectores de gatilho usando a conta do criador do agente (autenticação do autor do agente). O criador de agentes só pode definir um gatilho para seu agente com base em eventos em sistemas que você tem permissão para acessar como autor do agente. Para mais informações, consulte as limitações do gatinho de evento.

6. Configure o gatilho conforme necessário e defina os parâmetros de evento que ativam o gatilho e a carga útil do gatilho. Os gatilhos fornecem conteúdo de carga útil padrão, mas você pode adicionar o próprio conteúdo e instruções. Para obter mais informações, acesse Definir o conteúdo do gatilho.

Para que um agente reaja a um gatilho de evento, o agente precisa de ações ou tópicos para chamar na resposta e instruções para quais chamar. Para obter mais informações, consulte Chamar uma ação ou tópico.

Testar um gatilho

Sempre teste um gatilho e a reação antes de publicar. Você pode testar como seu agente reage ao gatilho definido usando o chat de agente de teste.

Até que você publique o agente com um novo gatilho, o agente não reage automaticamente ao gatilho. Em vez disso, você deve ativar manualmente o agente selecionando um payload de gatilho a ser enviado para o agente.

1. Execute o evento de disparo uma vez para gerar um payload. Por exemplo, se estiver usando o gatilho do Microsoft Planner Quando uma nova tarefa for atribuída a mim para o Microsoft Planner, atribua-se uma tarefa de teste no Microsoft Planner para ativar o gatilho.

2. Selecione o ícone de Testar gatilho ao lado do gatilho na página Visão geral do agente. A lista inclui todas as instâncias recentes do evento.

3. Escolha a instância que deseja tesar e selecione Iniciar teste.

Você pode usar o mapa de atividades para ver como seu agente reage ao conteúdo do gatilho durante os testes. Para abrir o mapa de atividades, selecione o ícone de mapa na parte superior do painel de teste.

Modificar um gatilho

Depois de criar um gatilho, você poderá alterar os parâmetros do evento e o payload por meio do Power Automate. Para abrir o gatilho no Copilot Studio:

1. Na página Visão geral, localize o gatilho.

2. Selecione os três pontos (...), depois selecione Editar no Power Automate.

3. Selecione o gatilho e vá para as guia Parâmetros e Código para fazer as alterações. Para obter informações sobre quais variáveis e operadores de cadeia de caracteres você pode adicionar, vá para a guia Sobre.

4. Faça suas alterações e salve. Para obter mais informações sobre como fazer alterações no Power Automate, acesse Começar com gatilhos no Power Automate.

Publicar um agente usando um gatilho

Antes de publicar um agente com gatilhos de evento, você recebe um aviso sobre o agente usando as credenciais do autor. Os gatilhos de evento só podem usar as credenciais de autor do agente para autenticação (ou seja, as credenciais usadas para autorizar as conexões). Isso pode permitir que os usuários de um agente sem sua própria autorização possam acessar dados e sistemas que não deveriam. Para obter mais informações, acesse melhores práticas de proteção de dados para gatilhos.

Depois de publicar um agente com gatilhos de evento, ele reage automaticamente cada vez que os gatilhos do agente são ativados. Você pode ver um registro passo a passo dos gatilhos e reações do agente na página Atividade .