Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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
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.
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.
No painel esquerdo, selecione Executar e Depurar (
Ctrl+Shift+D) e selecione Depurar no Teams (Área de Trabalho) na lista suspensa.
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.
Solicitações de cliente de área de trabalho do Teams para adicionar seu aplicativo.
Selecione Adicionar.
Uma janela de bate-papo é aberta.
Na área de redação da mensagem, envie uma mensagem para invocar o bot.
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.
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.
Você pode continuar a depurar seu aplicativo agente de mecanismo personalizado no cliente de desktop do Teams.