Compartilhar via


Extensão do OpenAI do Azure para Azure Functions

Importante

Atualmente, a extensão do OpenAI do Azure para Azure Functions está em versão prévia.

A extensão OpenAI do Azure para Azure Functions implementa um conjunto de gatilhos e associações que permitem integrar facilmente recursos e comportamentos do Serviço OpenAI do Azure em suas execuções de código de função.

O Azure Functions é um serviço de computação controlado por eventos que fornece um conjunto de gatilhos e associações para facilitar a conexão com outros serviços do Azure.

Com a integração entre o OpenAI do Azure e o Azure Functions, você pode criar funções que podem:

Ação Tipo de gatilho/associação
Usar um prompt de texto padrão para conclusão de conteúdo Associação de entrada de preenchimento de texto do OpenAI do Azure
Responder a uma solicitação do assistente para chamar uma função Gatilho do assistente do OpenAI do Azure
Criar um assistente Associação de saída de criação do assistente do OpenAI do Azure
Enviar mensagem para um assistente Associação de entrada de postagem do assistente do OpenAI do Azure
Obter histórico do assistente Associação de entrada de consulta do assistente do OpenAI do Azure
Ler incorporações de texto Associação de entrada de incorporações do OpenAI do Azure
Gravar em um banco de dados de vetores Associação de saída do repositório de incorporações do OpenAI do Azure
Ler de um banco de dados de vetores Associação de entrada de pesquisa semântica do OpenAI do Azure

Instalar a extensão

O pacote NuGet de extensão instalado depende do processo ou do processo de trabalho isolado do C# que você estiver usando no seu aplicativo de funções:

Adicione a extensão do OpenAI do Azure ao seu projeto instalando o pacote NuGet Microsoft.Azure.Functions.Worker.Extensions.OpenAI, o que você pode fazer usando a CLI do .NET:

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.OpenAI  --prerelease

Ao usar um banco de dados de vetores para armazenar conteúdo, instale também pelo menos um desses pacotes NuGet:

Instalar pacote

Você pode adicionar a extensão de visualização adicionando ou substituindo o seguinte código em seu host.json arquivo, que visa especificamente uma versão de visualização do pacote 4.x que contém a extensão OpenAI:

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
    "version": "[4.*, 5.0.0)"
  }
}

Configurações de aplicativo

Para usar a extensão de associação do OpenAI do Azure, você precisa adicionar uma ou mais dessas configurações, que são usadas para se conectar ao recurso OpenAI. Durante o desenvolvimento local, você também precisa adicionar essas configurações ao seu local.settings.json arquivo.

Nome da configuração Descrição
AZURE_OPENAI_ENDPOINT Obrigatória. Define o ponto de extremidade do recurso OpenAI usado por suas associações.
AZURE_OPENAI_KEY Define a chave usada para acessar um recurso do OpenAI do Azure.
OPENAI_API_KEY Define a chave usada para acessar um recurso OpenAI que não é do Azure.
AZURE_CLIENT_ID Define uma identidade gerenciada atribuída pelo usuário usada para acessar o recurso OpenAI do Azure.

Para obter mais informações, confira Trabalhar com configurações de aplicativo.