Guia de introdução da biblioteca de IA do Teams

Comece a utilizar a biblioteca de IA do Teams com o exemplo do LightBot, que foi concebido para o ajudar no processo de criação de aplicações que podem controlar luzes, como ativá-las e desativá-las através da biblioteca de IA do Teams. O bot utiliza o modelo gpt-3.5-turbo para conversar com os utilizadores do Microsoft Teams e responder de forma educada e respeitosa, mantendo-se dentro do âmbito da conversação.

Pré-requisitos

Para começar, certifique-se de que tem as seguintes ferramentas:

Instalar	Para usar...
Visual Studio Code	Ambientes de compilação JavaScript, TypeScript e Python. Utilize a versão mais recente.
Kit de ferramentas do Teams	Extensão do Microsoft Visual Studio Code que cria um projeto estruturado para a sua aplicação. Utilize a versão mais recente.
Git	O Git é um sistema de controlo de versões que o ajuda a gerir diferentes versões de código num repositório.
Node.js	Ambiente de runtime do JavaScript de back-end. Para obter mais informações, veja Node.js tabela de compatibilidade de versões para o tipo de projeto.
Microsoft Teams	Para colaborar com todas as pessoas, trabalha com aplicações para conversar por chat, reuniões e ligar para todos num único local.
OpenAI ou Azure OpenAI	Primeiro, crie a chave da API OpenAI para utilizar o GPT da OpenAI. Se quiser alojar a sua aplicação ou aceder a recursos no Microsoft Azure, tem de criar um serviço Azure OpenAI.
Microsoft Edge (recomendado) ou Google Chrome	Um navegador com ferramentas de desenvolvedor.
Conta de programador do Microsoft 365	Acesso à conta do Teams com as permissões adequadas para instalar uma aplicação, ativar aplicações personalizadas do Teams e ativar o carregamento de aplicações personalizadas.

Se já executou os exemplos antes ou encontrou um erro de runtime, siga estes passos para começar de novo:

• Verifique todos os .env ficheiros e env/.env.*.* no exemplo e elimine quaisquer valores preenchidos automaticamente para garantir que o Teams Toolkit gera novos recursos automaticamente.
• Se não quiser que o Teams Toolkit gere o ID e a palavra-passe da aplicação, atualize o BOT_ID e BOT_PASSWORD no ficheiro com os .env seus próprios valores.
• Remova valores ou deixe os valores em branco para SECRET_BOT_PASSWORD e TEAMS_APP_UPDATE_TIME no .env ficheiro para evitar conflitos.

O Teams Toolkit aprovisiona BOT_ID e recursos BOT_PASSWORD automaticamente. Se quiser utilizar os seus próprios recursos, tem de os adicionar manualmente ao .env ficheiro. O Teams Toolkit não gera automaticamente os seguintes recursos:

• Uma chave OpenAI ou OpenAI do Azure
• Uma base de dados ou opções de armazenamento semelhantes

Criar e executar a aplicação de exemplo

Introdução à biblioteca de IA do Teams com o exemplo do LightBot. Permite que o localhost do seu computador execute rapidamente um exemplo baseado na biblioteca de IA do Teams.

1. Aceda ao exemplo.

2. Execute o seguinte comando para clonar o repositório:

   git clone https://github.com/microsoft/teams-ai.git
   

3. Aceda ao Visual Studio Code.

4. SelecioneAbrir Pasta de Ficheiros>.

5. Aceda à localização onde clonou o repositório teams-ai e selecione a pasta teams-ai .

6. Selecione Selecionar Pasta.

   

7. Selecione Ver>Terminal. É aberta uma janela de terminal.

8. Na janela do terminal, execute o seguinte comando para aceder à pasta js :

   cd .\js\
   

9. Execute o seguinte comando para instalar dependências:

   yarn install
   

10. Execute o seguinte comando para criar dependências:

    yarn build
    

11. Após a instalação das dependências, selecioneAbrir Pasta de Ficheiros>.

12. Aceda a teams-ai > js > samples> 03.ai-concepts> c.actionMapping-lightBot e selecione Selecionar Pasta. Todos os ficheiros do exemplo do LightBot estão listados na secção EXPLORER no Visual Studio Code.

