Adicionar gatilhos a um agente (prévia)

[Este artigo é uma documentação de pré-lançamento e está sujeito a alterações.]

Use gatilhos para criar agentes autônomos alimentados pela infraestrutura do GitHub Copilot. Agentes autônomos funcionam quando um evento ocorre em um serviço conectado. Por exemplo, um agente pode responder quando um item é criado no SharePoint, um e-mail chega ou ocorre um horário agendado.

O gatilho envia detalhes do evento para o agente. As instruções e ferramentas do seu agente determinam o que ele faz com esses detalhes.

[Este artigo é uma documentação de pré-lançamento e está sujeito a alterações.]

Antes de adicionar um gatilho

Antes de adicionar um gatilho:

• Adicione as ferramentas que o agente precisa para completar sua tarefa. Saiba mais em Adicionar uma ferramenta a um agente.
• Escreva instruções para agentes que digam ao agente como lidar com os detalhes do evento e quando usar cada ferramenta. Saiba mais em Configurar detalhes e instruções do agente.

Adicione e configure um gatilho

1. Abra o agente no Copilot Studio.

2. Selecione Gatilhos.

3. Selecione o gatilho.

4. Configure o gatilho:

   1. Configure a conexão usada para o gatilho. Se você vir uma marca de seleção verde, sua conexão está funcionando. Se não vir uma marca de seleção verde, selecione a conta, depois escolha outra conta ou crie uma nova conexão.

   Note

   Alguns gatilhos, como gatilhos de Recurrence, Copilot e Teams, não exigem verificação de conexão.

   1. Opcionalmente, adicione instruções extras que você queira enviar ao seu agente para esse gatilho. Essa etapa é especialmente importante quando você tem múltiplos gatilhos no seu agente e cada gatilho conduz a execução do agente de forma diferente.

   2. Configure as opções de Trigger que determinam quando o agente deve ser invocado quando o evento de gatilho for captado.

   3. Se você estiver compartilhando esse agente com outras pessoas para usar, escolha quais opções os usuários podem ou não configurar, ativando ou desativando Editável pelo usuário para cada opção.

   4. Expanda os parâmetros avançados para configurar quaisquer parâmetros avançados que você precisar.

5. Selecione Adicionar gatilho.

Teste e publique o agente

Teste todos os gatilhos antes de publicar o agente.

1. Teste um gatilho selecionando o botão ícone de teste ( ). Para chegar ao botão, faça um dos seguintes:

   • Selecione o gatilho na aba Build .
   • Abra a aba Visualização.

2. Siga um destes procedimentos:

   • Selecione Começar a ouvir para o primeiro teste. Gerar um evento que corresponda à configuração do gatilho, como enviar um e-mail ou criar um item no SharePoint. Seu agente espera que o evento de acionamento ocorra e reage em caráter de teste. Com base nos resultados, modifique as instruções, ferramentas, personalização do gatilho ou mensagem do seu agente para atender às suas necessidades.
   • Escolha um evento de gatilho anterior (último e-mail, arquivo etc.) na lista Teste com eventos de gatilho anteriores. Essa ação invoca o agente com esse evento de gatilho.

Publique e ative um agente autônomo

O agente não é executado autonomamente até você publicá-lo. Republique o agente depois de alterar um gatilho, suas instruções ou suas ferramentas. A atualização de um agente solicita que os usuários aceitem as novas mudanças.

1. Selecione Publicar para atualizar a versão mais recente do agente com o gatilho.

2. Após a publicação, use o diálogo de sucesso para escolher com quem você quer usar o agente:

   • Ativar para mim mesmo: Só você, o criador, pode usar o agente, usando suas próprias credenciais de criador.
   • Compartilhe com outros: Permita que outros usuários usem o agente, com suas próprias credenciais. Você também precisa compartilhar o agente com esses usuários.

Ative para mim

Ativar para mim te leva ao gerenciamento de agentes, onde você ativa o agente. Depois que você liga o agente, ele começa a agir em seu nome.

Você também pode acessar o gerenciamento de agentes e ativar seu agente autônomo pelo link sob o nome do agente.

Compartilhe com outras pessoas

Permita que as pessoas usem um agente autônomo com suas próprias credenciais, configure seus gatilhos e ferramentas para autenticação de usuários e depois compartilhe o agente publicado. Os destinatários completam todas as conexões necessárias e podem editar apenas as opções de gatilho que você permite.

Saiba mais em Compartilhar um agente autônomo. Para instruções para usuários finais configurando um agente compartilhado, consulte Configurar um agente autônomo compartilhado.

Informações relacionadas

• Configurar detalhes e instruções do agente
• Adicione uma ferramenta a um agente
• Publicar um agente
• Compartilhar agente
• Compartilhar agentes com outros usuários e criadores