Adicionar gatilhos a um agente (pré-visualização)

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

Use gatilhos para criar agentes autónomos alimentados pelo GitHub Copilot harness. Agentes autónomos executam-se quando ocorre um evento num serviço ligado. Por exemplo, um agente pode responder quando um item é criado no SharePoint, chega um email ou ocorre uma hora agendada.

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

[Este artigo é 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 de que o agente precisa para completar a sua tarefa. Saiba mais em Adicionar uma ferramenta a um agente.
• Escreva instruções para o agente 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.

Adicionar e configurar um acionador

1. Abre o agente no Copilot Studio.

2. Selecione Acionadores.

3. Selecione o gatilho.

4. Configure o gatilho:

   1. Configura a ligação usada para o acionador. Se vires um visto verde, a tua ligação está a funcionar. Se não vires um visto verde, seleciona a conta, depois escolhe outra conta ou cria uma nova conexão.

   Note

   Alguns gatilhos, como Recurrence, Copilot e Teams, não requerem verificação da ligação.

   1. Opcionalmente, adicione instruções extra que queira enviar ao seu agente para este gatilho. Este passo é particularmente importante quando tem múltiplos gatilhos no seu agente e cada um gere 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 trigger é captado.

   3. Se estiver a partilhar este agente com outros para usar, escolha quais as opções que os utilizadores podem ou não configurar, ativando ou desativando Editable by user para cada opção.

   4. Expanda Parâmetros avançados para configurar quaisquer parâmetros avançados de que precise.

5. Selecione Adicionar gatilho.

Testar e publicar o agente

Testa todos os triggers antes de publicares o agente.

1. Teste um acionador selecionando o botão frasco de teste ( ). Para chegar ao botão, uma das seguintes opções:

   • Selecione o acionador no separador Build.
   • Abra o separador Pré-visualização.

2. Proceda de uma das seguintes formas:

   • Selecione Iniciar escuta para o primeiro teste. Gerar um evento que corresponda à configuração do trigger, como enviar um email ou criar um item no SharePoint. O seu agente espera que o evento desencadeador ocorra e reage em resposta a um teste. Com base nos resultados, modifique as instruções, ferramentas, personalização do gatilho ou mensagem do seu agente para corresponder às suas necessidades.
   • Escolha um evento de gatilho anterior (último email, ficheiro, etc.) da lista Test with previous trigger events. Esta ação invoca o agente com esse evento acionador.

Publique e ative um agente autónomo

O agente não funciona de forma autónoma até ser publicado. Republicar o agente depois de alterar um trigger, as suas instruções ou as suas ferramentas. Atualizar um agente pede aos utilizadores que aceitem as novas alterações.

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

2. Depois de publicar, use o diálogo de sucesso para escolher quem pretende que utilize o agente:

   • Ativar para mim: Só tu, o criador, podes usar o agente, usando as tuas próprias credenciais de criador.
   • Partilhe com outros: Permita que outros utilizadores usem o agente, com as suas próprias credenciais. Também tens de partilhar o agente com esses utilizadores.

Ativa por mim

Ativa por mim leva-te à Gestão de Agentes, onde ligas o agente. Depois de ligar o agente, o seu agente começa a executar em seu nome.

Também pode aceder à Gestão de Agentes e ativar o seu agente autónomo a partir do link sob o nome do agente.

Partilhar com outras pessoas

Permita que as pessoas usem um agente autónomo com as suas próprias credenciais, configure os seus gatilhos e ferramentas para autenticação de utilizadores, e depois partilhe o agente publicado. Os destinatários concluem as configurações necessárias e só podem editar as opções de acionador que permitir.

Saiba mais em Partilhar um agente autónomo. Para instruções para utilizadores finais que configuram um agente partilhado, consulte Configurar um agente autónomo partilhado.

Informações relacionadas

• Configurar detalhes e instruções do agente
• Adicionar uma ferramenta a um agente
• Publicar um agente
• Partilhar um agente
• Partilhar agentes com outros utilizadores e criadores