13. Atualize os seguintes passos com base nos serviços de IA que selecionar.

    Tecla OpenAI

    1. Aceda à env pasta e atualize o seguinte código no ./env/.env.local.user ficheiro:

        SECRET_OPENAI_KEY=<your OpenAI key>
       

    2. Aceda à infra pasta e certifique-se de que as seguintes linhas no azure.bicep ficheiro são comentadas:

           // {
           //   name: 'AZURE_OPENAI_KEY'
           //   value: azureOpenAIKey
           // }
           // {
           //   name: 'AZURE_OPENAI_ENDPOINT'
           //   value: azureOpenAIEndpoint
           // }
       

    Azure OpenAI

    1. Aceda à env pasta e atualize o seguinte código no ./env/.env.local.user ficheiro:

       SECRET_AZURE_OPENAI_KEY=<your Azure OpenAI key>
       SECRET_AZURE_OPENAI_ENDPOINT=<your Azure OpenAI Endpoint>
       

    2. Aceda ao teamsapp.local.yml ficheiro e modifique o último passo para utilizar as variáveis do Azure OpenAI:

          - uses: file/createOrUpdateEnvironmentFile
            with:
             target: ./.env
             envs:
             BOT_ID: ${{BOT_ID}}
             BOT_PASSWORD: ${{SECRET_BOT_PASSWORD}}
             #OPENAI_KEY: ${{SECRET_OPENAI_KEY}}
             AZURE_OPENAI_KEY: ${{SECRET_AZURE_OPENAI_KEY}}
             AZURE_OPENAI_ENDPOINT: ${{SECRET_AZURE_OPENAI_ENDPOINT}}
       

    3. Aceda à infra pasta e certifique-se de que as seguintes linhas no azure.bicep ficheiro são comentadas:

           // {
           //  name: 'OPENAI_KEY'
           //  value: openAIKey
           // }
       

    4. Aceda a infra>azure.parameters.json e substitua as linhas de 20 a 22 pelo seguinte código:

          "azureOpenAIKey": {
          "value": "${{SECRET_AZURE_OPENAI_KEY}}"
          },
          "azureOpenAIEndpoint": {
          "value": "${{SECRET_AZURE_OPENAI_ENDPOINT}}"
          }
         ```
       

14. No painel esquerdo, selecione Teams Toolkit.

15. Em CONTAS, inicie sessão no seguinte:

    • Conta do Microsoft 365
    • Conta do Azure

16. Para depurar a sua aplicação, selecione a chave F5 .

    Um separador do browser abre um cliente Web do Teams a pedir para adicionar o bot ao seu inquilino.

17. Selecione Adicionar.

    

    É aberta uma janela de chat.

18. Na área de composição de mensagens, envie uma mensagem para invocar o bot.

    

Observação

Se estiver a criar um bot pela primeira vez, recomenda-se que utilize a extensão Do Teams Toolkit para o Visual Studio Code para criar um bot. Veja Criar a sua primeira aplicação de bot com JavaScript.

Pré-requisitos

Para começar, certifique-se de que tem as seguintes ferramentas:

Instalar	Para usar...
Visual Studio	C Ambientes de compilação sharp. Utilize a versão mais recente.
Kit de ferramentas do Teams	Extensão do Microsoft Visual Studio Code que cria um projeto estruturado para a sua aplicação. Utilize a versão mais recente.
Git	O Git é um sistema de controlo de versões que o ajuda a gerir diferentes versões de código num repositório.
Microsoft Teams	Para colaborar com todas as pessoas, trabalha com as aplicações para conversar por chat, reuniões e ligar para todos num único local.
OpenAI ou Azure OpenAI	Primeiro, crie a chave da API OpenAI para utilizar o GPT da OpenAI. Se quiser alojar a sua aplicação ou aceder a recursos no Microsoft Azure, tem de criar um serviço Azure OpenAI.
Microsoft Edge (recomendado) ou Google Chrome	Um navegador com ferramentas de desenvolvedor.
Conta de programador do Microsoft 365	Acesso à conta do Teams com as permissões adequadas para instalar uma aplicação, ativar aplicações personalizadas do Teams e ativar o carregamento de aplicações personalizadas.

Se já executou os exemplos antes ou encontrou um erro de runtime, siga estes passos para começar de novo:

• Verifique todos os .env ficheiros e env/.env.*.* no exemplo e elimine quaisquer valores preenchidos automaticamente para garantir que o Teams Toolkit gera novos recursos automaticamente.
• Se não quiser que o Teams Toolkit gere o ID e a palavra-passe da aplicação, atualize o MicrosoftAppId e MicrosoftAppPassword no ficheiro com os .env seus próprios valores.
• Remova valores ou deixe os valores em branco para SECRET_BOT_PASSWORD e TEAMS_APP_UPDATE_TIME no .env ficheiro para evitar conflitos.

O Teams Toolkit aprovisiona MicrosoftAppId e recursos MicrosoftAppPassword automaticamente. Se quiser utilizar os seus próprios recursos, tem de os adicionar manualmente ao .env ficheiro. O Teams Toolkit não gera automaticamente os seguintes recursos:

• Uma chave OpenAI ou OpenAI do Azure
• Uma base de dados ou opções de armazenamento semelhantes

Criar e executar a aplicação de exemplo

1. Aceda ao exemplo.

2. Clone o repositório para testar a aplicação de exemplo.

   git clone https://github.com/microsoft/teams-ai.git
   

3. Aceda à pasta dotnet .

   cd teams-ai/dotnet
   

4. Aceda à pasta onde clonou o repositório e selecione 04.ai.c.actionMapping.lightBot.

5. Selecione LightBot.sln. A solução é aberta no Visual Studio.

6. No Visual Studio, atualize as definições relacionadas com o OpenAI no appsettings.Development.json ficheiro.

   "Azure": {
   "OpenAIApiKey": "<your-azure-openai-api-key>",
   "OpenAIEndpoint": "<your-azure-openai-endpoint>"
   },
   

7. Aceda a Prompts/sequence/skprompt.txt e atualize o seguinte código no skprompt.txt ficheiro:

   The following is a conversation with an AI assistant. 
   The assistant can turn a light on or off.
   The assistant must return the following JSON structure:
   
   {"type":"plan","commands":[{"type":"DO","action":"<name>","entities":{"<name>":<value>}},{"type":"SAY","response":"<response>"}]}
   
   The following actions are supported:
   
   - LightsOn
   - LightsOff
   - Pause time=<duration in ms>
   - LightStatus
   
   The lights are currently {{getLightStatus}}.
   
   Always respond in the form of a JSON based plan. Stick with DO/SAY.
   

8. No menu pendente de depuração, selecione Túneis> DevCriar um Túnel...

   

9. Selecione a Conta a utilizar para criar o túnel. As contas do Azure, da Conta Microsoft (MSA) e do GitHub são suportadas. Atualize as seguintes opções:

   1. Nome: introduza um nome para o túnel.
   2. Tipo de Túnel: selecione Persistente ou Temporário.
   3. Acesso: selecione Público.
   4. Clique em OK. O Visual Studio apresenta uma mensagem de confirmação a indicar que é criado um túnel.

   O túnel que criou está listado em Túneis > Dev (nome do túnel).

10. Aceda ao Explorador de Soluções e selecione o seu projeto.

11. Clique com o botão direito do rato no menu e selecione Teams Toolkit>Preparar Dependências de Aplicações do Teams.

    

    Se lhe for pedido, inicie sessão na sua conta do Microsoft 365. Recebe uma mensagem a informar que as dependências da aplicação Teams estão preparadas com êxito.

12. Clique em OK.

13. Selecione F5 ou selecione Depurar>Iniciar.

14. Selecione Adicionar. A aplicação é adicionada ao Teams e é aberta uma janela de chat.

    

15. Na área de composição de mensagens, envie uma mensagem para invocar o bot.

    

Também pode implementar os exemplos no Azure com o Teams Toolkit. Para implementar, siga estes passos:

1. No Visual Studio, aceda a Explorador de Soluções e selecione o projeto.
2. Clique com o botão direito do rato no menu e selecioneAprovisionamento doTeams Toolkit> na Cloud. O Toolkit aprovisiona o seu exemplo no Azure.
3. Clique com o botão direito do rato no menu e selecione Teams ToolkitDeploy to the Cloud (Implementar no Teams Toolkit > deploy to the Cloud).

Pré-requisitos

Para começar, certifique-se de que tem as seguintes ferramentas:

Instalar	Para usar...
Visual Studio Code	Ambientes de compilação JavaScript, TypeScript e Python. Utilize a versão mais recente.
Kit de ferramentas do Teams	Extensão do Microsoft Visual Studio Code que cria um projeto estruturado para a sua aplicação. Utilize a versão mais recente.
Python	O Python é uma linguagem de programação interpretada e orientada para objetos com semântica dinâmica. Utilize versões entre 3.8 e 4.0.
Poesia	Ferramenta de gestão de dependências e empacotamento para Python.
Extensão VSCode do Python	Fornece suporte avançado para Python no VSCode.
Git	O Git é um sistema de controlo de versões que o ajuda a gerir diferentes versões de código num repositório.
Microsoft Teams	Para colaborar com todas as pessoas, trabalha com as aplicações para conversar por chat, reuniões e ligar para todos num único local.
OpenAI ou Azure OpenAI	Primeiro, crie a chave da API OpenAI para utilizar o GPT da OpenAI. Se quiser alojar a sua aplicação ou aceder a recursos no Microsoft Azure, tem de criar um serviço Azure OpenAI.
Microsoft Edge (recomendado) ou Google Chrome	Um navegador com ferramentas de desenvolvedor.
Conta de programador do Microsoft 365	Acesso à conta do Teams com as permissões adequadas para instalar uma aplicação, ativar aplicações personalizadas do Teams e ativar o carregamento de aplicações personalizadas.

Se já executou os exemplos antes ou encontrou um erro de runtime, siga estes passos para começar de novo:

• Verifique todos os .env ficheiros e env/.env.*.* no exemplo e elimine quaisquer valores preenchidos automaticamente para garantir que o Teams Toolkit gera novos recursos automaticamente.
• Se não quiser que o Teams Toolkit gere o ID e a palavra-passe da aplicação, atualize o BOT_ID e BOT_PASSWORD no ficheiro com os .env seus próprios valores.
• Remova valores ou deixe os valores em branco para SECRET_BOT_PASSWORD e TEAMS_APP_UPDATE_TIME no .env ficheiro para evitar conflitos.

O Teams Toolkit aprovisiona BOT_ID e recursos BOT_PASSWORD automaticamente. Se quiser utilizar os seus próprios recursos, tem de os adicionar manualmente ao .env ficheiro. O Teams Toolkit não gera automaticamente os seguintes recursos:

• Uma chave OpenAI ou OpenAI do Azure
• Uma base de dados ou opções de armazenamento semelhantes

Criar e executar a aplicação de exemplo

1. Aceda ao exemplo.

2. Clone o repositório para testar a aplicação de exemplo.

   git clone https://github.com/microsoft/teams-ai.git
   

3. Aceda à pasta python .

   cd teams-ai/python
   

4. Aceda à pasta onde clonou o repositório e selecione 04.ai.c.actionMapping.lightBot. Todos os ficheiros do exemplo do LightBot estão listados na secção EXPLORER no Visual Studio Code.

5. Em EXPLORADOR, duplique o ficheiro sample.env e atualize o ficheiro duplicado para .env.

   Tecla OpenAI

   Aceda à env pasta e atualize o seguinte código no ./env/.env.local.user ficheiro:

   SECRET_OPENAI_KEY=<your OpenAI key>
   
   

   Azure OpenAI

   Aceda à env pasta e atualize o seguinte código no ./env/.env.local.user ficheiro:

   SECRET_AZURE_OPENAI_KEY=<your Azure OpenAI key>
   SECRET_AZURE_OPENAI_ENDPOINT=<your Azure OpenAI Endpoint>
   
   

6. Para instalar as seguintes dependências, aceda a Ver>Terminal e execute os seguintes comandos:

   Dependências	Comando
   python-dotenv	pip install python-dotenv
   load-dotenv	pip install load-dotenv
   teams-ai	pip install teams-ai
   botbuilder-core	pip install botbuilder-core

7. Atualize config.json e bot.py com o nome da implementação do modelo.

8. Aceda a Ver>Paleta de Comandos... ou selecione Ctrl+Shift+P.

9. Introduza Python: Criar Ambiente para criar um ambiente virtual.

10. Para depurar a sua aplicação, selecione a chave F5 .

    Um separador do browser abre um cliente Web do Teams a pedir para adicionar o bot ao seu inquilino.

11. Selecione Adicionar.

    

    É aberta uma janela de chat.

12. Na área de composição de mensagens, envie uma mensagem para invocar o bot.

    

Ferramentas adicionais

Também pode utilizar as seguintes ferramentas para executar e configurar um exemplo:

1. CLI do Teams Toolkit: pode utilizar a CLI do Teams Toolkit para criar e gerir aplicações do Teams a partir da linha de comandos. Para obter mais informações, veja Instruções de configuração da CLI do Teams Toolkit.

2. Bot Framework Emulator: o Bot Framework Emulator é uma aplicação de ambiente de trabalho que lhe permite testar e depurar o bot localmente. Pode ligar ao bot ao introduzir o URL do ponto final do bot e o ID e a palavra-passe da aplicação Microsoft. Em seguida, pode enviar mensagens para o bot e ver as respetivas respostas em tempo real. Para obter mais informações, veja Instruções de configuração do Bot Framework Emulator.

3. Configuração manual: se preferir configurar os seus recursos manualmente, pode fazê-lo seguindo as instruções fornecidas pelos respetivos serviços. Para obter mais informações, veja manual set up instructions (Instruções de configuração manual).

Próxima etapa

FAQ da biblioteca de IA do Teams