Extensión de Azure OpenAI para Azure Functions
Importante
La extensión de Azure OpenAI para Azure Functions está actualmente en versión preliminar.
La extensión de Azure OpenAI para Azure Functions implementa un conjunto de desencadenadores y enlaces que permiten integrar fácilmente características y comportamientos de Azure OpenAI Service en las ejecuciones de código de función.
Azure Functions es un servicio de proceso controlado por eventos que proporciona un conjunto de desencadenadores y enlaces para conectarse fácilmente con otros servicios de Azure.
Con la integración entre Azure OpenAI y Functions, puede crear funciones que puedan:
Action | Tipo de desencadenador/enlace |
---|---|
Uso de una solicitud de texto estándar para la finalización del contenido | Enlace de entrada de finalización de texto de Azure OpenAI |
Responder a una solicitud del asistente para llamar a una función | Desencadenador del asistente de Azure OpenAI |
Creación de un asistente | Enlace de salida de creación del asistente de Azure OpenAI |
Mensaje a un asistente | Enlace posterior a la entrada del asistente de Azure OpenAI |
Obtener historial del asistente | Enlace de entrada de consulta del asistente de Azure OpenAI |
Leer incrustaciones de texto | Enlace de entrada de inserciones Azure OpenAI |
Escritura en una base de datos vectorial | Enlace de salida que almacena inserciones de Azure OpenAI |
Lectura de una base de datos vectorial | Enlace de entrada de búsqueda semántica de Azure OpenAI |
Instalación de la extensión
El paquete NuGet de extensión que instale depende del modo de C# en proceso o proceso de trabajo aislado está usando en la aplicación de funciones:
Agregue la extensión Azure OpenAI al proyecto mediante la instalación del paquete NuGet Microsoft.Azure.Functions.Worker.Extensions.OpenAI, que puede hacer mediante la CLI de .NET:
dotnet add package Microsoft.Azure.Functions.Worker.Extensions.OpenAI --prerelease
Al usar una base de datos vectorial para almacenar contenido, también debe instalar al menos uno de estos paquetes 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
Instalación del conjunto
Puede agregar la extensión de vista previa agregando o reemplazando el código siguiente en el host.json
archivo, que tiene como destino específicamente una versión preliminar del lote 4.x que contiene la extensión OpenAI:
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
"version": "[4.*, 5.0.0)"
}
}
Configuración de la aplicación
Para usar la extensión de enlace de Azure OpenAI, debe agregar una o varias de estas opciones de configuración, que se usan para conectarse al recurso de OpenAI. Durante el desarrollo local, también debe agregar esta configuración al local.settings.json
archivo.
Nombre del valor | Descripción |
---|---|
AZURE_OPENAI_ENDPOINT |
Obligatorio. Establece el punto de conexión del recurso de OpenAI usado por los enlaces. |
AZURE_OPENAI_KEY |
Establece la clave usada para acceder a un recurso de Azure OpenAI. |
OPENAI_API_KEY |
Establece la clave que se usa para acceder a un recurso que no es de Azure OpenAI. |
AZURE_CLIENT_ID |
Establece una identidad administrada asignada por el usuario que se usa para acceder al recurso de Azure OpenAI. |
Para más información, consulte Trabajar con la configuración de la aplicación.