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.
Antes de criar seu projeto do Microsoft Teams, verifique se os pré-requisitos estão em vigor. Você deve:
- Instalar as ferramentas necessárias para criar seu espaço de trabalho de projeto do Teams
- Preparar Contas para criar seu projeto do Teams
- Verificar a permissão de upload de aplicativo personalizado
Instale as ferramentas necessárias para criar seu espaço de trabalho do Teams
Certifique-se de que os seguintes requisitos sejam atendidos antes de começar a criar seu agente ou aplicativo do Teams:
| Ferramentas | Objetivo | Para tipo de ambiente | |
|---|---|---|---|
| Required | |||
| Microsoft 365 Agents Toolkit (anteriormente conhecido como Teams Toolkit) | Uma extensão do Microsoft Visual Studio Code que cria um scaffolding de projeto para seu aplicativo. Use a versão mais recente. | JavaScript e TypeScript | |
| Microsoft Teams | Colabore com todos com quem você trabalha por meio de agentes ou aplicativos para chat, reuniões e chamadas - tudo em um só lugar. | JavaScript e TypeScript | |
| 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. | JavaScript e TypeScript | |
| Gerenciador de Pacotes de Nó (NPM) | Instale e gerencie pacotes para uso em aplicativos Node.js e ASP.NET Core. | JavaScript e TypeScript | |
| Microsoft Edge (recomendado) ou Google Chrome | Um navegador com ferramentas de desenvolvedor. | JavaScript e TypeScript | |
| Microsoft Visual Studio Code | Ambientes de compilação JavaScript, TypeScript ou Python (na visualização do desenvolvedor). Use a versão mais recente. | JavaScript e TypeScript | |
| Opcional | |||
| Ferramentas do Azure para o Visual Studio Code e a CLI do Azure | Acesse dados armazenados ou implante um back-end baseado em nuvem para seu aplicativo do Teams no Azure. | JavaScript | |
| Ferramentas de desenvolvedor do React para Chrome ou Ferramentas de desenvolvedor do React para Microsoft Edge | Uma extensão do DevTools do navegador para a biblioteca JavaScript do React de código aberto. | JavaScript | |
| Microsoft Graph Explorer | Uma ferramenta baseada em navegador que permite executar uma consulta de dados do Microsoft Graph. | JavaScript e TypeScript | |
| Portal do Desenvolvedor do Teams | Um portal baseado na Web para configurar, gerenciar e publicar seu agente ou aplicativo do Teams em sua organização ou na Teams Store. | JavaScript e TypeScript |
Contas para criar seu agente ou aplicativo do Teams
Verifique se você tem as seguintes contas antes de começar a criar seu agente ou aplicativo do Teams:
| Contas | Objetivo | Para tipo de ambiente |
|---|---|---|
| Conta corporativa ou de estudante do Microsoft 365 | Conta de desenvolvedor do Teams ao desenvolver um aplicativo. | JavaScript, TypeScript, Python (na versão prévia do desenvolvedor) e C#. |
| Conta do Azure | Recursos de back-end no Azure. | JavaScript, TypeScript, Python (na versão prévia do desenvolvedor) e C#. |
Dica
Se quiser que seu agente ou aplicativo tenha suporte do SharePoint, você deverá ter uma conta de administrador do site de coleta do SharePoint.
Programa para desenvolvedores do Microsoft 365
Observação
Para criar um agente ou aplicativo do Teams, você deve ter uma conta corporativa ou escolar do Microsoft 365. A conta pessoal do Microsoft 365 não pode ser usada.
Se você tiver uma assinatura do Visual Studio Enterprise ou Professional, ambos os programas incluem uma assinatura de desenvolvedor gratuita do Microsoft 365. Ele estará ativo desde que sua assinatura do Visual Studio esteja ativa. Para obter mais informações, consulte Assinatura de desenvolvedor do Microsoft 365.
Se você não tiver nenhum locatário do Microsoft 365, poderá se qualificar para uma assinatura de desenvolvedor do Microsoft 365 E5 por meio do Programa de Desenvolvedor do Microsoft 365. Para obter mais informações, consulte as Perguntas frequentes. Como alternativa, inscreva-se para uma avaliação gratuita de 1 mês ou adquira um plano do Microsoft 365.
Você pode se inscrever no programa de desenvolvedor usando um dos seguintes tipos de conta:
Conta da Microsoft para uso pessoal
A conta Microsoft fornece acesso aos produtos e serviços de nuvem da Microsoft, como Outlook, Messenger, OneDrive, MSN, Xbox Live ou Microsoft 365.
Inscreva-se em uma caixa de correio Outlook.com para criar uma conta Microsoft (conta pessoal). Você pode usar essa conta Microsoft para se inscrever no Programa de Desenvolvedores do Microsoft 365 e para acessar os serviços de nuvem da Microsoft relacionados ao consumidor ou ao Azure. Observe que essa conta Microsoft pessoal não pode ser usada diretamente para criar aplicativos do Teams; você precisará de uma conta corporativa ou de estudante do Microsoft 365 separada para isso.
Conta de trabalho da Microsoft para empresas
Essa conta fornece acesso a todos os serviços de nuvem da Microsoft de nível empresarial de pequeno, médio e grande porte. Os serviços incluem o Azure, o Microsoft Intune e o Microsoft 365.
Quando você se inscreve em um desses serviços como uma organização, um diretório baseado em nuvem é provisionado automaticamente no Microsoft Entra ID para representar sua organização.
Crie uma conta de desenvolvedor gratuita do Microsoft 365
Para criar uma conta de desenvolvedor gratuita do Microsoft 365:
- Acesse o Programa para desenvolvedores do Microsoft 365.
- Selecione Ingressar agora.
- Configure sua assinatura de conta de administrador. Para obter mais informações, consulte configurar uma assinatura da área restrita do desenvolvedor do Microsoft 365
Conta do Azure
Uma conta do Azure permite hospedar um agente ou aplicativo do Teams, ou seus recursos de back-end, no Azure usando o Kit de Ferramentas de Agentes no Visual Studio Code. Você precisará de uma assinatura do Azure se:
- Você está integrando ao Teams um agente ou aplicativo existente hospedado fora do Azure
- Você planeja hospedar recursos de back-end em outro provedor de nuvem ou em seus próprios servidores acessíveis publicamente.
Observação
Você pode usar a conta do Azure para provisionar recursos do Azure para hospedar seu agente ou aplicativo do Teams. Crie uma conta gratuita , caso ainda não tenha uma.
Uma conta do Azure não será necessária se você não estiver usando o Kit de Ferramentas de Agentes para provisionamento e implantação.
Verificar a permissão de upload de aplicativo personalizado
Depois de criar seu agente ou aplicativo, você deve carregá-lo no Teams sem distribuí-lo. Isso é chamado de upload de aplicativo personalizado. Entre em sua conta do Microsoft 365 para acessar essa opção. Você pode marcar se o carregamento de aplicativo personalizado está habilitado usando o Visual Studio Code ou o cliente do Teams.
Verificar a permissão de upload de aplicativo personalizado usando o Visual Studio Code
Dessa forma, você só poderá verificar as permissões de carregamento de aplicativos personalizados depois de criar um projeto com o Kit de Ferramentas para Agentes do Microsoft 365. Se você ainda não criou um projeto, use o cliente do Teams para marcar a permissão.
Abra o Visual Studio Code.
Selecione Microsoft 365 Agents Toolkit na barra de atividades do Visual Studio Code.
Observação
Se você não conseguir ver a opção, consulte instalar o Agents Toolkit para instalar a extensão Agents Toolkit no Visual Studio Code.
Crie um novo projeto do Kit de Ferramentas de Agentes ou abra um projeto existente.
Selecione Entrar no Microsoft 365 em CONTAS.
Verifique se você pode ver a opção Upload de Aplicativo Personalizado Habilitado , conforme mostrado na imagem a seguir:
Verificar a permissão de upload de aplicativo personalizado usando o cliente do Teams
No cliente do Teams, selecione Aplicativos>Gerenciar seus aplicativos>Carregar um aplicativo.
Verifique se você pode ver a opção Carregar um aplicativo personalizado.
Habilitar o upload de aplicativo personalizado usando o centro de administração
Se a opção de upload de aplicativo personalizado não estiver visível no Kit de Ferramentas de Agentes no Visual Studio Code ou se a opção de carregar um aplicativo personalizado não estiver disponível no Teams, isso indicará que você não tem a permissão necessária para o upload de aplicativo personalizado.
Você deve habilitar o carregamento de aplicativo personalizado no Teams, dependendo da sua função:
- Se você for um administrador do Teams, habilite a configuração de upload de aplicativo personalizado para seu locatário ou organização no centro de administração do Teams.
- Se você não for um administrador do Teams, entre em contato com o administrador para habilitar o upload personalizado do aplicativo.
Se você for um administrador do Teams (ou seja, tiver direitos de administrador), siga estas etapas no Centro de administração do Teams para habilitar o upload de aplicativo personalizado:
Acessar o Centro de administração do Microsoft 365 com suas credenciais de administrador.
Selecione o
ícone >Teams.
Observação
Pode levar até 24 horas para a opção Teams ser exibida. Você pode carregar seu aplicativo personalizado em um ambiente do Teams para teste e validação.
Entre no centro de administração do Microsoft Teams com suas credenciais de administrador.
Selecione o ícone >Políticas de configuração de
aplicativos >do Teams.
Selecione Global (padrão em toda a organização).
Defina a alternância de Carregar aplicativos personalizados como Ativada.
Selecione Salvar.
Observação
Pode levar até 24 horas para que o upload do aplicativo personalizado se torne ativo. Depois que ele estiver ativo, você poderá usar a opção Carregar um aplicativo personalizado no Teams para testar seu aplicativo. Para carregar o arquivo do pacote .zip do aplicativo, consulte Carregar aplicativos personalizados.
Verifique se você tem a permissão de upload do aplicativo usando as etapas mencionadas em verificar a permissão de upload de aplicativo personalizado.
Confira também
Colaborar conosco no GitHub
A fonte deste conteúdo pode ser encontrada no GitHub, onde você também pode criar e revisar problemas e solicitações de pull. Para obter mais informações, confira o nosso guia para colaboradores.