Estender a extensão de mensagem baseada em bot como agente para o Microsoft 365 Copilot

Antes de começar, certifique-se de instalar as seguintes ferramentas para criar e implantar sua extensão de mensagem:

• Instale a versão mais recente de pré-lançamento do Kit de Ferramentas de Agentes.
• Certifique-se de que o sinalizador do recurso Desenvolver Plug-in do Copilot esteja habilitado. Para habilitar o sinalizador de recurso, siga estas etapas:
  1. Abra o Visual Studio Code.
  2. Vá para Gerenciar>Configurações.
  3. Insira Microsoft 365 Agents Toolkit na caixa de pesquisa Configurações de pesquisa.
  4. Em Extensões, marque a caixa de seleção Fx-extension: Desenvolver plug-in do Copilot .

Para criar um agente de extensão de mensagem de pesquisa baseado em bot usando o Visual Studio Code, siga estas etapas:

1. Abra o Visual Studio Code.

2. No painel esquerdo, selecione Microsoft 365 Agents Toolkit.

3. Selecione Criar um novo agente/aplicativo.

4. Selecione a Extensão de Mensagem.

5. Selecione os resultados da pesquisa personalizados.

6. Selecione Iniciar com um Bot.

   

7. Selecione uma linguagem de programação.

8. Selecione a pasta padrão.

9. Insira o nome do seu aplicativo e selecione Enter. O Agents Toolkit cria um scaffolds em seu aplicativo e cria uma extensão de mensagem.

Para executar sua extensão de mensagem no Teams, siga estas etapas:

1. No painel esquerdo, selecione Microsoft 365 Agents Toolkit.

2. Em CONTAS, execute as seguintes etapas:

   1. Selecione Entrar no Microsoft 365 e insira suas credenciais do Microsoft 365.

   2. Selecione Entrar no Azure e insira suas credenciais do Azure.

      

3. No painel esquerdo, selecione Executar e Depurar (Ctrl+Shift+D).

4. Selecione Depurar no Teams (Edge) ou Depurar no Teams (Chrome). O Agents Toolkit inicia seu aplicativo no Teams usando um navegador da Web.

5. Selecione Adicionar. O aplicativo está instalado no Teams.

6. Vá para um chat e selecione Ações e aplicativos.

7. No menu suspenso da extensão de mensagem, insira o nome da extensão de mensagem na caixa de pesquisa.

8. Selecione sua extensão de mensagem e insira sua consulta de pesquisa.

9. Selecione um produto na lista. O Teams desenrola o produto como um Cartão Adaptável na área de redação de mensagem.

10. Selecione Enviar.

Disparar extensão de mensagem no Microsoft 365 Copilot

Para disparar a extensão de mensagem como agente no Microsoft 365 Copilot no Teams, siga estas etapas:

1. Selecione Aplicativos.

2. Pesquise Copilot e abra o Microsoft 365 Copilot.

3. Selecione Painel no canto superior direito.

4. Selecione o agente necessário no painel direito.

   

5. Na área de redação de mensagem, envie uma mensagem para o Microsoft 365 Copilot para procurar a atualização mais recente do Teams e do Microsoft 365 Copilot.

   

Antes de começar, certifique-se de instalar as seguintes ferramentas para criar e implantar sua extensão de mensagem:

• Instale o Visual Studio Enterprise 2022 Preview versão 17.9.0 Preview 1.0 ou posterior e instale as ferramentas de desenvolvimento do Microsoft Teams em ASP.NET e carga de trabalho de desenvolvimento na Web.
• Verifique se o sinalizador de recurso do Copilot está habilitado. Para habilitar o sinalizador de recurso, siga estas etapas:
  1. Abra o Visual Studio.
  2. Vá paraOpções de ferramentas>.
  3. Insira Microsoft 365 Agents Toolkit na caixa de pesquisa Configurações de pesquisa.
  4. Na seção Visualizar Recursos , marque a caixa de seleção Microsoft 365 Agents Toolkit: Desenvolver plug-in do Copilot .
• Verifique se o perfil de inicialização de vários projetos está habilitado. Para habilitar o perfil, siga estas etapas:
  1. Abra o Visual Studio.
  2. Vá paraOpções de ferramentas>.
  3. Na seção Recursos de visualização , marque a caixa de seleção Habilitar perfis de inicialização de vários projetos.

