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:
- Pesquisa de IA do Azure: Microsoft.Azure.Functions.Worker.Extensions.OpenAI.AzureAISearch
- Azure Cosmos DB for 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)"
}
}
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.