Depurar no cliente de área de trabalho do Teams

O Microsoft 365 Agents Toolkit (anteriormente conhecido como Teams Toolkit) ajuda você a depurar e visualizar seu aplicativo Microsoft Teams no cliente de área de trabalho. Durante o processo de depuração, o Kit de Ferramentas de Agentes inicia automaticamente os serviços de aplicativo, abre os depuradores e carrega o aplicativo Teams. Você pode visualizar o aplicativo do Teams no cliente de desktop do Teams após a depuração.

A seguir estão as vantagens do cliente de área de trabalho do Teams:

  • Melhora o desempenho.
  • Reduz o tempo até F5.
  • Melhora a cobertura de destinos de depuração.

Recursos do cliente de área de trabalho do Teams

O cliente de área de trabalho do Teams incorpora recursos de depuração nos seguintes modelos de aplicativo criados pelo Kit de Ferramentas de Agentes:

  • Bot do Azure.
  • agente.
  • Agente de mecanismo personalizado.
  • Extensão de mensagem.

Pré-requisitos

Certifique-se de instalar as seguintes ferramentas para criar e implantar seu aplicativo no cliente de área de trabalho do Teams:

  Instalar Para usar...
  Microsoft 365 Agents Toolkit Uma extensão do Microsoft Visual Studio Code que cria um scaffolding de projeto para seu aplicativo. Use a versão de pré-lançamento mais recente.
  Node.js Ambiente de runtime do JavaScript de back-end. Para obter mais informações, consulte node.js tabela de compatibilidade de versão para o tipo de projeto.
  Visual Studio Code Ambientes de compilação JavaScript, TypeScript ou Estrutura do SharePoint (SPFx). Use a versão mais recente.
  Conta de desenvolvedor do Microsoft 365 Acesso à conta do Teams com as permissões apropriadas para instalar um aplicativo.

Depurar no cliente de área de trabalho do Teams

Para depurar seu aplicativo agente de mecanismo personalizado no cliente de desktop do Teams

  1. Abra o Visual Studio Code (VS Code) e faça logon na sua conta do Microsoft 365 por meio do Kit de Ferramentas de Agentes.

  2. Abra seu projeto de agente ou aplicativo do Teams.

    Para saber mais sobre como criar um novo agente ou aplicativo, confira Criar um agente do Teams com o Microsoft 365 Agents Toolkit ou aplicativos no Teams.

  3. No painel esquerdo, selecione Executar e Depurar (Ctrl+Shift+D) e selecione Depurar no Teams (Área de Trabalho) na lista suspensa.

    A captura de tela mostra a opção para selecionar depurar no Teams (Área de Trabalho).

  4. Verifique se o logon da área de trabalho do Teams corresponde à sua conta do Microsoft 365 usada no Kit de Ferramentas de Agentes e selecione Continuar.

    A captura de tela mostra o logon da área de trabalho.

    Solicitações de cliente de área de trabalho do Teams para adicionar seu aplicativo.

  5. Selecione Adicionar.

    A captura de tela mostra o botão adicionar para adicionar o aplicativo ao cliente da área de trabalho do Teams.

    Uma janela de bate-papo é aberta.

  6. Na área de redação da mensagem, envie uma mensagem para invocar o bot.

    A captura de tela mostra o aplicativo adicionado ao cliente de área de trabalho do Teams.

    Observação

    A notificação no nível do sistema para correspondência de contas aparece apenas uma vez por projeto. Nas sessões de depuração subsequentes, o Agents Toolkit envia lembretes sobre a conta por meio de notificações do VS Code.

    A captura de tela mostra a notificação subsequente de login da área de trabalho no vs Code.

  7. Você pode adicionar pontos de interrupção e recarregar suas alterações. No exemplo a seguir, o ponto de interrupção é realçado com o ponto vermelho ao lado do número da linha.

    A captura de tela mostra um exemplo dos pontos de interrupção no aplicativo.

    A captura de tela mostra um exemplo após o recarregamento dinâmico de um aplicativo.

Você pode continuar a depurar seu aplicativo agente de mecanismo personalizado no cliente de desktop do Teams.

Confira também