Para criar um agente de extensão de mensagem de pesquisa baseado em bot usando Visual Studio, siga estas etapas:

1. Abra o Visual Studio.

2. Vá para Arquivo>Novo>Projeto... ou Criar um novo Projeto.

3. Pesquise por Teams e selecione o aplicativo Microsoft Teams.

4. Insira os detalhes do projeto. Verifique se a caixa de seleção Colocar solução e projeto no mesmo diretório não está selecionada.

5. Selecione Criar.

6. Selecione os resultados da pesquisa personalizados.

   

7. Selecione Criar. O projeto é andaime.

8. No menu suspenso depurar, selecione Dev Tunnels>Criar um túnel.

   
   

   1. Selecione a conta para criar o túnel. Azure, Conta da Microsoft (MSA) e GitHub são os tipos de conta com suporte.
   2. Nome: Insira um nome para o túnel.
   3. Tipo de túnel: selecione Persistente ou Temporário.
   4. Acesso: selecione Público.
   5. Selecione OK. O Visual Studio exibe uma mensagem de confirmação de que um túnel foi criado.

   O túnel criado está listado em Dev Tunnels > (nome do túnel).

9. Acesse o Gerenciador de Soluções e selecione seu projeto.

10. Clique com o botão direito do mouse no menu do projeto e selecione Microsoft 365 Agents Toolkit>Selecione Conta do Microsoft 365.

    

    Se solicitado, entre com uma conta do Microsoft 365.

11. No menu suspenso Depurar, selecione Microsoft Teams (navegador). O Visual Studio inicia o cliente Web do Teams.

12. Selecione Adicionar. A extensão de mensagem é adicionada ao Teams.

    

13. Vá para um chat e selecione Ações e aplicativos.

14. No menu suspenso da extensão de mensagem, insira o nome da extensão de mensagem na caixa de pesquisa.

15. Selecione sua extensão de mensagem e insira sua consulta de pesquisa.

    

16. Selecione um produto na lista. O Teams desenrola o produto em um Cartão Adaptável na área de redação da mensagem.

17. Selecione Enviar. O Cartão Adaptável é enviado para o chat.

    

Disparar extensão de mensagem no Microsoft 365 Copilot

Para disparar a extensão de mensagem como agente no Microsoft 365 Copilot, siga estas etapas:

1. Vá para o Visual Studio.

2. Na lista suspensa de depuração, selecione Copilot (navegador). O Visual Studio inicia o cliente Web do Teams.

   

3. Vá paraAplicativosde cliente> Web do Teams.

4. Pesquise Copilot e abra o Microsoft 365 Copilot.

5. Selecione Painel no canto superior direito.

6. Selecione o agente necessário no painel direito.

   

7. Na área de redação de mensagem, envie uma mensagem para o Microsoft 365 Copilot para procurar a atualização mais recente do Teams e do Microsoft 365 Copilot.

   

Antes de começar, certifique-se de definir a variável de ambiente DEVELOP_COPILOT_PLUGIN como true. Para definir as variáveis de ambiente, siga estas etapas:

1. No computador, selecione a tecla Windows + X .

2. Selecione Sistema.

3. Em Sobre> asespecificações do dispositivo, selecione Configurações avançadas do sistema.

4. Em Propriedades do Sistema, selecione Variáveis de Ambiente...

5. Em Variáveis de usuário, selecione Novo... Uma caixa de diálogo Nova Variável de Usuário é aberta.

6. Atualize os seguintes campos:

   1. Nome da variável: DEVELOP_COPILOT_PLUGIN
   2. Valor da variável: true

7. Selecione OK.

   

Para criar um agente de extensão de mensagem de pesquisa baseado em bot usando a CLI do Agents Toolkit, siga estas etapas:

1. Vá para o Prompt de Comando.

2. Digite o seguinte comando:

   npm install -g @microsoft/atk-cli
   

3. Entre atk new no terminal.

4. Selecione a Extensão de Mensagem. Use as teclas de direção para alternar entre as opções.

   

5. Selecione os resultados da pesquisa personalizados.

6. Selecione Iniciar com um Bot.

   

7. Insira o local do seu projeto e selecione Enter.

8. Insira o nome do seu aplicativo e selecione Enter.

   O Agents Toolkit cria um scaffolds e cria um projeto no local especificado.

