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

Antes de começar, certifique-se de que instala as seguintes ferramentas para criar e implementar a extensão de mensagem:

• Instale a versão de pré-lançamento mais recente do Teams Toolkit.
• Certifique-se de que o sinalizador de funcionalidade Desenvolver Plug-in do Copilot está ativado. Para ativar o sinalizador de funcionalidade, siga estes passos:
  1. Abra o Visual Studio Code.
  2. Aceda a Gerir>Definições.
  3. Introduza Teams Toolkit na caixa de pesquisa Definições de pesquisa.
  4. Em Extensões, selecione a caixa de verificação Fx-extension: Develop Copilot Plugin (Extensões), selecione a caixa de verificação Fx-extension: Develop Copilot Plugin (Desenvolver Plug-in copilot ).

Para criar um agente de extensão de mensagem de pesquisa baseado em bot com Visual Studio Code, siga estes passos:

1. Abra o Visual Studio Code.

2. No painel esquerdo, selecione Teams Toolkit.

3. Selecione Criar uma Nova Aplicação.

4. Selecione Extensão da Mensagem.

5. Selecione Resultados de Pesquisa Personalizados.

6. Selecione Começar com um Bot.

   

7. Selecione uma linguagem de programação.

8. Selecione Pasta predefinida.

9. Introduza o nome da sua aplicação e selecione Enter. O Teams Toolkit estrutura a sua aplicação e cria uma extensão de mensagem.

Para executar a extensão de mensagem no Teams, siga estes passos:

1. No painel esquerdo, selecione Teams Toolkit.

2. Em CONTAS, execute os seguintes passos:

   1. Selecione Iniciar sessão no Microsoft 365 e introduza as suas credenciais do Microsoft 365.

   2. Selecione Iniciar sessão no Azure e introduza as 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 Teams Toolkit inicia a sua aplicação no Teams através de um browser.

5. Selecione Adicionar. A aplicação está instalada no Teams.

6. Aceda a um chat e selecione Ações e aplicações.

7. No menu de lista de opções da extensão de mensagem, introduza o nome da sua extensão de mensagem na caixa de pesquisa.

8. Selecione a extensão da mensagem e introduza a consulta de pesquisa.

9. Selecione um produto na lista. O Teams desfralda o produto como um Cartão Ajustável na área de composição de mensagens.

10. Selecione Enviar.

Acionar a extensão de mensagem no Microsoft 365 Copilot

Para acionar a extensão de mensagem como agente no Microsoft 365 Copilot no Teams, siga estes passos:

1. Selecione Aplicativos.

2. Procure Copilot e abra Microsoft 365 Copilot.

3. Selecione Painel no canto superior direito.

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

   

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

   

Antes de começar, certifique-se de que instala as seguintes ferramentas para criar e implementar a 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 Teamsem ASP.NET e carga de trabalho de desenvolvimento Web.
• Certifique-se de que o sinalizador de funcionalidade Copilot está ativado. Para ativar o sinalizador de funcionalidade, siga estes passos:
  1. Abra o Visual Studio.
  2. Aceda a Opções de Ferramentas>.
  3. Introduza Teams Toolkit na caixa de pesquisa Definições de Pesquisa .
  4. Na secção Funcionalidades de Pré-visualização , selecione a caixa de verificação Toolkit do Teams: Desenvolver Plug-in do Copilot .
• Certifique-se de que o perfil de início de vários projetos está ativado. Para ativar o perfil, siga estes passos:
  1. Abra o Visual Studio.
  2. Aceda a Opções de Ferramentas>.
  3. Na secção Funcionalidades de Pré-visualização , selecione a caixa de verificação Ativar Perfis de Iniciação de Vários Projetos .

Para criar um agente de extensão de mensagens de pesquisa baseado em bot com o Visual Studio, siga estes passos:

1. Abra o Visual Studio.

2. Aceda a Ficheiro>Novo>Projeto... ou Criar um novo Projeto.

3. Procure Teams e selecione Aplicação Microsoft Teams.

4. Introduza os detalhes do projeto. Certifique-se de que a caixa de verificação Colocar solução e projeto no mesmo diretório não está selecionada.

5. Selecione Criar.

6. Selecione Resultados de Pesquisa Personalizados.

   

7. Selecione Criar. O projeto está estruturado.

8. No menu pendente de depuração, selecione Túneis> de DesenvolvimentoCriar um Túnel.

   
   

   1. Selecione a conta para criar o túnel. O Azure, a Conta Microsoft (MSA) e o GitHub são os tipos de conta suportados.
   2. Nome: introduza 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 apresenta uma mensagem de confirmação a indicar que é criado um túnel.

   O túnel que criou está listado em Túneis > Dev (nome do túnel).

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

10. Clique com o botão direito do rato no menu do projeto e selecione Teams Toolkit>Preparar Dependências de Aplicações do Teams.

    

    Se lhe for pedido, inicie sessão com uma conta do Microsoft 365.

11. No menu pendente de depuração, selecione Microsoft Teams (browser). O Visual Studio inicia o cliente Web do Teams.

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

    

13. Aceda a um chat e selecione Ações e aplicações.

14. No menu de lista de opções da extensão de mensagem, introduza o nome da sua extensão de mensagem na caixa de pesquisa.

15. Selecione a extensão da mensagem e introduza a consulta de pesquisa.

    

16. Selecione um produto na lista. O Teams desagrega o produto num Cartão Ajustável na área de composição de mensagens.

