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:
- Azure AI Search: Microsoft.Azure.Functions.Worker.Extensions.OpenAI.AzureAISearch
- Azure Cosmos DB para MongoDB: Microsoft.Azure.Functions.Worker.Extensions.OpenAI.CosmosDBSearch
- Azure Data Explorer: Microsoft.Azure.Functions.Worker.Extensions.OpenAI.Kusto
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.