Depurar seu aplicativo Teams localmente

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

Depurar seu aplicativo do Teams localmente para o Visual Studio Code

O Agents Toolkit no Microsoft Visual Studio Code oferece os recursos para automatizar a depuração do seu aplicativo do Teams localmente. O Visual Studio Code permite depurar a guia, o bot e a extensão de mensagem. Você precisa configurar o Agents Toolkit antes de depurar seu aplicativo.

Configurar o Agents Toolkit para depuração

As etapas a seguir ajudam você a configurar seu Kit de ferramentas de agentes antes de iniciar o processo de depuração:

npm run prepare-storage:atk

Depurar seu aplicativo

Após o processo de configuração inicial, o Agents Toolkit inicia os seguintes processos:

• Inicia serviços de aplicativo
• Inicia configurações de depuração
• Carrega o aplicativo Teams

Inicia serviços de aplicativo

Executa tarefas conforme definido no .vscode/tasks.json. Por padrão, o nome da tarefa é "Start application". Se o projeto contiver mais de um componente, haverá mais tarefas dependentes.

// .vscode/tasks.json
{
    "label": "Start application",
    "dependsOn": [
        "Start Frontend", // Tab
        "Start Backend", // Azure Functions
        "Start Bot" // Bot or message extensions
    ]
}

A imagem a seguir exibe nomes de tarefas nas guias OUTPUT e TERMINAL do Visual Studio Code ao executar a guia, bot ou extensão de mensagem e o Azure Functions.

Iniciar túnel local

Use o túnel de desenvolvimento como um serviço de túnel local para tornar público o ponto de extremidade da mensagem do bot local.

Túnel de desenvolvimento

Para migrar manualmente sua tarefa de túnel local de um projeto v4, atualize o .vscode/tasks.json seguinte código no arquivo:

{
      "label": "Start local tunnel",
      "type": "teamsfx",
      "command": "debug-start-local-tunnel",
      "args": {
          "type": "dev-tunnel",
          "ports": [
              {
                  "portNumber": 3978,
                  "protocol": "http",
                  "access": "public",
                  "writeToEnvironmentFile": {
                      "endpoint": "BOT_ENDPOINT",
                      "domain": "BOT_DOMAIN"
                  }
              }
        ],
          "env": "local"
      },
      "isBackground": true,
      "problemMatcher": "$teamsfx-local-tunnel-watch"
    },

Para usar outra porta para o serviço de bot local, altere o portNumber no arquivo e altere também o portNumberindex.js no arquivo ouindex.ts..vscode/tasks.json

A tabela a seguir lista os argumentos necessários:

O ports argumento deve ser uma matriz de objetos, com cada objeto especificando a configuração de uma porta específica. Cada objeto deve conter os seguintes campos:

O writeToEnvironmentFile objeto contém dois campos:

Quando writeToEnvironmentFile é incluída, as variáveis de ambiente especificadas são gravadas no .env arquivo. Quando o campo é omitido, nenhuma variável de ambiente é gravada no arquivo.

Inicia configurações de depuração

Inicia as configurações de depuração conforme definido no .vscode/launch.json.

A tabela a seguir lista os nomes e tipos de configuração de depuração para o projeto com guia, bot ou aplicativo de extensão de mensagem e o Azure Functions:

A tabela a seguir lista os nomes e tipos de configuração de depuração para o projeto com o aplicativo de bot, o Azure Functions e sem o aplicativo de guia:

Carrega o aplicativo Teams

A configuração Anexar ao front-end ou Iniciar aplicativo inicia a instância do navegador Microsoft Edge ou Chrome para carregar o cliente do Teams na página da Web. Depois que o cliente do Teams for carregado, carregue o aplicativo do Teams que é controlado pela URL de carregamento definida nas configurações de inicialização do Microsoft Teams.

Quando o cliente do Teams for aberto no navegador da Web, execute as seguintes etapas:

1. Selecione Adicionar para carregar o aplicativo no Teams.

   

2. Selecione Abrir para abrir o aplicativo no escopo pessoal.

   Como alternativa, você pode pesquisar e selecionar o escopo necessário ou selecionar um canal ou chat na lista e percorrer a caixa de diálogo para selecionar Ir.

   

   Seu aplicativo foi adicionado ao Teams!

Próxima etapa

Confira também

• Visão geral do Kit de Ferramentas de Agentes do Microsoft 365
• Introdução ao Azure Functions
• Use o Agents Toolkit para provisionar recursos na nuvem
• Adicionar guias de instruções ao aplicativo Teams
• Implantar na nuvem
• Gerenciar vários ambientes no Agents Toolkit