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

Observação

• Verifique se Copilot para Microsoft 365 está disponível para sua organização. Você tem duas maneiras de obter um ambiente de desenvolvedor para Copilot:
  • Um locatário do Microsoft 365 com Copilot (disponível em versão prévia limitada por meio da associação TAP).
  • Um ambiente de produção do Microsoft 365 ou Office 365 qualificado com uma licença de Copilot para Microsoft 365.
• O plug-in de extensão de mensagem de pesquisa baseado em bot está disponível na versão prévia do desenvolvedor público.
• Somente extensões de mensagem baseadas em bot com comandos de pesquisa podem ser estendidas como plug-ins para Copilot para Microsoft 365.

Microsoft Copilot para Microsoft 365, alimentado por um mecanismo avançado de processamento e orquestração, integra aplicativos do Microsoft 365, Microsoft Graph e LLMs (grandes modelos de linguagem) para transformar suas palavras em uma ferramenta de produtividade potente. Embora Copilot para Microsoft 365 possa utilizar aplicativos e dados no ecossistema do Microsoft 365, muitos usuários dependem de várias ferramentas externas e serviços para gerenciamento de trabalho e colaboração. Ao estender sua extensão de mensagem como um plug-in no Copilot para Microsoft 365, você pode permitir que os usuários interajam com ferramentas e serviços de terceiros, capacitando-os a obter mais com Copilot para Microsoft 365. Você pode obter essa extensão desenvolvendo um plug-in ou conectando-se a uma fonte de dados externa.

Confira o vídeo para saber mais sobre como estender Copilot para Microsoft 365 usando extensões de mensagem do Teams:

O que é um plug-in?

Um plug-in permite que Copilot para Microsoft 365 interajam diretamente com dados, aplicativos e serviços de terceiros, aprimorem suas funcionalidades e ampliem seu intervalo de recursos. Os plug-ins permitem que Copilot para Microsoft 365:

• Busque informações em tempo real, como a cobertura de notícias mais recentes em um lançamento de produto.
• Recupere informações baseadas em conhecimento, como arquivos de design de uma equipe no Figma.
• Execute ações em nome do usuário, como criar um tíquete Contoso.

As descrições aprimoram a usabilidade e a eficácia de um plug-in de extensão de mensagem. A descrição a seguir oferece um resumo claro e conciso dos recursos do aplicativo:

• Descrição do aplicativo: a descrição do aplicativo ajuda a melhorar a descoberta do aplicativo na Teams Store.
• Descrição do comando: a descrição do comando mapeia a intenção e o enunciado do usuário para pesquisar o comando dentro de um plug-in e deve ser criado com base na análise da intenção e das palavras-chave do usuário.
• Descrição do parâmetro: a descrição do parâmetro explica os requisitos do sistema em uma linguagem natural com formato de saída.
• Descrição semântica: a descrição semântica ajuda o Copilot for Micrososft 365 a gerar conteúdo fornecendo uma compreensão conceitual das funcionalidades e cenários do plug-in em que ele pode ajudar a alcançar metas de usuário e corresponder a intenção do usuário com as funcionalidades do plug-in.

Para obter mais informações, confira definir descrições.

Todas as extensões de mensagem de pesquisa baseadas em bot são qualificadas para suporte a plug-in, sujeitas à validação para garantir que o plug-in atenda às expectativas de qualidade, segurança, privacidade e utilidade. Você pode criar uma extensão de mensagem de pesquisa baseada em bot usando o Teams Toolkit para Visual Studio Code, Visual Studio, CLI (interface de linha de comando do Teams Toolkit) ou Portal do Desenvolvedor para Teams e estender a extensão de mensagem para funcionar como um plug-in no Copilot para Microsoft 365.

Pré-requisitos

Antes de começar, verifique se você está familiarizado com os seguintes padrões e diretrizes para criar plug-ins de extensão de mensagem para Copilot para Microsoft 365:

• Padrões de conformidade, desempenho, segurança e experiência do usuário descritos nas diretrizes de validação do Teams Store.

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

Criar extensão de mensagem baseada em bot

Importante

Os plug-ins para Microsoft Copilot para Microsoft 365 estão em versão prévia e funcionam apenas em Microsoft 365 Chat no Microsoft Teams.

Vamos criar uma extensão de mensagem de pesquisa baseada em bot que pode pesquisar registros npm no Teams e copilot e compartilhar resultados por meio da área de mensagem de composição do cliente do Microsoft Teams.

