Ferramenta de Teste de Aplicativo do Teams para Visual Studio

Artigo
03/15/2024

A Ferramenta de Teste de Aplicativo do Teams (Ferramenta de Teste) torna a depuração de aplicativos baseados em bots sem esforço. Você pode conversar com seu bot e ver suas mensagens e Cartões Adaptáveis conforme elas aparecem no Microsoft Teams. Você não precisa de uma conta de desenvolvedor do Microsoft 365, túnel ou aplicativo do Teams e registro de bot para usar a Ferramenta de Teste.

A imagem a seguir mostra um aplicativo de exemplo exibindo uma resposta na Ferramenta de Teste:

Veja a seguir as vantagens da Ferramenta de Teste:

Ambiente de área restrita: o ambiente de área restrita da Ferramenta de Teste emula o comportamento, a aparência e a experiência do usuário do Teams.
Túnel: um serviço de túnel externo não é necessário, pois a Ferramenta de Teste é executada em um servidor local com o qual o bot pode se comunicar.
Reduzir as dependências da conta: o locatário do Desenvolvedor do Microsoft 365 e as permissões de carregamento do aplicativo não são necessários para depurar o bot.
Iterações rápidas de loop interno: otimiza o processo de fazer alterações no design do aplicativo e na lógica do bot sem precisar reimplantar o bot na nuvem.
Dados e atividades simulados: a Ferramenta de Teste facilita o teste de cenários complexos, como enviar uma mensagem de boas-vindas quando um novo membro ingressar no canal e usar dados simulados e gatilhos de atividade.
Confiável: a Ferramenta de Teste é confiável, pois o Cartão Adaptável do bot utiliza a mesma tecnologia de renderização que no Teams.
Integração com aplicativos de bot do Teams existentes: a Ferramenta de Teste se integra sem esforço aos aplicativos de bot do Teams existentes criados com o SDK do Bot Framework.
Suporte para diferentes escopos: a Ferramenta de Teste dá suporte a testes em escopos de chat pessoal, de equipe e de grupo.

Pré-requisitos

Verifique se você instala as seguintes ferramentas para criar e implantar seu bot na Ferramenta de Teste:

Instalar	Para usar...
Node.js	Ambiente de runtime do JavaScript de back-end.
Visual Studio 2022	Você pode instalar a versão corporativa no Visual Studio 2022 e instalar as cargas de trabalho ASP.NET e desenvolvimento da Web. Use a versão 17.9 ou posterior.

Experiência de ferramenta de teste no Visual Studio

A Ferramenta de Teste oferece uma experiência de depuração mais rápida para aplicativos bot quando comparada com o cliente do Teams. A Ferramenta de Teste fornece suporte para todos os recursos do aplicativo bot. Nesse cenário, estamos usando o Bot de Chat de IA como exemplo. Para depurar seu bot na Ferramenta de Teste, siga estas etapas:

Abra o Visual Studio.
Selecione Criar um novo projeto.
Na caixa de pesquisa, insira Microsoft Teams. Nos resultados da pesquisa, selecione Aplicativo do Microsoft Teams.
Selecione Avançar.
Insira o nome do projeto e selecione Criar.
SelecioneCriar bot >de chat de IA.
Observação
- OpenAI ou Azure OpenAI são o pré-requisito para depurar o aplicativo Bot de Chat de IA .
Uma janela GettingStarted é exibida.
O appsettings.TestTool.json arquivo ajuda a configurar a Ferramenta de Teste atualizando alguns parâmetros. Para atualizar appsettings.TestTool.json o arquivo, siga as etapas OpenAI ou Azure OpenAI:
- OpenAI
- Azure OpenAI
- Atualize OpenAI ApiKey no appsettings.TestTool.json arquivo.
1. Atualize o Azure OpenAIApiKey e OpenAIEndpoint no appsettings.TestTool.json arquivo.
2. Substitua o nome do modelo pelo nome da implantação do modelo do Azure OpenAI no Program.cs arquivo.
Na lista suspensa de depuração, selecione Ferramenta de Teste de Aplicativo do Teams (navegador).

A Ferramenta de Teste abre o bot em uma página da Web.

Gatilhos de atividade

Você pode simular uma atividade na Ferramenta de Teste usando gatilhos de atividade. Há dois tipos de gatilhos de atividade:

