Expandir a extensão de mensagem baseada em bot como plug-in para Microsoft 365 Copilot

Observação

• Certifique-se de que Microsoft 365 Copilot está disponível para a sua organização. Tem duas formas de obter um ambiente de programador para Microsoft 365 Copilot:
  • Um inquilino do Microsoft 365 de sandbox com Microsoft 365 Copilot (disponível em pré-visualização limitada através da associação TAP).
  • Um ambiente de produção do Microsoft 365 ou Office 365 elegível com uma licença de Microsoft 365 Copilot.
• O plug-in de extensão de mensagem de pesquisa baseado em bot está disponível na pré-visualização pública do programador.
• Apenas as extensões de mensagens baseadas em bots com comandos de pesquisa podem ser expandidas como plug-ins para Microsoft 365 Copilot.

Microsoft 365 Copilot, com tecnologia de um motor de processamento e orquestração avançado, integra as aplicações do Microsoft 365, o Microsoft Graph e os Modelos de Linguagem Grande (LLMs) para transformar as suas palavras numa ferramenta de produtividade potente. Embora Microsoft 365 Copilot possam utilizar aplicações e dados no ecossistema do Microsoft 365, muitos utilizadores dependem de várias ferramentas e serviços externos para gestão e colaboração no trabalho. Ao expandir a extensão de mensagens como um plug-in no Microsoft 365 Copilot, pode permitir que os utilizadores interajam com ferramentas e serviços de terceiros, permitindo-lhes assim alcançar mais com Microsoft 365 Copilot. Pode obter esta extensão ao desenvolver um plug-in ou ligar a uma origem de dados externa.

Veja o vídeo para saber mais sobre como expandir Microsoft 365 Copilot com extensões de mensagens do Microsoft Teams:

O que é um plug-in?

Um plug-in permite Microsoft 365 Copilot interagir diretamente com dados, aplicações e serviços de terceiros, melhorar as suas capacidades e alargar o seu leque de capacidades. Os plug-ins permitem Microsoft 365 Copilot:

• Obtenha informações em tempo real, como a cobertura de notícias mais recente num lançamento de produto.
• Obtenha informações baseadas em conhecimento, como os ficheiros de design de uma equipa no Figma.

As descrições melhoram a usabilidade e a eficácia de um plug-in de extensão de mensagens. A seguinte descrição oferece um resumo claro e conciso das funcionalidades da aplicação:

• Descrição da aplicação: a descrição da aplicação ajuda a melhorar a deteção da sua aplicação na Loja Teams.
• Descrição do comando: a descrição do comando mapeia a intenção e a expressão do utilizador para procurar o comando dentro de um plug-in e tem de ser criada com base na análise da intenção do utilizador e das palavras-chave.
• Descrição do parâmetro: a descrição do parâmetro explica os requisitos do sistema numa linguagem natural com formato de saída.
• Descrição semântica: a descrição semântica ajuda a Microsoft 365 Copilot gerar conteúdo ao fornecer uma compreensão conceptual das capacidades e cenários do plug-in, onde pode ajudar a alcançar objetivos de utilizador e a corresponder a intenção do utilizador com as capacidades do plug-in.

Para obter mais informações, veja diretrizes para criar e atualizar agentes copilot.

Todas as extensões de mensagens de pesquisa baseadas em bots são elegíveis para suporte de plug-ins, sujeitos a validação para garantir que o plug-in cumpre as expetativas de qualidade, segurança, privacidade e utilidade. Pode criar uma extensão de mensagem de pesquisa baseada em bots com o Teams Toolkit para Visual Studio Code, o Visual Studio, a interface de linha de comandos (CLI) do Teams Toolkit ou o Portal do Programador para Teams e expandir a extensão de mensagem para funcionar como um plug-in no Microsoft 365 Copilot.

Pré-requisitos

Antes de começar, certifique-se de que está familiarizado com as seguintes normas e diretrizes para criar plug-ins de extensão de mensagens para Microsoft 365 Copilot:

• Normas de conformidade, desempenho, segurança e experiência do utilizador descritas nas diretrizes de validação da Loja Teams.

• Diretrizes para criar ou atualizar um plug-in de extensão de mensagem para Microsoft 365 Copilot.

Criar extensão de mensagem baseada em bot

Importante

Os plug-ins para Microsoft 365 Copilot estão em pré-visualização e só funcionam em Microsoft 365 Copilot no Teams.

