Azure Functions 的 Azure OpenAI 延伸模組
重要
適用於 Azure Functions 的 Azure OpenAI 延伸模組目前為預覽狀態。
適用於 Azure Functions 的 Azure OpenAI 擴充功能會實作一組觸發程式和系結,可讓您輕鬆地將 Azure OpenAI 服務 的功能和行為整合到函式程式代碼執行中。
Azure Functions 是事件驅動的計算服務,會提供一組可與其他 Azure 服務輕鬆連線的觸發程序和繫結。
透過 Azure OpenAI 與 Functions 之間的整合,您可以建置具有以下功能的函數:
動作 | 觸發程序/繫結型別 |
---|---|
使用標準文字提示進行內容完成 | Azure OpenAI 文字完成輸入繫結 |
回應助理要求以呼叫函式 | Azure OpenAI 助理觸發程序 |
建立助理 | Azure OpenAI 助理建立輸出繫結 |
發訊息給助理 | Azure OpenAI 助理文章輸入繫結 |
取得助理歷程記錄 | Azure OpenAI 助理查詢輸入繫結 |
讀取文字內嵌 | Azure OpenAI 內嵌輸入繫結 |
寫入向量資料庫 | Azure OpenAI 內嵌儲存輸出繫結 |
從向量資料庫讀取 | Azure OpenAI 語意搜尋輸入繫結 |
安裝擴充功能
您安裝的延伸模組 NuGet 套件取決於您在函式應用程式中使用的 C# 模式內含式 或 隔離式背景工作處理序:
您可以使用 .NET CLI,透過安裝 Microsoft.Azure.Functions.Worker.Extensions.OpenAI NuGet 套件將 Azure OpenAI 延伸模組新增至您的專案中:
dotnet add package Microsoft.Azure.Functions.Worker.Extensions.OpenAI --prerelease
使用向量資料庫儲存內容時,您也應該至少安裝下列其中一個 NuGet 套件:
- Azure AI 搜尋:Microsoft.Azure.Functions.Worker.Extensions.OpenAI.AzureAISearch
- Azure Cosmos DB for MongoDB:Microsoft.Azure.Functions.Worker.Extensions.OpenAI.CosmosDBSearch
- Azure 資料總管:Microsoft.Azure.Functions.Worker.Extensions.OpenAI.Kusto
安裝搭售方案
您可以在檔案 host.json
中新增或取代下列程式代碼來新增預覽延伸模組,其特別針對包含 OpenAI 延伸模組的 4.x 套件組合預覽版本:
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
"version": "[4.*, 5.0.0)"
}
}
應用程式設定
若要使用 Azure OpenAI 系結延伸模組,您必須新增一或多個用來連線到 OpenAI 資源的這些設定。 在本機開發期間,您也需要將這些設定新增至檔案 local.settings.json
。
設定名稱 | 描述 |
---|---|
AZURE_OPENAI_ENDPOINT |
必要。 設定系結所使用的 OpenAI 資源的端點。 |
AZURE_OPENAI_KEY |
設定用來存取 Azure OpenAI 資源的金鑰。 |
OPENAI_API_KEY |
設定用來存取非 Azure OpenAI 資源的金鑰。 |
AZURE_CLIENT_ID |
設定使用者指派的受控識別,用來存取 Azure OpenAI 資源。 |
如需詳細資訊,請參閱使用應用程式設定。