Estensione OpenAI di Azure per Funzioni di Azure

Importante

L'estensione OpenAI di Azure per Funzioni di Azure è attualmente in anteprima.

L'estensione OpenAI di Azure per Funzioni di Azure implementa un set di trigger e associazioni che consentono di integrare facilmente funzionalità e comportamenti del servizio Azure OpenAI nelle esecuzioni di codice della funzione.

Funzioni di Azure è un servizio di calcolo basato su eventi che fornisce un set di trigger e associazioni per connettersi facilmente ad altri servizi di Azure.

Con l'integrazione tra Azure OpenAI e Funzioni, è possibile creare funzioni che possono:

Azione Tipo di trigger/associazione
Usare una richiesta di testo standard per il completamento del contenuto Associazione di input di completamento del testo OpenAI di Azure
Rispondere a una richiesta di assistente per chiamare una funzione Trigger dell'assistente OpenAI di Azure
Creare un assistente L'assistente OpenAI di Azure crea l'associazione di output
Messaggio di un assistente Associazione post-input dell'assistente OpenAI di Azure
Ottenere la cronologia degli assistenti Associazione di input delle query per l'assistente Azure OpenAI
Leggere gli incorporamenti di testo Associazione di input incorporamento di Azure OpenAI
Scrivere in un database vettoriale Associazione di output dell'archivio di incorporamenti OpenAI di Azure
Leggere da un database vettoriale Associazione di input di ricerca semantica OpenAI di Azure

Installare l'estensione

Il pacchetto NuGet di estensione installato dipende dal processo di lavoro in-process o isolato in modalità C# in uso nell'app per le funzioni:

Aggiungere l'estensione OpenAI di Azure al progetto installando il pacchetto NuGet Microsoft.Azure.Functions.Worker.Extensions.OpenAI, che è possibile eseguire usando l'interfaccia della riga di comando di .NET:

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.OpenAI  --prerelease

Quando si usa un database vettoriale per l'archiviazione del contenuto, è necessario installare almeno uno di questi pacchetti NuGet:

Installare il bundle

È possibile aggiungere l'estensione di anteprima aggiungendo o sostituendo il codice seguente nel host.json file, destinato in particolare a una versione di anteprima del bundle 4.x che contiene l'estensione OpenAI:

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
    "version": "[4.*, 5.0.0)"
  }
}

Impostazioni delle applicazioni

Per usare l'estensione di associazione OpenAI di Azure, è necessario aggiungere una o più di queste impostazioni, usate per connettersi alla risorsa OpenAI. Durante lo sviluppo locale, è anche necessario aggiungere queste impostazioni al local.settings.json file.

Nome impostazione Descrizione
AZURE_OPENAI_ENDPOINT Obbligatorio. Imposta l'endpoint della risorsa OpenAI usata dalle associazioni.
AZURE_OPENAI_KEY Imposta la chiave usata per accedere a una risorsa OpenAI di Azure.
OPENAI_API_KEY Imposta la chiave usata per accedere a una risorsa OpenAI non di Azure.
AZURE_CLIENT_ID Imposta un'identità gestita assegnata dall'utente usata per accedere alla risorsa OpenAI di Azure.

Per altre informazioni, vedere Usare le impostazioni dell'applicazione.