Tutorial - Criar Copilot Personalizado - Teams

Este tutorial mostra como criar um copilot personalizado com a biblioteca de IA do Teams com o Teams Toolkit para conversar com os seus dados no Azure OpenAI. A biblioteca de IA do Teams simplifica o processo de criação de aplicações inteligentes do Teams com os componentes de IA e os Modelos de Linguagem Grande (LLMs) da sua preferência.

Neste tutorial, irá aprender:

Como configurar os seus dados no Azure OpenAI.
Como criar um novo co-piloto personalizado com o Teams Toolkit.
Como interagir com os seus LLMs e dados.
A estrutura de diretório do seu co-piloto personalizado.

Pré-requisitos

6 minutos restantes

Certifique-se de que instala as seguintes ferramentas para criar e implementar as suas aplicações:

	Instalar	Para usar...
	Kit de ferramentas do Teams	Uma extensão do Microsoft Visual Studio Code que cria um projeto estruturado para a sua aplicação. Utilize a versão mais recente.
	Node.js e NPM	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 Edge (recomendado) ou Google Chrome	Um navegador com ferramentas de desenvolvedor.
	Visual Studio Code	Ambientes de compilação JavaScript, TypeScript ou Estrutura do SharePoint (SPFx). Utilize a versão mais recente.
	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 Azure, tem de criar um serviço Azure OpenAI.

Configurar os seus dados no Azure OpenAI

5 minutos restantes

Aceda ao Portal do Azure.
Selecione o serviço Azure OpenAI que criou no pré-requisito.
Selecione Aceder ao Azure OpenAI Studio.
Selecione Chat>Criar nova implementação.

Atualize os valores dos seguintes campos:
- Selecionar um modelo: gpt-35-turbo
- Versão do modelo: Atualizar automaticamente para predefinição
- Tipo de implementação: Standard
- Nome da implementação: gpt-35-turbo
- Filtro de Conteúdo: predefinição
Selecione Criar.
Selecione Chat>Adicionar uma origem de dados.
Na lista pendente, selecione Carregar ficheiros (pré-visualização).
Selecione Criar um novo recurso de armazenamento de Blobs do Azure e siga as instruções apresentadas no ecrã.
Selecione Criar um novo recurso da Pesquisa de IA do Azure e siga as instruções apresentadas no ecrã.
Selecione o armazenamento de Blobs do Azure recentemente criado e a Pesquisa de IA do Azure na lista pendente.

Observação

Guarde o ponto final e os detalhes principais da Pesquisa de IA do Azure, uma vez que são necessários para os passos subsequentes.
Introduza um nome de índice exclusivo e selecione Seguinte.
Selecione Procurar um ficheiro e carregue os ficheiros que prefere utilizar como dados e, em seguida, selecione Carregar ficheiros.

Observação

Os ficheiros têm de estar no .txtformato , .md, .html, .pdf, .docxou .pptx com um limite de tamanho de 16 MB.
Selecione as Definições de gestão de dados como predefinição e selecione Seguinte.
Selecione Guardar e fechar.

Após a conclusão do processo de ingestão de dados, pode começar a criar o seu co-piloto personalizado com a biblioteca de IA do Teams e o Teams Toolkit.

Criar o seu co-piloto personalizado

4 minutos restantes

Aceda ao Visual Studio Code.
Selecione o ícone Do Teams Toolkit na Barra de Atividade do Visual Studio Code.
Selecione Criar uma Nova Aplicação.
Selecione Copilot Personalizado.
Selecione Chatbot básico de IA.
Selecione JavaScript como linguagem de programação.
Selecione Azure OpenAI.
Introduza os valores do portal do Azure:
- Tecla Azure OpenAI
- Ponto final do Azure OpenAI
- Nome da implementação
Em alternativa, pode preencher estes detalhes mais tarde no env/.env.testtool.user ficheiro assim que o copilot personalizado for criado.
Selecione uma pasta que contenha a pasta raiz do projeto e introduza um nome adequado para o copilot personalizado.
Selecione Enter. O co-piloto personalizado é criado em poucos segundos.

Faça um tour pelo código-fonte

Veja o que está dentro deste modelo > personalizado do Chatbot de IA Básico.

Nome da pasta	Conteúdos
`.vscode`	Ficheiros VS Code para depuração.
`appPackage`	Modelos para o manifesto de aplicação do Teams.
`env`	Os pares de nomes ou valores são armazenados em ficheiros de ambiente e utilizados por teamsapp.yml para personalizar as regras de aprovisionamento e implementação.
`infra`	Modelos para aprovisionar recursos do Azure.
`src/`	O código fonte da aplicação do Teams de notificação.
`src/index.js`	Configura o servidor da aplicação de bot.
`src/adapter.js`	Configura o adaptador de bot.
`src/config.js`	Define as variáveis de ambiente.
`src/prompts/chat/skprompt.txt`	Define o pedido.
`src/prompts/chat/config.json`	Configura o pedido.
`src/app/app.js`	Processa lógicas de negócio para o Chatbot básico de IA.
`teamsapp.yml`	O ficheiro de projeto principal descreve a configuração da aplicação e define o conjunto de ações a executar em cada fase do ciclo de vida.
`teamsapp.local.yml`	Esta substituição pelas `teamsapp.yml` ações que permitem a execução local e a depuração.
`teamsapp.testtool.yml`	Esta substituição pelas `teamsapp.yml` ações que permitem a execução local e a depuração na Ferramenta de Teste de Aplicações do Teams.

Configurar o copilot personalizado

3 minutos restantes

Vamos personalizar o pedido para o seu co-piloto personalizado.

Aceda a src/prompts/chat/skprompt.txt e atualize o seguinte código no skprompt.txt ficheiro:

The following is a conversation with an AI assistant, who is an expert on answering questions over the given context.
Responses should be in a short journalistic style with no more than 80 words.

Captura de ecrã a mostrar skprompt no explorador no Visual Studio Code.

Aceda ao config.json ficheiro em prompts/chat. Adicione o seguinte código dentro dos completion parênteses retos e substitua os endpointvalores e index_namekey pelos detalhes do recurso do Azure AI Search:

   "data_sources": [
     {
            "type": "azure_search",
            "parameters": {
                 "endpoint": "AZURE-AI-SEARCH-ENDPOINT",
                 "index_name": "YOUR-INDEX_NAME",
                 "authentication": {
                       "type": "api_key",
                       "key": "AZURE-AI-SEARCH-KEY"
                   }
             }
       }
     ]

Aceda ao src/app/app.js ficheiro e adicione a seguinte variável dentro de OpenAIModel:
```
azureApiVersion: '2024-02-15-preview'
```
No painel esquerdo, selecione Executar e Depurar (Ctrl+Shift+D).
Selecione Depurar na Ferramenta de Teste (Pré-visualização).
Selecione a tecla F5 .
O co-piloto personalizado é executado na Ferramenta de Teste de Aplicações do Teams, que é aberta no seu browser.

Desafio completo

2 minutos restantes

Na Ferramenta de Teste de Aplicações do Teams, faça perguntas relacionadas com o seu documento e converse com o seu co-piloto personalizado para saber mais sobre os seus dados.

Captura de ecrã a mostrar a ferramenta de teste de aplicações do Teams.

Parabéns!

100% concluído!

Parabéns, concluiu este tutorial! Se estiver interessado em saber mais sobre o código fonte, visite Exemplo do Azure OpenAI no repositório gitHub da biblioteca de IA do Teams.

Compartilhar via

Criar um copilot personalizado para conversar com os seus dados com a biblioteca de IA do Teams e o Toolkit do Teams