Partilhar via


Extensão do Azure OpenAI para Azure Functions

Importante

A extensão do Azure OpenAI para o Azure Functions está atualmente em visualização.

A extensão do Azure OpenAI 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 se conectar facilmente a outros serviços do Azure.

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

Ação Tipo de gatilho/ligação
Usar um prompt de texto padrão para conclusão de conteúdo Vinculação de entrada de conclusão de texto do Azure OpenAI
Responder a um pedido de assistente para chamar uma função Gatilho do assistente do Azure OpenAI
Criar um assistente Assistente do Azure OpenAI criar ligação de saída
Envie uma mensagem a um assistente Assistente do Azure OpenAI após vinculação de entrada
Obter histórico do assistente Vinculação de entrada de consulta do assistente do Azure OpenAI
Ler incorporações de texto Azure OpenAI incorpora vinculação de entrada
Gravar em um banco de dados vetorial Azure OpenAI incorpora vinculação de saída de loja
Ler a partir de uma base de dados vetorial Vinculação de entrada de pesquisa semântica do Azure OpenAI

Instalar a extensão

O pacote NuGet de extensão que você instala depende do processo de trabalho isolado ou em processo do modo C# que você está usando em seu aplicativo de função:

Adicione a extensão 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 vetorial para armazenar conteúdo, você também deve instalar pelo menos um destes 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)"
  }
}

Definições da aplicação

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

Nome da definição Description
AZURE_OPENAI_ENDPOINT Obrigatório. 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 Azure OpenAI.
OPENAI_API_KEY Define a chave usada para acessar um recurso OpenAI que não seja do Azure.
AZURE_CLIENT_ID Define uma identidade gerenciada atribuída pelo usuário usada para acessar o recurso do Azure OpenAI.

Para obter mais informações, consulte Trabalhar com configurações do aplicativo.