Visão geral do gatilho de evento

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

Como funcionam os gatilhos de eventos

Os acionadores de eventos exigem um evento escolhido que gera um payload de acionador e envia-o para o agente através de um conector. A carga útil contém informações sobre o evento, incluindo variáveis para tipos específicos de dados. Quando o agente recebe o payload, este executa as instruções fornecidas pelo autor do agente nas instruções do agente e as instruções enviadas através do payload do acionador.

Os agentes só agem com base no design e nas instruções do 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 eventos incluem:

• Quando um item é criado no SharePoint
• Quando um ficheiro é criado no OneDrive
• Quando uma tarefa é concluída no Planner
• Uma quantidade definida de tempo decorrido (um acionador de Periodicidade )

Cobrança e utilização de ativadores de eventos

A atividade de acionador de evento conta para o cálculo das unidades de consumo para a utilização e faturação. Uma mensagem é definida como qualquer solicitação ou mensagem enviada ao agente que dispara uma ação ou uma resposta do agente. Isso inclui os payloads enviados aos agentes a partir de acionadores de eventos. Por exemplo, um acionador de evento definido para ser ativado a cada 10 minutos envia uma payload de acionador como uma mensagem para um agente a cada 10 minutos.

Para obter mais informações, vá para Taxas e gerenciamento de faturamento.

O fluxo de trabalho do acionador

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 uma carga 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 na carga útil.

Encontre o gatilho que se adapta ao seu evento

O Copilot Studio tem uma biblioteca de gatilhos para uma variedade de eventos que podem ocorrer na Microsoft e em serviços de parceiros. A configuração do gatilho determina os parâmetros do evento que inicia o gatilho. Também determina o conteúdo do payload do acionador.

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 o payload do acionador

A carga útil do gatilho é uma mensagem JSON ou de texto simples que contém informações sobre um evento e é enviada ao seu 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. Mais tarde, você pode modificar o conteúdo da carga útil, incluindo a adição de variáveis e operadores de cadeia de caracteres, no 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 o payload, dispõe do conteúdo da linha e das instruções para utilizar esse conteúdo.

Pode adicionar as instruções a enviar para o seu agente dentro do payload que encaminha o agente sobre como agir quando ativado pelo acionador. Se tiveres vários acionadores, cada payload do acionador pode ter instruções específicas e detalhadas. Como resultado, você pode evitar 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, no payload do acionador Quando uma linha é adicionada, modificada ou eliminada, pode adicionar Enviar um resumo das alterações no chat. Quando o agente recebe o payload, resume as alterações para o utilizador no chat do agente.

No entanto, evite escrever instruções de carga útil 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 que envolvem gatilhos de eventos.

Depois de criar um gatilho, pode adicionar ou alterar operadores de cadeia ou variáveis numa carga útil de gatilho e modificar as instruções da carga útil existente usando o Power Automate.

Instruções do agente versus instruções de carga útil

As instruções de payload são específicas sobre como reagir a um evento. Também pode utilizar as instruções do agente para encaminhar o seu agente sobre como processar as informações de um acionador e como agir quando ele recebe um payload de acionador, bem como para determinar o comportamento geral do agente. Por exemplo, para um agente que verifica nomes de conta duplicados em novas linhas da tabela Dataverse, as instruções podem ser: Quando uma nova linha é adicionada, verifique se é uma conta duplicada. Se houver uma duplicata, crie uma tarefa Tarefa a Fazer 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 seu agente tiver vários acionadores ou objetivos complexos, deverá utilizar as instruções no payload do acionador em vez disso.

Continuando o último exemplo, pode-se adicionar uma instrução na carga útil do gatilho para procurar nomes de contas duplicados na mesma tabela Dataverse. Quando o agente recebe a carga útil, é instruído a procurar nomes de contas duplicados. As instruções gerais do agente dizem: Se existir um duplicado, crie uma Tarefa para investigar e inclua detalhes sobre as alterações e osduplicados.

Criar instruções para agentes exige prática. Aceda ao guia de escrita para obter mais dicas e teste sempre todas as alterações que fizer ao seu agente.

Iniciar uma ação ou propor um tópico

Quando um agente recebe um payload do acionador, as instruções que lhe fornece determinam, com base nas informações disponíveis, a ação ou o tópico que chama como resposta.

