Compartir a través de


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:

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.