Criar um copilot personalizado para conversar com os seus dados com a biblioteca de IA do Teams e o Toolkit do 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
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
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
.txt
formato ,.md
,.html
,.pdf
,.docx
ou.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
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
Vamos personalizar o pedido para o seu co-piloto personalizado.
Aceda a
src/prompts/chat/skprompt.txt
e atualize o seguinte código noskprompt.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.
Aceda ao
config.json
ficheiro emprompts/chat
. Adicione o seguinte código dentro doscompletion
parênteses retos e substitua osendpoint
valores eindex_name
key
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 deOpenAIModel
: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
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.
Parabéns!
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.
Tem algum problema com essa seção? Se tiver, envie seus comentários para que possamos melhorar esta seção.