Visual Studio Code

Antes de começar, verifique se você instala as seguintes ferramentas para criar e implantar sua extensão de mensagem:

• Instale a versão de pré-lançamento mais recente do Teams Toolkit.
• Verifique se o sinalizador de recurso Desenvolver Plug-in copilot está habilitado. Para habilitar o sinalizador de recursos, siga estas etapas:
  1. Abra o Visual Studio Code.
  2. Vá para Gerenciar>Configurações.
  3. Insira o Kit de Ferramentas do Teams na caixa de pesquisa de configurações de Pesquisa.
  4. Em Extensões, selecione a caixa de seleção Fx-extension: Desenvolver a caixa de seleção Plug-in copilot .

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

1. Abra o Visual Studio Code.

2. No painel esquerdo, selecione Kit de Ferramentas do Teams.

3. Selecione Criar um Novo Aplicativo.

4. Selecione Extensão de Mensagem.

5. Selecione Resultados de Pesquisa Personalizados.

6. Selecione Iniciar com um Bot.

   

7. Selecione uma linguagem de programação.

8. Selecione Pasta Padrão.

9. Insira o nome do aplicativo e selecione Inserir. O Teams Toolkit cria um 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 Kit de Ferramentas do Teams.

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 Depuração no Teams (Edge) ou Depuração no Teams (Chrome). O Teams Toolkit inicia seu aplicativo no Teams usando um navegador da Web.

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

6. Acesse um chat e selecione Ações e aplicativos.

7. No menu fly-out da extensão de mensagem, insira o nome da sua 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 composição de mensagens.

10. Selecione Enviar.

Disparar extensão de mensagem no Chat M365

Para disparar a extensão de mensagem como plug-in no Chat do M365, siga estas etapas:

1. Selecione Aplicativos.

2. Pesquisa para o Chat M365 e abra o aplicativo de chat M365.

3. Selecione Plug-ins.

4. Na lista de plug-ins, ative o alternância para sua extensão de mensagem.

   

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

   

Observação

Esse prompt pode nem sempre fazer com que o Chat M365 inclua uma resposta da sua extensão de mensagem. Se isso acontecer, tente alguns outros prompts ou deixe comentários para nós, baixando a votação da resposta do Chat M365 e deixando uma mensagem.

Visual Studio

Antes de começar, verifique se você instala as seguintes ferramentas para criar e implantar sua extensão de mensagem:

• Instale o Visual Studio Enterprise versão 17.9.0 Versão prévia 1.0 ou posterior do Visual Studio Enterprise 2022 e instale as ferramentas de desenvolvimento do Microsoft Teams em ASP.NET e carga de trabalho de desenvolvimento web.
• Verifique se o sinalizador de recurso Copilot está habilitado. Para habilitar o sinalizador de recursos, siga estas etapas:
  1. Abra o Visual Studio.
  2. Acesse Opções de Ferramentas>.
  3. Insira o Kit de Ferramentas do Teams na caixa de pesquisa Configurações de Pesquisa.
  4. Em Recursos de Visualização, selecione a caixa de seleção Kit de Ferramentas do Teams: Desenvolver a caixa de seleção Plug-in copilot .

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

1. Abra o Visual Studio.

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

3. Pesquisa para o Teams e selecione Aplicativo do Microsoft Teams.

4. Selecione Resultados de Pesquisa Personalizados.

   

5. Selecione Criar. O projeto é scaffolded.

