Visão geral do gatilho de evento (versão preliminar)

Você pode configurar agentes personalizados para executar ações ou chamar tópicos em resposta a algo que está acontecendo usando gatilhos de evento. Ao contrário dos gatilhos de tópico, que exigem entrada de um usuário, os gatilhos de evento permitem que o agente aja de forma autônoma em resposta ao evento definido que está ocorrendo.

Importante

O uso de gatilhos de evento é uma versão prévia do recurso. O uso de gatilhos de eventos é gratuito para participantes da versão preliminar, mas requer mensagens que contam para suas cotas de uso. A versão preliminar dos recursos não foi criada para uso em ambientes de produção e pode ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e forneçam comentários.

Observação

Esse recurso só está disponível para agentes com orquestração generativa habilitada .

Como os gatilhos de evento funcionam

Os gatilhos de evento exigem um evento escolhido que gera uma carga de gatilho e a envia para o agente por meio de um conector. A carga contém informações sobre o evento, incluindo variáveis para tipos específicos de dados. Quando o agente recebe o conteúdo, ele executa as instruções fornecidas pelo autor do agente nas instruções do agente enviadas através do conteúdo do gatilho.

Os agentes só agem com base no design e nas instruções de seu autor. Por exemplo, você pode adicionar um gatilho para quando um novo membro da equipe for adicionado e designar a resposta como a ação enviar ao novo funcionário uma mensagem de boas-vindas com recursos de integração.

Os gatilhos de eventos são ativados com base em eventos externos ao agente. Eles são diferentes dos gatilhos de tópico, que são usados para ativar tópicos ou ações com base em frases de gatilho inseridas pelos usuários.

Este artigo explica como os gatilhos de eventos funcionam, suas limitações e estratégias de solução de problemas. Para obter mais informações sobre como adicionar um gatilho de evento, consulte Adicionar um gatilho de evento.

Outros exemplos de gatilhos de evento incluem:

• Quando um item é criado no SharePoint
• Quando um arquivo é criado no OneDrive
• Quando uma tarefa é concluída no Planner
• Um determinado período de tempo passado (um gatilho de recorrência )

Importante

Os gatilhos disponíveis dependem das políticas de prevenção contra perda de dados dasua organização, configuradas Power Automate por um administrador.

O fluxo de trabalho do gatilho

Um gatilho é uma parte de um fluxo de trabalho que contém várias partes:

1. Um gatilho de evento registra que um evento específico ocorreu.
2. O gatilho envia um conteúdo contendo informações sobre o evento e instruções.
3. O agente tem instruções para escolher uma ou mais ações ou tópicos com base no conteúdo.

Encontre o gatilho adequado ao seu evento

Copilot Studio Tem uma biblioteca de gatilhos para uma série de eventos que podem ocorrer em Microsoft e Serviços de parceiros. A configuração do gatilho determina os parâmetros do evento que inicia o gatilho. Ele também determina o conteúdo da carga útil do gatilho.

A maioria dos gatilhos permite especificar parâmetros sobre o evento que ativa o gatilho. Por exemplo, no gatilho Quando uma linha é adicionada, modificada ou excluída para Dataverse, você seleciona quais alterações da tabela ativam o gatilho.

Definir a carga útil do gatilho

A carga do gatilho é uma mensagem de texto JSON ou sem formatação que contém informações sobre um evento. A carga é enviada para o agente como uma mensagem. Ao adicionar um gatilho, você pode manter o conteúdo de carga padrão para esse gatilho ou adicionar suas próprias instruções. Posteriormente, você pode modificar o conteúdo da carga útil, incluindo a adição de variáveis e operadores de cadeia de caracteres, em Power Automate.

Por exemplo, a mensagem padrão no gatilho Quando uma linha é adicionada, modificada ou excluída é Usar conteúdo de Body. Quando o agente recebe a carga, ele tem o conteúdo da linha e instruções para usar esse conteúdo.