O seu agente não cria uma nova ação ou tópico de imediato. 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, vá para Como funciona a orquestração generativa?

Se o seu agente não estiver reagindo como esperado, você poderá usar o mapa de atividades 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 payload do acionador ou nas instruções do agente. Seu agente pode precisar de mais orientação, como quais informações usar em um campo de entrada específico para ação.
• Incluir instruções no payload do acionador.
• Instruir o seu agente a executar uma ação ou abordar um tópico específico.
• Verificar as instruções em conflito entre as instruções do payload do acionador e as instruções do agente.
• Adicionar detalhes às descrições das ações, para que o agente tenha mais informações para determinar quando o chamar.
• 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 pode definir o valor.
• Chamar 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 executá-los de forma confiável.

Se o seu agente ainda estiver com dificuldades em chamar a ação esperada, considere adicionar um Fluxo do Power Automate que cumpra o seu objetivo como uma ação para o seu agente.

Publicar agentes de acionadores de eventos

Antes de publicar o seu agente com um novo acionador de evento, o agente não reage automaticamente a esse acionador. 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 acionadores de eventos só podem utilizar as credenciais do criador do agente para autenticação (ou seja, as credenciais utilizadas para autorizar as ligações) para o seu acionador. 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ção de problemas e limitações.

Ações de autenticação após a publicação

Se o seu agente não tiver autenticação para efetuar uma ação ou estiver configurado para pedir a autenticação de utilizador, enviará uma mensagem para o utilizador a pedir-lhe as credenciais. Se o fluxo de um agente for interrompido porque não consegue receber informações ou porque uma ação falhou, não pode continuar a sessão. Se pretender que o seu agente seja executado de forma autónoma, cada ação tem de ser configurada com autenticação de criador funcional que não exija a entrada de utilizador. Também pode instruir o seu agente a não pedir credenciais de utilizadores.

Uma vez que os acionadores usam a autenticação de criador, esteja ciente de que dados os utilizadores potenciais podem aceder através de um agente publicado que tenha acionadores. Consulte a secção Proteção de dados com acionadores para obter mais informações.

Solução de problemas e limitações

Limitações de quota

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 de carga de trabalho, e o seu serviço pode ser restringido.

Os administradores podem monitorizar a utilização de recursos através da Power Platform. Eles também podem bloquear o uso de gatilhos de eventos em um ambiente.

Para evitar exceder os limites das quotas:

• Tenha 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.

Proteção de dados para agentes com gatilhos

Atualmente, os acionadores de eventos apenas podem utilizar as credenciais do autor do agente para autenticação. Além disso, para que o agente seja executado de forma automática, todos os gatilhos e ações que exigem autenticação devem usar as credenciais do criador.

Se você publicar 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. Se os criadores configurarem um agente com um gatilho de evento autenticado, eles serão lembrados dessa limitação antes de publicarem o agente.

Os paylods de acionador podem potencialmente conter informações confidenciais que um agente pode disponibilizar noutras localizações através de ações. Por exemplo, se você criou um agente que usa informações de e-mails recebidos para preencher novas linhas em tabelas do Dataverse.

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

Melhores práticas de proteção de dados

Para ajudar a impedir que os utilizadores acedam a dados confidenciais:

• Avalie se e como os dados e sistemas que exigem autenticação são usados por agentes com gatilhos de eventos.
• Compreenda que informações os acionadores podem incluir nos respetivos payloads e que informações geram as ações utilizando estas entradas de payload através de testes.
• Restrinja o escopo do que ativa um gatilho usando os parâmetros de gatilho e forneça instruções ao seu agente sobre como lidar com dados de carga útil.

O compartilhamento de fluxo de nuvem com reconhecimento de solução deve ser ativado

Os criadores só podem adicionar gatilhos de eventos aos agentes em ambientes onde o compartilhamento de fluxo de nuvem com reconhecimento de solução está ativado.

Se você não puder adicionar gatilhos e as políticas de dados da sua organização permitirem gatilhos, seu ambiente poderá ter essa opção desativada. Entre em contato com o administrador do seu ambiente para ativar o compartilhamento de nuvem com reconhecimento de solução.

Resolver problemas do conector

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