Gatilhos de atividade predefinidos
Gatilhos de atividade personalizados

Gatilhos de atividade predefinidos

A Ferramenta de Teste fornece gatilhos de atividade predefinidos para testar as funcionalidades do bot.

Categoria	Atividade	Manipulador
Atividade de atualização de instalação do gatilho	Instalar bot Desinstalar bot	`onInstallationUpdate` `onInstallationUpdateAdded` `onInstallationUpdate` `onInstallationUpdateRemove`
Atividade de atualização de conversa de gatilho	Adicionar usuário Adicionar bot Adicionar canal	`onMembersAdded` `onTeamsMembersAddedEvent` `onTeamsChannelRenamedEvent`
	Remover usuário Remover bot Remover canal Remover equipe	`onMembersRemoved` `onTeamsMembersRemovedEvent` `onMembersRemoved` `onTeamsMembersRemovedEvent` `onTeamsChannelDeletedEvent` `onTeamsTeamDeletedEvent`
	Renomear canal Renomear equipe	`onTeamsChannelRenamedEvent` `onTeamsTeamRenamedEvent`

Observação

Todos os tipos de atividades não estão disponíveis em todos os escopos. Por exemplo, você não pode adicionar ou remover um canal em um chat pessoal ou um chat em grupo.

Os gatilhos de atividade predefinidos estão disponíveis no menu Simular uma Atividade na Ferramenta de Teste. Nesse cenário, estamos usando Adicionar gatilho de atividade do usuário como exemplo. Para simular uma atividade Adicionar usuário , siga estas etapas:

Em Visual Studio Code, vá para Gerenciador de Soluções.
Selecione o arquivo Program.cs .
No arquivo Program.cs , em builder.Services.AddTransient<IBot>(sp => adicionar o seguinte código:
```
app.OnConversationUpdate("membersAdded", async (context, state, cancellationToken) =>
{
   await context.SendActivityAsync($"new member added", cancellationToken: cancellationToken);
});
```
O OnConversationUpdate manipulador reconhece os membros que ingressam na conversa, conforme descrito pela atividade Adicionar usuário.
Na Ferramenta de Teste, vá para Simular uma Atividade e selecione Adicionar usuário.

Uma caixa de diálogo pop-up aparece para visualizar o manipulador de atividades.
Selecione Enviar atividade.

O bot envia uma resposta.

Gatilhos de atividade personalizados

Você pode usar a atividade personalizada para personalizar o gatilho reactionsAddedde atividade , para se adequar aos requisitos do seu aplicativo bot. A Ferramenta de Teste preenche automaticamente as propriedades necessárias da atividade. Você também pode modificar o tipo de atividade e adicionar mais propriedades, como, MembersAdded, membersremovede reactionsremoved.

Em Visual Studio Code, vá para Gerenciador de Soluções.
Selecione o arquivo Program.cs .
No arquivo Program.cs , em builder.Services.AddTransient<IBot>(sp => adicionar o seguinte código:
```
app.OnMessageReactionsAdded(async (context, state, cancellationToken) =>
{
   await context.SendActivityAsync($"reaction added.", cancellationToken: cancellationToken);
});
```
O OnMessageReactionsAdded manipulador identifica a reação ao acréscimo usando a ReplyToId propriedade da conversa anterior.
Acesse a página da Web ferramenta de teste e selecione a resposta mais recente do Painel de Log para copiar replyToId.
Selecione Simular uma atividadepersonalizada de atividade.>
Para personalizar a atividade, adicione messageReaction na type propriedade.

Substitua pelo mais recente replyToId.

{
  "type": "messageReaction",
  "reactionsAdded": [
    {
      "type": "like"
    }
  ],
  "replyToId": "d60fd1cb-3e8f-44ef-849c-404806ba1b47"
}

Selecione Enviar atividade.

O bot envia um onReactionsAdded manipulador em resposta.

Limitações

Os recursos do bot habilitados por meio do manifesto do aplicativo não estão disponíveis, pois a Ferramenta de Teste não o processa.
A Ferramenta de Teste não dá suporte a todos os tipos de cartões, exceto cartões adaptáveis.
A Ferramenta de Teste não dá suporte aos seguintes recursos do Cartão Adaptável:
A Ferramenta de Teste não dá suporte às seguintes experiências:
- Dispositivo móvel
- Reunião