Vamos criar uma extensão de mensagem de pesquisa baseada em bot que pode pesquisar registos npm no Teams e Microsoft 365 Copilot e partilhar resultados através da área de composição de mensagens do cliente do Microsoft Teams.

Visual Studio Code

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 plug-in 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 plug-in no Microsoft 365 Copilot no Teams, siga estes passos:

1. Selecione Aplicativos.

2. Procure Copilot e abra Microsoft 365 Copilot.

3. Selecione Plug-ins.

4. Na lista de plug-ins, ative o botão de alternar para a extensão da mensagem.

   

5. Na área de composição de mensagens, envie uma mensagem para Microsoft 365 Copilot para procurar informações do pacote npm no Teams e Microsoft 365 Copilot. Por exemplo, localize as informações do pacote npm no teamsfx-react em npm-searchlocal.

   

Observação

Este pedido pode nem sempre fazer Microsoft 365 Copilot incluir uma resposta da sua extensão de mensagem. Se isso acontecer, experimente outros pedidos ou deixe-nos comentários ao recusar a resposta do Microsoft 365 Copilot e deixe uma mensagem.

Visual Studio

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 plug-in de extensão de mensagem 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 da mensagem como plug-in 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 Plug-ins.

6. Na lista de plug-ins, ative o botão de alternar para a sua aplicação.

   

7. Na área de composição de mensagens, envie uma mensagem para Microsoft 365 Copilot para procurar informações do pacote npm no Teams e Microsoft 365 Copilot. Por exemplo, localize as informações do pacote npm no teamsfx-react em npmsearchlocal.

   

Observação

Este pedido pode nem sempre fazer Microsoft 365 Copilot incluir uma resposta da sua extensão de mensagem. Se isso acontecer, experimente outros pedidos ou deixe-nos comentários ao recusar a resposta do Microsoft 365 Copilot e deixe uma mensagem.

Toolkit CLI

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 plug-in de extensão de mensagem 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 através de Microsoft 365 Copilot, siga estes passos:

1. Selecione Aplicativos.

2. Procure Copilot e abra Microsoft 365 Copilot.

3. Selecione Plug-ins.

4. Na lista de plug-ins, ative o botão de alternar para a sua aplicação.

   

5. Na área de composição de mensagens, envie uma mensagem para Microsoft 365 Copilot para procurar informações do pacote npm no Teams e Microsoft 365 Copilot. Por exemplo, localize as informações do pacote npm no teamsfx-react em npm-searchlocal.

   

Observação

Este pedido pode nem sempre fazer Microsoft 365 Copilot incluir uma resposta da sua extensão de mensagem. Se isso acontecer, experimente outros pedidos ou deixe-nos feedback ao recusar a resposta do Microsoft 365 Copilot e deixe uma mensagem marcada com [MessageExtension].

Portal do Desenvolvedor do Teams

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.

Para obter mais informações sobre como testar o plug-in no Microsoft 365 Copilot, veja depurar a seleção de plug-ins.

Ativar a extensão de mensagens como um plug-in para o Copilot para reuniões

Certifique-se de que criou uma extensão de mensagem baseada em bot e expandiu-a como um plug-in para Microsoft 365 Copilot. Antes de começar, siga as diretrizes listadas em Garantir que os plug-ins do Copilot funcionam em reuniões do Teams para expandir o plug-in para o Copilot para reuniões.

Para ativar a extensão de mensagens como um plug-in para o Copilot para reuniões, siga estes passos:

1. Aceda a uma reunião do Teams.

2. Selecione Aderir.

3. Na janela da reunião, selecione Copilot.

4. Selecione Iniciar transcrição.

   

5. Selecione o Idioma falado e selecione Confirmar. É apresentado o painel Copilot for Teams.

   

6. No painel Copilot for Teams, no canto inferior direito, selecione o Botão de Plug-in Copilot.

   

7. Procure o plug-in e ative o botão de alternar do plug-in.

8. Na área de composição, selecione Mais pedidos para enviar uma linha de comandos estática ou pode escrever o seu próprio pedido e selecionar Enviar.

   

O Copilot para reuniões ajuda as suas reuniões a serem melhores e mais produtivas. Pode tornar as reuniões mais interativas, o que ajuda os utilizadores ao dar-lhes uma experiência mais suave e interessante.

Guias passo a passo

Siga o guia passo a passo para criar um plug-in de extensão de mensagem de pesquisa baseado em bot para Microsoft 365 Copilot.

Confira também

• Criar extensões de mensagens com a API
• Definir comandos de ação de extensão de mensagem
• Extender o Microsoft 365 Copilot