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 gatilho de evento ao seu agente:

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

2. Selecione Adicionar gatilho.

3. Selecione o gatilho desejado.

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

5. Selecione Próximo.

   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 gatilho 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 seu próprio conteúdo e instruções. Para obter mais informações, acesse Definir o payload do gatilho.

Para que um agente reaja a um gatilho de evento, ele precisa de ações ou tópicos para serem usados na resposta, assim como de instruções sobre quais devem ser chamados. 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 Microsoft Planner Quando uma nova tarefa for atribuída a mim para Microsoft Planner, atribua uma tarefa de teste a si mesmo em Microsoft Planner para ativar o gatilho.

2. Selecione ícone Testar gatilho ao lado do gatilho na página Visão geral do agente. A lista inclui todas as ocorrê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 à carga útil 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ê pode alterar os parâmetros de evento e a carga útil por meio do Power Automate. Para abrir o gatilho do Copilot Studio:

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

2. Selecione os três pontos (...), em seguida, 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 em Power Automate, acesse Introdução aos 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 fato de o agente usar 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 .