6. No menu suspenso de depuração, selecione Dev Tunnels>Create a Tunnel.

   
   

   1. Selecione a conta para criar o túnel. Azure, Microsoft Account (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 é criado.

   O túnel que você criou está listado em Túneis > de Desenvolvimento (nome do túnel).

7. Vá para Gerenciador de Soluções e selecione seu projeto.

8. Clique com o botão direito do mouse no menu do projeto e selecione Teams Toolkit>Prepare Teams App Dependencies.

   

   Se solicitado, entre com uma conta do Microsoft 365.

9. No menu suspenso de depuração, selecione Microsoft Teams (navegador). O Visual Studio inicia o cliente Web do Teams.

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

    

11. Acesse um chat e selecione Ações e aplicativos.

12. No menu fly-out da extensão de mensagem, insira o nome da sua extensão de mensagem na caixa de pesquisa.

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

    

14. Selecione um produto na lista. O Teams desenrola o produto em um Cartão Adaptável na área de composição de mensagens.

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

    

Disparar extensão de mensagem no Chat M365

Para disparar a extensão de mensagem como plug-in no Chat do M365, 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. Acesse Aplicativos de cliente> Web do Teams.

4. Pesquisa para o Chat M365 e abra o aplicativo de chat M365.

5. Selecione Plug-ins.

6. Na lista de plug-ins, ative o alternância para seu aplicativo.

   

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

   

Observação

Esse prompt pode nem sempre fazer com que o Chat M365 inclua uma resposta da sua extensão de mensagem. Se isso acontecer, tente alguns outros prompts ou deixe comentários para nós, baixando a votação da resposta do Chat M365 e deixando uma mensagem.

CLI do Kit de Ferramentas

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. Em seu computador, selecione a chave do Windows + X .

2. Selecione Sistema.

3. Em Sobre>as especificaçõ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 New... 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 variável: true

7. Selecione OK.

   

Para criar um plug-in de extensão de mensagem de pesquisa baseado em bot usando a CLI do Teams Toolkit, siga estas etapas:

1. Acesse Prompt de Comando.

2. Insira o seguinte comando:

   npm install -g @microsoft/teamsfx-cli@beta
   

3. Insira teamsfx new no terminal.

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

   

5. Selecione Resultados de Pesquisa Personalizados.

6. Selecione Iniciar com um Bot.

   

7. Insira o local do projeto e selecione Inserir.

8. Insira o nome do aplicativo e selecione Inserir.

   Os scaffolds do Teams Toolkit e cria um projeto no local especificado.

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

    teamsfx provision --env dev
   

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

10. Entre em sua conta Microsoft. A CLI do Teams Toolkit 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 lê Custo pode incorrer de acordo com o uso. Deseja provisionar recursos no ambiente de desenvolvimento usando contas listadas acima?, insiraY.

    

    O Teams Toolkit valida o manifesto do aplicativo e provisiona seu aplicativo no Azure.

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

     teamsfx 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 da mensagem é adicionada ao Teams.

16. Acesse um chat e selecione Ações e aplicativos.

17. No menu fly-out da extensão de mensagem, insira o nome da sua 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 Chat M365

Para disparar a extensão de mensagem por meio do Chat M365, siga estas etapas:

1. Selecione Aplicativos.

2. Pesquisa para o Chat M365 e abra o aplicativo de chat M365.

3. Selecione Plug-ins.

4. Na lista de plug-ins, ative o alternância para seu aplicativo.

   

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

   

Observação

Esse prompt pode nem sempre fazer com que o Chat M365 inclua uma resposta da sua extensão de mensagem. Se isso acontecer, tente alguns outros prompts ou deixe comentários para nós baixando a votação da resposta do Chat M365 e deixe uma mensagem marcada com [MessageExtension].

Portal do Desenvolvedor do Teams

Para criar um plug-in de extensão de mensagem de pesquisa baseado em bot usando o portal do Desenvolvedor para Teams, siga estas etapas:

1. Acesse o Portal de Desenvolvedores do Teams.

2. Acesse Aplicativos.

3. Selecione + Novos aplicativos.

4. Em Configurar, selecioneRecursos de aplicativo.

5. Selecione Extensão de mensagens.

   

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

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

   

7. Se você tiver um bot existente, selecione Bot existente ou, se tiver uma ID do 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 criado.

   

8. Selecione Salvar.

9. Em Comando, selecione + Adicionar um comando.

   A página Adicionar um comando é exibida.

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

    • ID do comando
    • Título de comando
    • Descrição do comando
    • Contexto em que o comando funciona
    • Nome do parâmetro
    • Título de parâmetro
    • Descrição do parâmetro

11. Selecione Salvar. O comando é adicionado à extensão da mensagem.

12. Selecione Salvar.

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

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

• Visualização no Teams: no Portal do Desenvolvedor, abra sua 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 visualizar o aplicativo.

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

Para obter mais informações sobre como testar o plug-in no chat Copilot para Microsoft 365, confira Seleção de plug-in de depuração.

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 o Chat M365.

Confira também

• Criar extensões de mensagem usando a API
• Definir comandos de ação de extensão de mensagem
• Estender o Microsoft Copilot para Microsoft 365