Introdução ao Azure OpenAI com assistentes e chamadas de função em JavaScript

Este artigo mostra-lhe como implementar e executar o guia de início rápido do Assistente sem servidor do Azure OpenAI. Este exemplo implementa uma aplicação de assistentes com JavaScript, assistentes do Serviço OpenAI do Azure com chamadas de função e Funções do Azure.

Descrição geral da arquitetura

Os Assistentes OpenAI do Azure permitem-lhe criar assistentes de IA adaptados às suas necessidades através de instruções personalizadas e aumentadas por ferramentas avançadas, como interpretador de código e funções personalizadas. Neste artigo, fornecemos um passo a passo detalhado sobre como começar a usar a API de assistentes.

Esta aplicação é construída em torno de dois componentes principais:

• Uma página HTML simples, com ficheiros CSS e JavaScript simples, alojada em Aplicações Web Estáticas do Azure.

• Uma API sem servidor desenvolvida com Funções do Azure e que utiliza o SDK de JavaScript da OpenAI. A aplicação serverless envia a definição dos assistentes, incluindo a chamada à função, para o ponto final da OpenAI. O endpoint responde com a chamada de função subsequente e os parâmetros necessários para completar essa chamada.

  • A chamada de função do exemplo simula uma chamada de API gerando um valor aleatório de ticker de ações com base no símbolo de ação enviado para a Função do Azure. Essa simulação pode ser substituída por uma API remota em sua solução.

  

Pré-requisitos

Está disponível um ambiente de contentor de desenvolvimento com todas as dependências necessárias para seguir este artigo. Você pode executar o contêiner de desenvolvimento no GitHub Codespaces (em um navegador) ou localmente usando o Visual Studio Code.

Para usar este artigo, você precisa dos seguintes pré-requisitos:

Ambiente de desenvolvimento aberto

Use as instruções a seguir para implantar um ambiente de desenvolvimento pré-configurado contendo todas as dependências necessárias para concluir este artigo.

Implantar e executar

O repositório de exemplo contém todos os arquivos de código e configuração necessários para implantar um aplicativo de função no Azure. As etapas a seguir orientam você pelo processo de implantação do exemplo no Azure.

Implantar o aplicativo de assistentes no Azure

1. Execute o seguinte comando da CLI do Desenvolvedor do Azure para provisionar os recursos do Azure e implantar o código-fonte:

   azd up
   

2. Quando lhe for pedido para introduzir um nome de ambiente, mantenha-o curto e minúsculo. Por exemplo, myenv. Ele é usado como parte do nome do grupo de recursos.

3. Quando solicitado, selecione uma assinatura na qual criar os recursos.

4. Quando lhe for pedido para selecionar uma localização pela primeira vez, selecione uma localização perto de si. Este local é usado para a maioria dos recursos, incluindo hospedagem.

5. Se for solicitado um local para o modelo OpenAI, selecione um local próximo a você. Se o mesmo local estiver disponível como seu primeiro local, selecione isso.

6. Aguarde até que o aplicativo seja implantado. Pode levar de 5 a 10 minutos para que a implantação seja concluída.

7. Depois de implantar o aplicativo com êxito, você verá uma URL exibida no terminal.

8. Selecione o URL identificado com Deploying service web para abrir a aplicação do assistente num navegador.

Utilizar a aplicação assistente

Use o aplicativo assistente para obter o preço do mercado de ações de MSFT. As etapas a seguir orientam você pelo processo de uso do aplicativo assistente. O assistente pode enviar-lhe as respostas por e-mail. Como o recurso de envio de e-mail não está configurado, modifique o prompt para não usar essa instrução.

1. No navegador, copie e cole no seguinte prompt:

   Based on the latest financial data and current stock market trends, can you provide a detailed analysis of Microsoft's current state? Please include insights into their recent performance, market position, and future outlook. Additionally, retrieve and include the latest closing price of Microsoft's stock using its ticker symbol (MSFT).
   

2. Selecione o botão Run. Os seus resultados deverão ser semelhantes à resposta seguinte.

   

Limpar recursos

Limpar recursos do Azure

Os recursos do Azure criados neste artigo são cobrados na sua assinatura do Azure. Se você não espera precisar desses recursos no futuro, exclua-os para evitar incorrer em mais cobranças.

Execute o seguinte comando da CLI do Desenvolvedor do Azure para excluir os recursos do Azure e remover o código-fonte:

azd down --purge

Limpar espaços de código do GitHub

Obter ajuda

Este repositório de exemplo oferece informações de resolução de problemas.

Se o seu problema não for resolvido, registe o problema no Issues do repositório.

Conteúdos relacionados

• O que é a API de Assistentes OpenAI do Azure?
• Começar a avaliar respostas numa aplicação de chat em JavaScript