Depurar no cliente de ambiente de trabalho do Teams

O Toolkit de Agentes do Microsoft 365 (anteriormente conhecido como Toolkit do Teams) ajuda-o a depurar e pré-visualizar a sua aplicação microsoft Teams no cliente de ambiente de trabalho. Durante o processo de depuração, o Toolkit de Agentes inicia automaticamente os serviços de aplicações, abre os depuradores e carrega a aplicação Teams. Pode pré-visualizar a aplicação Teams no cliente de ambiente de trabalho do Teams após a depuração.

Seguem-se as vantagens do cliente de ambiente de trabalho do Teams:

Melhora o desempenho.
Reduz o tempo para F5.
Melhora a cobertura dos destinos de depuração.

Capacidades do cliente de ambiente de trabalho do Teams

O cliente de ambiente de trabalho do Teams incorpora capacidades de depuração nos seguintes modelos de aplicação estruturados pelo Toolkit de Agentes:

Bot.
Agente.
Agente do motor personalizado.
Extensão de mensagem.

Pré-requisitos

Certifique-se de que instala as seguintes ferramentas para criar e implementar a sua aplicação no cliente de ambiente de trabalho do Teams:

	Instalar	Para usar...
	Toolkit de Agentes do Microsoft 365	Uma extensão do Microsoft Visual Studio Code que cria um projeto estruturado para a sua aplicação. Utilize a versão de pré-lançamento mais recente.
	Node.js	Ambiente de runtime do JavaScript de back-end. Para obter mais informações, veja node.js tabela de compatibilidade de versões para o tipo de projeto.
	Visual Studio Code	Ambientes de compilação JavaScript, TypeScript ou Estrutura do SharePoint (SPFx). Utilize a versão mais recente.
	Conta de programador do Microsoft 365	Acesso à conta do Teams com as permissões adequadas para instalar uma aplicação.

Depurar no cliente de ambiente de trabalho do Teams

Para depurar a aplicação do agente do motor personalizado no cliente de ambiente de trabalho do Teams

Abra Visual Studio Code (VS Code) e inicie sessão na sua conta do Microsoft 365 através do Toolkit de Agentes.
Abra o seu agente do Teams ou projeto de aplicação.

Para saber mais sobre como criar um novo agente ou aplicação, consulte Criar o seu primeiro agente ou aplicações no Teams.
No painel esquerdo, selecione Executar e Depurar (Ctrl+Shift+D) e selecione Depurar no Teams (Ambiente de Trabalho) na lista pendente.
Certifique-se de que o início de sessão no ambiente de trabalho do Teams corresponde à sua conta do Microsoft 365 utilizada no Toolkit de Agentes e, em seguida, selecione Continuar.

Pedidos de cliente de ambiente de trabalho do Teams para adicionar a sua aplicação.
Selecione Adicionar.

É aberta uma janela de chat.
Na área de composição de mensagens, envie uma mensagem para invocar o bot.

Observação

A notificação ao nível do sistema para a correspondência de contas aparece apenas uma vez por projeto. Nas sessões de depuração subsequentes, o Toolkit de Agentes envia lembretes sobre a conta através de notificações do VS Code.
Pode adicionar pontos de interrupção e recarregar frequentemente as alterações. No exemplo seguinte, o ponto de interrupção é realçado com o ponto vermelho junto ao número da linha.