Criar um novo aplicativo de Teams

Saiba como criar aplicativos do Microsoft Teams usando o Visual Studio Code e o Kit de Ferramentas de Agentes do Microsoft 365. Este guia orienta você pelo processo de criação de um aplicativo básico do Teams, explorando suas estruturas de diretório e aproveitando os modelos disponíveis. Se você está começando com um aplicativo simples "Olá, Mundo", criando aplicativos para automatizar tarefas ou estendendo os recursos do Teams no Microsoft 365, este artigo fornece instruções para ajudá-lo a começar.

Criar um agente do Teams com o Kit de Ferramentas de Agentes

Criar um agente do Teams com o Kit de Ferramentas de Agentes Você pode criar os seguintes tipos de aplicativo do Teams:

Tipos de aplicativos Definição
Aplicativos básicos do Teams Os aplicativos básicos do Teams incluem aplicativos de guia, bot ou extensão de mensagem do Teams que você pode criar e personalizar com base em suas necessidades.
Suplementos do Office Esse grupo de suplementos pode ser instalado e executado no Outlook e no Office.com.

Criar um novo aplicativo do Teams usando o Visual Studio Code

O processo de criação de um novo aplicativo do Teams é semelhante para todos os tipos de aplicativos. Para criar um aplicativo básico do Teams:

  1. Abra o Visual Studio Code.

  2. Selecione o Kit de Ferramentas > de Agentes do Microsoft 365Criar um Novo Agente/Aplicativo> selecione Teams, Agentes e Aplicativos.

    A captura de tela mostra a opção de criar um novo agente ou aplicativo na barra lateral do Kit de ferramentas para agentes.

  3. Selecione Outros Recursos do Teams.

    A captura de tela mostra a opção de selecionar os outros Recursos do Teams.

  4. Neste exemplo, selecione Tab como funcionalidade do aplicativo.

    A captura de tela mostra a opção para selecionar a funcionalidade do aplicativo que você deseja compilar.

  5. Selecione a pasta padrão para armazenar a pasta raiz do projeto no local padrão.

    A captura de tela mostra a opção de selecionar o local padrão para o espaço de trabalho do projeto.

    Para alterar o local padrão, siga estas etapas:

    1. Selecione Procurar.

    2. Selecione o local para o espaço de trabalho do projeto.

      A pasta selecionada é o local do seu espaço de trabalho do projeto.

  6. Insira um nome adequado, como helloworld, como o nome do aplicativo. Certifique-se de usar apenas caracteres alfanuméricos. Pressione Enter.

    A captura de tela mostra o campo para inserir o nome do aplicativo.

    O espaço de trabalho do aplicativo de guia do Teams é criado em poucos segundos.

    A captura de tela mostra que o espaço de trabalho do projeto foi criado.

Tive um problema

Estrutura de diretórios para diferentes tipos de aplicativo

O Agents Toolkit fornece todos os componentes para a criação de um aplicativo. Depois de criar o espaço de trabalho do projeto, você pode exibir as pastas e arquivos do projeto na seção EXPLORER .


Estrutura de diretório para o aplicativo básico do Teams

O exemplo a seguir mostra uma estrutura básica de diretório do aplicativo de guia do Teams:

Nome da pasta Conteúdos
.vscode Configurações do VS Code para criar e depurar seu aplicativo do Teams.
appPackage Arquivo de manifesto do aplicativo (anteriormente chamado de manifesto do aplicativo do Teams) e arquivos de ícone que o Teams usou para reconhecer seu aplicativo do Teams.
env Armazena diferentes parâmetros de ambiente.
infra bicep Arquivos de modelo do Azure. Usado para implantar seu aplicativo do Teams no Azure.
src O código-fonte do recurso Guia, incluindo seu aplicativo front-end, componentes da interface do usuário e o aviso de privacidade, os termos de uso,
src/app.js Ponto de entrada do aplicativo e express manipuladores para o site.
src/views/hello.html Um modelo HTML que é associado ao ponto de extremidade da guia.
src/static O servidor Web pode servir ativos estáticos, como arquivos CSS e JavaScript.
m365agents.yml Este arquivo de configuração define o comportamento do Agents Toolkit para provisionar, implantar e publicar o ciclo de vida. Você pode personalizar esse arquivo para alterar o comportamento do Agents Toolkit em cada ciclo de vida.
m365agents.local.yml Isso substitui m365agents.yml por ações que permitem a execução local e a depuração.

Observação

Se você tiver um bot ou um aplicativo de extensão de mensagem, as pastas relevantes serão adicionadas à estrutura de diretórios.

Para saber mais sobre a estrutura de diretórios de diferentes tipos de aplicativos básicos do Teams, consulte a tabela a seguir:

Tipo de aplicativo Links
Para o aplicativo de guia Crie seu primeiro aplicativo de guia usando JavaScript
Para aplicativo de bot Crie seu primeiro aplicativo de bot usando JavaScript
Para o aplicativo de extensão de mensagem Criar seu primeiro aplicativo de extensão de mensagem usando JavaScript

Para experimentar mais guias passo a passo sobre como criar aplicativos, consulte Tutoriais.

Confira também

  • Last updated on