17. Selecione Enviar. O Cartão Ajustável é enviado para a conversa.

    

Acionar a extensão de mensagem no Microsoft 365 Copilot

Para acionar a extensão de mensagem como agente no Microsoft 365 Copilot, siga estes passos:

1. Aceda ao Visual Studio.

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

   

3. Aceda aAplicações cliente Web> do Teams.

4. Procure Copilot e abra Microsoft 365 Copilot.

5. Selecione Painel no canto superior direito.

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

   

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

   

Antes de começar, certifique-se de que define a variável de ambiente DEVELOP_COPILOT_PLUGINcomo verdadeira. Para definir as variáveis de ambiente, siga estes passos:

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

2. Selecione Sistema.

3. Em Acerca>das Especificações do dispositivo, selecione Definições avançadas do sistema.

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

5. Em Variáveis de utilizador, selecione Novo... É aberta uma caixa de diálogo Nova Variável de Utilizador .

6. Atualize os seguintes campos:

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

7. Selecione OK.

   

Para criar um agente de extensão de mensagens de pesquisa baseado em bot com a CLI do Teams Toolkit, siga estes passos:

1. Aceda à Linha de Comandos.

2. Introduza o seguinte comando:

   npm install -g @microsoft/teamsapp-cli
   

3. Introduza teamsapp new no terminal.

4. Selecione Extensão da Mensagem. Utilize as teclas de seta para alternar entre opções.

   

5. Selecione Resultados de Pesquisa Personalizados.

6. Selecione Começar com um Bot.

   

7. Introduza a localização do projeto e selecione Enter.

8. Introduza o nome da sua aplicação e selecione Enter.

   O Teams Toolkit estrutura e cria um projeto na localização especificada.

9. Aceda ao caminho da pasta onde o projeto é criado e introduza o seguinte comando para aprovisionar a sua aplicação no Azure:

    teamsapp provision --env dev
   

   A CLI do Teams Toolkit abre uma janela do browser e pede-lhe para iniciar sessão na sua Conta Microsoft.

10. Entre em sua conta Microsoft. A CLI do Teams Toolkit executa a validação e aprovisiona a sua aplicação no Azure.

11. Na lista, selecione uma subscrição.

    

12. Na lista, selecione um grupo de recursos.

13. Se receber uma mensagem, que diz Custo pode incorrer de acordo com a utilização. Pretende aprovisionar recursos no ambiente de desenvolvimento com contas listadas acima?, introduza Y.

    

    O Teams Toolkit valida o manifesto da sua aplicação e aprovisiona a sua aplicação no Azure.

14. Na janela da linha de comandos, introduza o seguinte comando para pré-visualizar a sua aplicação no Teams:

     teamsapp preview --env dev
    

    É aberta uma nova janela do browser com o cliente Web do Teams. Pode adicionar a sua aplicação ao Teams.

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

16. Aceda a um chat e selecione Ações e aplicações.

17. No menu de lista de opções da extensão de mensagem, introduza o nome da sua extensão de mensagem na caixa de pesquisa.

18. Selecione a extensão da mensagem e introduza a consulta de pesquisa.

Acionar a extensão de mensagem no Microsoft 365 Copilot

Para acionar a extensão de mensagem como agente no Microsoft 365 Copilot no Teams, siga estes passos:

1. Selecione Aplicativos.

2. Procure Copilot e abra Microsoft 365 Copilot.

3. Selecione Painel no canto superior direito.

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

   

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

   

Para criar uma extensão de mensagem baseada em bot com o Portal do Programador para Teams, siga estes passos:

1. Aceda ao Portal do Programador do Teams.

2. Aceda a Aplicações.

3. Selecione + Novas aplicações.

4. Na página Adicionar aplicações , atualize o nome e selecione a versão do manifesto como Pré-visualização do programador público (devPreview).

   

5. Em Configurar, selecioneFuncionalidades da aplicação.

6. Selecione Extensão de mensagens.

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

   1. Se receber uma exclusão de responsabilidade, que diz API Message extension já está a ser utilizada pelos utilizadores. Pretende alterar o tipo de extensão da mensagem para bot? Selecione Sim, alterar.

      

8. Se tiver um bot existente, selecione Bot existente ou, se tiver um ID de bot, selecione Introduzir ID do Bot.

   1. Se não tiver um ID de Bot, pode selecionar Criar um novo bot para criar um novo bot e introduzir o ID do bot novo que criou.

      

9. Selecione Salvar.

10. Em Comando, selecione + Adicionar um comando.

    É apresentada uma página de comandos.

11. Na página Adicionar um comando , selecione Procurar 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 da mensagem.

13. Selecione Salvar.

É criada uma extensão de mensagem de pesquisa baseada em bot.

Para testar a extensão de mensagem baseada em bot criada no Portal do Programador para Teams, pode utilizar os seguintes métodos:

• Pré-visualização no Teams: no Portal do Programador, abra a extensão da sua mensagem e selecione Pré-visualização no Teams no canto superior direito. É redirecionado para o Teams, onde pode adicionar a aplicação ao Teams para pré-visualizar a aplicação.

• Transferir pacote de aplicação: na página da extensão da mensagem, selecione Pacote de aplicação no painel esquerdo e, em seguida, no canto superior esquerdo da janela, selecione Transferir pacote de aplicação. O pacote de aplicação é transferido para o seu computador local num ficheiro .zip. Pode carregar o pacote de aplicações para as equipas e testar a extensão da mensagem.