Você pode adicionar instruções para enviar para seu agente dentro da carga útil que direcionam o agente sobre como agir quando ativado pelo gatilho. Se você tiver vários gatilhos, cada carga útil do gatilho pode ter instruções específicas e detalhadas, sem que você precise escrever orientações longas e complicadas nas instruções gerais do agente ou confundir o agente sobre quais instruções se aplicam a qual gatilho.

Por exemplo, em conteúdo do gatilho Quando uma linha é adicionada, modificada ou excluída, você pode adicionar Enviar um resumo das alterações no chat. Quando o agente recebe o conteúdo, ele resume as alterações para o usuário no chat do agente.

No entanto, evite escrever instruções do conteúdo que entrem em conflito com as instruções gerais do agente. Conflitos nas instruções podem causar um erro ou resultados inesperados. Certifique-se de testar todas as alterações envolvendo gatilhos de eventos.

Depois de criar um gatilho, você pode adicionar ou alterar variáveis ou operadores de cadeia de caracteres em uma carga útil de gatilho e modificar as instruções Power Automate de carga existentes.

Instruções agente contra instruções de conteúdo

As instruções de carga útil são específicas sobre como reagir a um evento. Você também pode usar as instruções agente para direcionar seu agente em como lidar com informações de um gatilho e como agir quando ele recebe uma carga útil de gatilho, bem como para determinar o comportamento geral do seu agente. Por exemplo, para um agente que verifica nomes de contas duplicados em novas Dataverse linhas de tabela, as instruções podem ser: Quando uma nova linha for adicionada, verifique se é uma conta duplicada. Se houver uma duplicata, crie uma tarefa Tarefas Pendentes para investigar e inclua detalhes sobre as alterações e duplicatas.

No entanto, as instruções do agente podem não funcionar melhor para todas as situações. Se o agente tiver vários gatilhos ou várias metas complexas, você deverá usar as instruções no conteúdo do gatilho.

Continuando o último exemplo, você pode adicionar uma instrução na carga do gatilho para Procurar nomes de conta duplicados na mesma Dataverse tabela. Quando o agente recebe a carga, ele é instruído a procurar nomes de conta duplicados. As instruções gerais do agente dizem: Se houver uma duplicata, crie uma tarefa Para Fazer para investigar e inclua detalhes sobre as alterações e duplicatas.

A criação de instruções para os agentes exige prática. Vá para Orientações de escrita para obter mais dicas e sempre teste todas as alterações feitas em seu agente.

Chamar uma ação ou tópico

Quando um agente recebe uma carga de gatilho, as instruções que você deu a ele determinam a ação ou o tópico que ele chama em resposta. Suas instruções permitem que o agente selecione uma ação ou tópico com base nas informações disponíveis.

Seu agente não cria uma nova ação ou tópico imediatamente. Como autor do agente, você precisa definir as ações ou tópicos que ele pode selecionar. Para saber como seu agente determina qual ação ou tópico chamar, acesse Como funciona o modo generativo?

Se o seu agente não estiver reagindo conforme o esperado, você poderá usar o mapa de atividade para ver se está faltando alguma informação de entrada importante.

Algumas melhorias que você pode fazer nas instruções incluem:

• Adicionar instruções mais detalhadas no conteúdo do gatilho ou instruções do agente. Seu agente pode precisar de mais direção, como quais informações usar em um campo de entrada específico para ação.
• Incluindo instruções no conteúdo do gatilho.
• Instruir seu agente a chamar uma ação ou tópico específico.
• Verificação de instruções conflitantes entre o conteúdo do gatilho e as instruções do agente.
• Adicionando às descrições das ações, para que o agente tenha mais informações para determinar quando chamá-lo.
• Adicionar descrições aos campos de entrada de ação para ajudar o agente a preencher os parâmetros corretamente. Se as entradas de uma ação forem sempre as mesmas, você mesmo poderá definir o valor.
• Chamando menos de 15 ações ou tópicos consecutivamente. Agentes complexos que executam muitas ações ou tópicos como uma única sequência podem ter dificuldades para gerenciar sua execução de forma confiável.

