Depurar processo em segundo plano

O processo de depuração envolve os .vscode/launch.json arquivos e .vscode/tasks.json para configurar os depuradores no Microsoft Visual Studio Code. O Visual Studio Code inicia o depurador do nó e o depurador do navegador, e o Microsoft Edge ou o Google Chrome inicia uma nova instância do navegador.

O fluxo de trabalho do processo de depuração é o seguinte:

1. launch.jsonconfigura o depurador no Visual Studio Code.

2. O Visual Studio Code executa o preLaunchTask composto, Iniciar o aplicativo Teams localmente no .vscode/tasks.json arquivo.

3. Visual Studio Code, em seguida, inicia os depuradores especificados nas configurações compostas, como Anexar ao Bot, Anexar ao back-end, Anexar ao front-ende Iniciar bot.

4. O depurador do navegador, Microsoft Edge ou Google Chrome, inicia uma nova instância do navegador e abre uma página da Web para carregar o cliente do Microsoft Teams.

Validar pré-requisitos

A Microsoft verifica os seguintes pré-requisitos durante o processo de depuração:

• O Microsoft 365 Agents Toolkit (anteriormente conhecido como Teams Toolkit) verifica se Node.js está instalado. Se Node.js não estiver instalado, a depuração será encerrada.

• O Agents Toolkit verifica se Node.js versão corresponde às versões definidas no package.json arquivo. Se a versão não corresponder, o Agents Toolkit exibirá uma mensagem de aviso no canal de saída.

• O Agents Toolkit solicita que você entre na conta do Microsoft 365, se você ainda não tiver entrado com suas credenciais válidas.

• O upload de aplicativo personalizado para seu locatário de desenvolvedor é ativado para evitar o encerramento da depuração local.

• Se o Ngrok não estiver instalado ou a versão não corresponder ao requisito, o Agents Toolkit instalará o pacote ngrok@4.2.2 npm do Ngrok em ~/.fx/bin/ngrok. A versão binária 2.3 do Ngrok é aplicável para extensão de bot e mensagem e é gerenciada pelo pacote Ngrok npm em /.fx/bin/ngrok/node modules/ngrok/bin.

  Observação

  Os modelos de projeto do Agents Toolkit usam o pacote npm ngrok@4.3.3, que contém a v2.3.40. Para obter mais informações sobre como obter uma licença válida, consulte ngrok.

• Se o Azure Functions Core Tools versão 4 não estiver instalado ou a versão não corresponder ao requisito, o Agents Toolkit instalará o pacote azure-functions-core-tools@3 npm do Azure Functions Core Tools para Windows e macOS no ~/.fx/bin/funcformato . O pacote npm do Azure Functions Core Tools gerencia ~/.fx/bin/func/node_modules/azure-functions-core-tools/bin o binário do Azure Functions Core Tools. Para Linux, a depuração local é encerrada.

• Se o SDK do .NET Core não estiver instalado ou a versão não corresponder ao requisito, o Kit de Ferramentas de Agentes instalará o SDK do .NET Core para Windows e macOS no ~/.fx/bin/dotnet. A versão do SDK do .NET Core é aplicável para o Azure Functions. Para Linux, a depuração local é encerrada.

  A tabela a seguir lista as versões do .NET Core:

  Plataforma	Software
  Windows, macOS (x64) e Linux	3.1 (recomendado), 5.0, 6.0
  macOS (arm64)	6.0

• Se o certificado de desenvolvimento do localhost não estiver instalado para a guia no Windows ou no macOS, o Agents Toolkit solicitará que você o instale.

• Se as extensões de associação do Azure Functions não estiverem instaladas, o Agents Toolkit instalará as extensões de associação do Azure Functions no api/extensions.csproj.

• Se os pacotes npm não estiverem instalados, o Agents Toolkit instalará todos os pacotes npm aplicáveis ao aplicativo de guia, ao aplicativo de bot, à extensão de mensagem e ao Azure Functions.

• O Agents Toolkit inicia o Ngrok para criar um túnel HTTP para o bot e a extensão de mensagem.

• Se a guia, o bot, a extensão de mensagem e as portas do Azure Functions não estiverem disponíveis, a depuração local será encerrada.

  A tabela a seguir lista as portas disponíveis para componentes:

  Componente	Porta
  Tab	53000
  Extensão de bot ou mensagem	3978
  Inspetor de nó para bot ou extensão de mensagens	9239
  Azure Functions	7071
  Inspetor de nó para Azure Functions	9229

Quando você seleciona Iniciar Depuração (F5), o canal de saída do Kit de Ferramentas de Agentes exibe o progresso e o resultado depois de verificar os pré-requisitos.

Para obter mais informações, consulte a tarefa validar pré-requisitos.

Iniciar túnel local

Para a extensão de bot e mensagem, o Agents Toolkit inicia um serviço de túnel local para tornar público o ponto de extremidade de mensagens do bot. Para obter mais informações, consulte iniciar tarefa de túnel local.

Criar os recursos de depuração

O Kit de Ferramentas de Agentes executa o ciclo de vida provision definido para m365agents.local.yml criar recursos relacionados ao aplicativo do Teams necessários para depuração. Para obter mais informações, consulte Tarefa de provisionamento e ações disponíveis.

Compilar projeto

O Agents Toolkit executa o ciclo de vida deploy definido no m365agents.local.yml para criar o projeto. Para obter mais informações, consulte Implantar tarefa e ações disponíveis.

Faça um tour pelo código-fonte do aplicativo

Você pode exibir as pastas e arquivos do projeto no Explorer no Visual Studio Code após a depuração. A tabela a seguir lista os arquivos relacionados à depuração:

Para obter mais informações sobre a estrutura de pastas do projeto, consulte Projeto Agents Toolkit.

Confira também

• Visão geral do Kit de Ferramentas de Agentes do Microsoft 365
• Depurar seu aplicativo do Teams usando o Kit de Ferramentas de Agentes
• Use o Agents Toolkit para provisionar recursos na nuvem
• Implantar na nuvem
• Visualizar e personalizar o manifesto do aplicativo