Adicionar um gatilho de evento

Os gatilhos de eventos permitem que seu agente reaja automaticamente quando um evento ocorre em outros sistemas. Em seguida, você pode definir um fluxo específico de ações para o agente tomar 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 evento 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 secção Triggers.

2. Selecione Adicionar acionador.

3. Selecione o gatilho desejado.

4. Forneça seus detalhes de autenticação, se necessário.

5. Selecione Seguinte.

   Observação

   Só pode autenticar os conectores de acionador usando a conta de criador do agente (autenticação do autor do agente). O criador do agente 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 obter 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, vá para Definir a carga útil do gatilho.

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

Testar um acionador

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

Até publicar o seu agente com um novo acionador, o agente não reage automaticamente ao acionador. Em vez disso, tem de ativar manualmente o agente selecionando um payload de acionador para enviar para o agente.

1. Execute o evento de acionamento 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 uma tarefa de teste a si mesmo no Microsoft Planner para ativar seu gatilho.

2. Selecione o ícone Testar acionador ao lado do acionador na página Descrição geral do agente. A lista inclui todas as ocorrências recentes do evento.

3. Escolha a instância que deseja testar 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 do mapa na parte superior do painel de teste.

Modificar um gatilho

Depois de criar um gatilho, você pode alterar os parâmetros do 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 (...), depois selecione Editar no Power Automate.

3. Selecione o gatilho e, em seguida, vá para as guias 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 e salve suas alterações. Para obter mais informações sobre como fazer alterações no Power Automate, vá para Introdução aos gatilhos no Power Automate.

Publicar um agente com um acionador

Antes de publicar um agente com acionadores de eventos, recebe um aviso sobre o agente a utilizar as credenciais do autor. Os acionadores de eventos só podem utilizar as credenciais do autor do agente para autenticação (ou seja, as credenciais utilizadas para autorizar as ligações). Isso pode permitir que os usuários de um agente sem sua própria autorização acessem dados e sistemas que não deveriam. Para obter mais informações, vá para Práticas recomendadas 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 seu agente na página Atividade .