Microsoft 365 Agents Playground para Visual Studio

O Playground de agentes do Microsoft 365 (anteriormente conhecido como Ferramenta de Teste de Aplicativo do Teams) facilita a depuração de aplicativos baseados em bot. Você pode conversar com seu bot e ver suas mensagens e Cartões Adaptáveis conforme eles aparecem no Microsoft Teams. Você não precisa de uma conta de desenvolvedor do Microsoft 365, túnel ou registro de aplicativo e bot do Teams para usar o Agents Playground.

A imagem a seguir mostra um aplicativo de exemplo exibindo uma resposta no Agents Playground:

A seguir estão as vantagens do Agents Playground:

• Ambiente de área restrita: o ambiente de área restrita do Agents Playground 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 o Agents Playground é executado em um servidor local com o qual seu bot pode se comunicar.

• Reduzir as dependências da conta: o locatário do Microsoft 365 Developer e as permissões de upload 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: O Agents Playground facilita o teste de cenários complexos, como enviar uma mensagem de boas-vindas quando um novo membro entra no canal e usar dados fictícios e gatilhos de atividade.

• Confiável: o Agents Playground é confiável, pois o Cartão Adaptável do bot utiliza a mesma tecnologia de renderização do Teams.

• Integração com aplicativos de bot existentes do Teams: o Agents Playground integra-se facilmente aos aplicativos de bot existentes do Teams criados com o SDK do Bot Framework.

• Suporte para diferentes escopos: o Agents Playground oferece suporte a testes nos escopos de chat pessoal, de equipe e em grupo.

Pré-requisitos

Certifique-se de instalar as seguintes ferramentas para criar e implantar seu bot no Agents Playground:

Experiência de Playground dos agentes no Visual Studio

O Agents Playground oferece uma experiência de depuração mais rápida para aplicativos de bot quando comparado ao cliente do Teams. O Agents Playground fornece suporte para todos os recursos do aplicativo de bot. Neste cenário, estamos usando o AI Chat Bot como exemplo. Para depurar seu bot no Agents Playground, siga estas etapas:

1. Abra o Visual Studio.

2. Selecione Criar um novo projeto.

   

3. Na caixa de pesquisa, digite Microsoft Teams. Nos resultados da pesquisa, selecione o aplicativo Microsoft Teams.

4. Selecione Avançar.

   

5. Insira o Nome do projeto e selecione Criar.

   

6. Selecione AI Chat Bot>Create.

   Observação

   • OpenAI ou OpenAI do Azure são o pré-requisito para depurar o aplicativo AI Chat Bot.

   

   Uma janela GettingStarted é exibida.

   

7. O appsettings.Playground.json arquivo ajuda a configurar o Agents Playground atualizando alguns parâmetros. Para atualizar appsettings.Playground.json o arquivo, siga as etapas do OpenAI ou do OpenAI do Azure:

   • OpenAI
   • OpenAI do Azure

   Atualize o appsettings.Playground.json OpenAI ApiKey no arquivo.

   

8. Na lista suspensa de depuração, selecione Microsoft 365 Agents Playground (navegador).

   

   O Agents Playground abre o bot em uma página da Web.

   

Gatilhos de atividade

Você pode simular uma atividade no Agents Playground usando gatilhos de atividade. Existem dois tipos de gatilhos de atividade:

• Gatilhos de atividade predefinidos
• Gatilhos de atividade personalizados

Gatilhos de atividade predefinidos

O Agents Playground fornece gatilhos de atividade predefinidos para testar as funcionalidades do seu bot.

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

1. No Visual Studio Code, acesse o Gerenciador de Soluções.

2. Selecione o arquivo Program.cs .

3. No arquivo Program.cs , adicione builder.Services.AddTransient<IBot>(sp => 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.

   

4. No Agents Playground, vá para Simular uma atividade e selecione Adicionar usuário.

   

   Uma caixa de diálogo pop-up é exibida para visualizar o manipulador de atividades.

5. 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 atender aos requisitos do seu aplicativo de bot. O Agents Playground 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.

1. No Visual Studio Code, acesse o Gerenciador de Soluções.

2. Selecione o arquivo Program.cs .

3. No arquivo Program.cs , adicione builder.Services.AddTransient<IBot>(sp => o seguinte código:

   app.OnMessageReactionsAdded(async (context, state, cancellationToken) =>
   {
      await context.SendActivityAsync($"reaction added.", cancellationToken: cancellationToken);
   });
   

   O OnMessageReactionsAdded manipulador identifica a reação a append usando a ReplyToId propriedade da conversa anterior.

   

4. Vá para a página da Web do Agents Playground e selecione a resposta mais recente do Painel de logs para copiar replyToId.

   

5. Selecione Simular uma atividade>personalizada.

   

6. Para personalizar a atividade, adicione messageReaction sob a type propriedade.

7. Substitua pelo mais recente replyToId.

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

8. Selecione Enviar atividade.

   

   O bot envia um onReactionsAdded manipulador em resposta.

   

Limitações

• Os recursos de bot habilitados por meio do manifesto do aplicativo não estão disponíveis, pois o Agents Playground não os processa.

• O Agents Playground não dá suporte a todos os tipos de cartões, exceto Cartões Adaptáveis.

• O Agents Playground não oferece suporte aos seguintes recursos do Cartão Adaptável:

  • Digitação antecipada
  • Menção do usuário
  • Stageview
  • Cartão Adaptável com largura total

• O Agents Playground não oferece suporte às seguintes experiências:

  • Dispositivo móvel
  • Reunião

Confira também

• Visão geral do Kit de Ferramentas de Agentes do Microsoft 365
• Criar bots para o Teams
• Cartão Adaptável
• Bot Framework SDK