9. Vá para o caminho da pasta em que seu projeto é criado e insira o seguinte comando para provisionar seu aplicativo no Azure:

    teamsapp provision --env dev
   

   A CLI do Agents Toolkit abre uma janela do navegador e solicita que você entre em sua Conta Microsoft.

10. Entre em sua conta Microsoft. A CLI do Kit de Ferramentas de Agentes executa a validação e provisiona seu aplicativo no Azure.

11. Na lista, selecione uma assinatura.

    

12. Na lista, selecione um grupo de recursos.

13. Se você receber uma mensagem, que diz Custo pode incorrer de acordo com o uso. Deseja provisionar recursos no ambiente de desenvolvimento usando as contas listadas acima?, insira Y.

    

    O Kit de Ferramentas de Agentes valida o manifesto do seu aplicativo e provisiona seu aplicativo no Azure.

14. Na janela do prompt de comando, digite o seguinte comando para visualizar seu aplicativo no Teams:

     teamsapp preview --env dev
    

    Uma nova janela do navegador com o cliente Web do Teams é aberta. Você pode adicionar seu aplicativo ao Teams.

15. Selecione Adicionar. A extensão de mensagem é adicionada ao Teams.

16. Vá para um chat e selecione Ações e aplicativos.

17. No menu suspenso da extensão de mensagem, insira o nome da extensão de mensagem na caixa de pesquisa.

18. Selecione sua extensão de mensagem e insira sua consulta de pesquisa.

Disparar extensão de mensagem no Microsoft 365 Copilot

Para disparar a extensão de mensagem como agente no Microsoft 365 Copilot no Teams, siga estas etapas:

1. Selecione Aplicativos.

2. Pesquise Copilot e abra o Microsoft 365 Copilot.

3. Selecione Painel no canto superior direito.

4. Selecione o agente necessário no painel direito.

   

5. Na área de redação de mensagem, envie uma mensagem para o Microsoft 365 Copilot para procurar a atualização mais recente do Teams e do Microsoft 365 Copilot.

   

Para criar uma extensão de mensagem baseada em bot usando o Portal do Desenvolvedor do Teams, siga estas etapas:

1. Acesse o portal do desenvolvedor do Teams.

2. Vá para Aplicativos.

3. Selecione + Novos aplicativos.

4. Na página Adicionar aplicativos, atualize o nome e selecione a versão do manifesto como Visualização do desenvolvedor público (devPreview).

   

5. Em Configurar, selecione Recursos do aplicativo.

6. Selecione a Extensão de mensagens.

7. Em Tipo de extensão de mensagem, selecione Bot.

   1. Se você receber um aviso de isenção de responsabilidade, que diz API, a extensão da mensagem já está em uso pelos usuários. Deseja alterar o tipo de extensão de mensagem para bot?. Selecione Sim, alterar.

      

8. Se você tiver um bot existente, selecione Bot existente ou, se tiver uma ID de bot, selecione Inserir ID do Bot.

   1. Se você não tiver uma ID do Bot, poderá selecionar Criar um novo bot para criar um novo bot e inserir a ID do bot do novo bot que você criou.

      

9. Selecione Salvar.

10. Em Comando, selecione + Adicionar um comando.

    A página Adicionar um comando é exibida.

11. Na página Adicionar um comando , selecione Pesquisar como o tipo de comando e atualize os seguintes campos:

    • ID do comando
    • Título do comando
    • Descrição do comando
    • Contexto no qual o comando funciona
    • Nome do parâmetro
    • Título do parâmetro
    • Descrição do parâmetro

12. Selecione Salvar. O comando é adicionado à extensão de mensagem.

13. Selecione Salvar.

Uma extensão de mensagem de pesquisa baseada em bot é criada.

Para testar a extensão de mensagem baseada em bot criada no Portal do Desenvolvedor do Teams, você pode usar os seguintes métodos:

• Visualização no Teams: No Portal do Desenvolvedor, abra a extensão de mensagem e selecione Visualizar no Teams no canto superior direito. Você será redirecionado para o Teams, onde poderá adicionar o aplicativo ao Teams para visualizá-lo.

• Baixar pacote do aplicativo: na página de extensão de mensagem, selecione Pacote do aplicativo no painel esquerdo e, em seguida, no canto superior esquerdo da janela, selecione Baixar pacote do aplicativo. O pacote do aplicativo é baixado em seu computador local em um arquivo .zip. Você pode carregar o pacote do aplicativo no Teams e testar a extensão de mensagem.