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:
- Ricerca di intelligenza artificiale di Azure: Microsoft.Azure.Functions.Worker.Extensions.OpenAI.AzureAISearch
- Azure Cosmos DB per MongoDB: Microsoft.Azure.Functions.Worker.Extensions.OpenAI.CosmosDBSearch
- Esplora dati di Azure: Microsoft.Azure.Functions.Worker.Extensions.OpenAI.Kusto
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.