Se o seu agente ainda tiver dificuldades para chamar a ação esperada, considere adicionar um Power Automate fluxo que cumpra sua meta como uma ação para o seu agente.

Publicando agentes com gatilhos de eventos

Antes de publicar seu agente com um novo gatilho de evento, o agente não reage automaticamente a esse gatilho. Certifique-se de testar o agente completamente antes da publicação, porque depois de publicar um agente com um novo gatilho, o agente reage automaticamente cada vez que seus gatilhos são ativados. Você pode ver um registro passo a passo dos gatilhos e reações do seu agente na página Atividade.

Para obter informações sobre como ativar gatilhos durante o teste, vá para Testar um gatilho.

Os gatilhos de evento só podem usar as credenciais do autor do agente para autenticação (ou seja, as credenciais usadas para autorizar as conexões) para o gatilho. Isso pode permitir que os usuários de um agente usem o agente para acessar dados e sistemas usando essa mesma autorização. Para obter mais informações, vá para Soluções de problema e limitações.

Autenticando ações após a publicação

Se o agente não tiver autenticação para executar uma ação ou estiver configurado para solicitar autenticação do usuário, ele enviará uma mensagem ao usuário solicitando credenciais. Se o fluxo de um agente for interrompido porque ele não pode receber informações ou uma ação falhou, ele não poderá continuar a sessão. Se você quiser que seu agente seja executado de forma autônoma, cada ação deverá ser configurada com autenticação funcional que não exija entrada do usuário. Você também pode instruir seu agente a não solicitar credenciais dos usuários.

Os agentes podem não conseguir executar todos os conectores com êxito. Se um agente falhar repetidamente ao chamar um conector, considere a criação de uma Power Automate ação de fluxo que use o conector problemático para concluir a ação.

Solução de problemas e limitações

Limitações de cota

Se os gatilhos forem ativados com muita frequência, seu agente pode acabar usando mais recursos do que o esperado. Seu agente pode então exceder os limites de cota da carga de serviço e seu serviço pode ser limitado.

Os administradores podem monitorar o uso de recursos por meio de Power Platform. Eles também podem bloquear o uso de gatilhos de eventos em um ambiente.

Para evitar exceder os limites das quotas:

• Tome cuidado ao adicionar gatilhos muito frequentes, ou gatilhos que se repetem indefinidamente. Por exemplo, um gatilho de recorrência é ativado sempre que um determinado período de tempo passa. Quanto menor o tempo entre as ativações, mais recursos o gatilho usa.
• Acompanhe quantos gatilhos estão ativos em um ambiente.

Os gatilhos podem usar apenas credenciais de criador

Atualmente, os gatilhos de eventos podem usar apenas as credenciais do autor do agente para autenticação. Se você publicar ou compartilhar um agente com gatilhos de eventos autenticados, os usuários poderão acessar informações ou solicitar que o agente execute ações usando as credenciais do autor.

Para impedir que os usuários acessem ou modifiquem dados ou sistemas protegidos, considere cuidadosamente se e como os dados e sistemas que exigem autenticação são usados por agentes com gatilhos de eventos. Os autores devem estar atentos ao compartilhar ou publicar agentes que contenham gatilhos de eventos.

Os administradores também podem impedir Copilot Studio que os usuários usem gatilhos de eventos com seus agentes. Para obter mais informações , acesse Bloquear gatilhos de eventos.

Limitações do uso de fontes de conhecimento com gatilhos de eventos

Os agentes não podem fazer referência a algumas fontes de conhecimento em resposta a um gatilho de evento. Algumas fontes de conhecimento exigem um agente para fornecer autenticação ao acesso, mas os agentes não podem fornecer essa autenticação de forma autônoma.

Evite estas fontes de conhecimento, quando referenciadas em resposta a um gatilho de evento:

• SharePoint
• Dataverse
• Conectores de Grafo
• Prompts do AI Builder

Em vez disso, faça referência a essas fontes de conhecimento em resposta a um gatilho de evento:

• Sites públicos
• Arquivos carregados
• Dados empresariais, usando conectores