Criar um agente de motor 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 agente de motor 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 agente de motor personalizado com o Teams Toolkit.
• Como interagir com os seus LLMs e dados.
• A estrutura do diretório do agente do motor personalizado.

Pré-requisitos

• 6 minutos restantes

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

Configurar os seus dados no Azure OpenAI

• 5 minutos restantes

1. Aceda a portal do Azure.

2. Selecione o serviço Azure OpenAI que criou no pré-requisito.

3. Selecione Aceder ao Azure OpenAI Studio.

   

4. 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

5. Selecione Criar.

   

6. Selecione Chat>Adicionar uma origem de dados.

7. Na lista pendente, selecione Carregar ficheiros (pré-visualização).

8. Selecione Criar um novo recurso de armazenamento de Blobs do Azure e siga as instruções apresentadas no ecrã.

9. Selecione Criar um novo recurso da Pesquisa de IA do Azure e siga as instruções apresentadas no ecrã.

10. 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.

11. Introduza um nome de índice exclusivo e selecione Seguinte.

    

12. 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.

13. Selecione as Definições de gestão de dados como predefinição e selecione Seguinte.

14. Selecione Guardar e fechar.

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

Criar o agente do motor personalizado

• 4 minutos restantes

1. Aceda a Visual Studio Code.

2. Selecione o ícone Do Teams Toolkit na Barra de Atividade do Visual Studio Code.

3. Selecione Criar uma Nova Aplicação.

   

4. Selecione Agente do Motor Personalizado.

   

5. Selecione Chatbot básico de IA.

   

6. Selecione JavaScript como linguagem de programação.

   

7. Selecione Azure OpenAI.

   

8. Introduza os valores do portal do Azure:

   • Tecla Azure OpenAI

   • Ponto final do Azure OpenAI

   • Nome da implementação

9. Em alternativa, pode preencher estes detalhes mais tarde no ficheiro assim que o env/.env.testtool.user agente do motor personalizado for criado.

10. Selecione uma pasta que contenha a pasta raiz do projeto e introduza um nome adequado para o agente do motor personalizado.

11. Selecione Enter. O agente do motor personalizado é criado em alguns segundos.

Faça um tour pelo código-fonte

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

Configurar o agente do motor personalizado

• 3 minutos restantes

Vamos personalizar o pedido do agente do motor personalizado.

1. 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. 
   

   

2. 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"
                      }
                }
          }
        ]
   

3. Aceda ao src/app/app.js ficheiro e adicione a seguinte variável dentro de OpenAIModel:

   azureApiVersion: '2024-02-15-preview'
   

4. No painel esquerdo, selecione Executar e Depurar (Ctrl+Shift+D).

5. Selecione Depurar na Ferramenta de Teste (Pré-visualização).

6. Selecione a tecla F5 .

   

7. O agente do motor 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 agente do motor personalizado para saber mais sobre os seus dados.

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.