使用 Azure OpenAI 助理以函式方式呼叫 Azure Logic Apps

發行項
10/16/2024

注意

這項功能目前僅於 Azure OpenAI Studio 中提供。

Azure Logic Apps 是 Azure 中的整合平台，可讓您使用低程式碼工具建置應用程式和自動化工作流程，以提高開發人員生產力，並加快上市時間。藉由使用視覺化設計工具並從數百個預建連接器中進行選取，您可以快速建置工作流程來整合及管理應用程式、資料、服務和系統。

Azure Logic Apps 完全由 Microsoft Azure 管理，這可讓您擔心裝載、調整、管理、監視和維護使用這些服務建置的解決方案。當您使用這些功能來建立無伺服器應用程式和解決方案時，您可以只專注於商務邏輯和功能。這些服務會自動進行調整，以符合您的需求、加速自動化工作流程，以及協助您使用很少的程式碼或不使用程式碼來建置強大的雲端應用程式。

透過助理遊樂場在 Azure Logic Apps 上進行函式呼叫

為了加速和簡化智慧型應用程式的建立，我們現在能夠透過 Azure OpenAI 助理中的函式呼叫來呼叫 Logic Apps 工作流程。

助理遊樂場會列舉並列出您訂用帳戶中符合函式呼叫資格的所有工作流程。以下是這些工作流程的需求：

取用 Logic Apps：目前我們僅支援取用工作流程。
要求觸發程序：函式呼叫需要以 REST 型 API。具有要求觸發程序的 Logic Apps 會提供 REST 端點。因此，函式呼叫僅支援具有要求觸發程序的工作流程。
結構描述：您想要用於函式呼叫的工作流程應該具有 JSON 結構描述，其中會描述輸入和預期的輸出。使用 Logic Apps，您可以在觸發程序中簡化並提供結構描述，且該結構描述會自動匯入為函式定義。

如果您已擁有滿足上述三個需求的工作流程，您應該能夠在 Azure OpenAI 工作室中使用這些工作流程，並透過使用者提示進行叫用。如果您沒有現有的工作流程，您可以依照本文中的步驟來建立。有兩個主要步驟：

在 Azure 入口網站上建立邏輯應用程式。
在助理遊樂場中以函式方式匯入 Logic Apps 工作流程。

為函式呼叫建立 Logic Apps 工作流程

以下是為函式呼叫建立新 Logic Apps 工作流程的步驟。

在 Azure 入口網站搜尋方塊中輸入邏輯應用程式，然後選取 [邏輯應用程式]。
在 Logic Apps 頁面工具列上，選取 [新增]。
在 [建立邏輯應用程式] 頁面上，首先針對您的邏輯應用程式資源選取 [方案] 類型。如此一來，就只會顯示該方案類型的選項。
在 [方案] 區段中，針對 [方案類型] 選取 [使用量] 僅檢視使用量邏輯應用程式資源設定。
為您的邏輯應用程式資源提供下列資訊：訂用帳戶、資源群組、邏輯應用程式名稱和區域。
準備好時，選取 [檢閱 + 建立]。
在出現的驗證頁面上，確認提供的所有資訊，然後選取 [建立]。
在 Azure 成功部署您的邏輯應用程式資源後，選取 [移至資源]。或者，在 Azure 搜尋方塊中輸入名稱，以尋找並選取您的邏輯應用程式資源。
在設計工具中開啟 Logic Apps 工作流程。依序選取 [開發工具] 和 [邏輯應用程式設計工具]。這會在設計工具中開啟您的空白工作流程。或者，從 [範本] 選取 [空白邏輯應用程式]
現在，您已準備好在工作流程中額外新增一個步驟。工作流程一律以單一觸發程序開始，指定在工作流程中執行任何後續動作之前要符合的條件。
您的工作流程必須有要求觸發程序來產生 REST 端點，以及叫用此工作流程時將回應傳回至 Azure OpenAI Studio 的回應動作。
新增觸發程序 (要求)

選取 [新增觸發程序]，然後搜尋要求觸發程序。選取 [收到 HTTP 要求時] 作業。

提供要求的 JSON 結構描述。如果您沒有該結構描述，請使用選項來產生結構描述。

以下是要求結構描述範例。您可以在註解方塊中新增工作流程的描述。這會由 Azure OpenAI Studio 匯入作為函式描述。

儲存工作流程。這會產生工作流程的 REST 端點。
根據商務使用案例，您現在可以在此工作流程中新增一或多個步驟/動作。例如，使用 MSN 天氣連接器來取得目前位置的天氣預報。

在 [取得今日預報] 動作中，我們將使用傳遞至此工作流程作為輸入的 [位置] 屬性。
設定回應。工作流程需要將回應傳回至 Azure OpenAI Studio。這會使用「回應」動作來完成。

在回應動作中，您可以從任何先前的步驟中選擇輸出。如果您想要以特定格式傳回輸出，您也可以選擇性地提供 JSON 結構描述。
工作流程現已就緒。在 Azure OpenAI Studio 中，您可以使用助理遊樂場中的 [新增函式] 功能來匯入此函式。

以函式方式匯入 Logic Apps 工作流程

以下是在 Azure OpenAI Studio 的助理遊樂場中以函式方式匯入 Logic Apps 工作流程的步驟：

在 Azure OpenAI Studio 中，選取 [助理]。選取現有的助理或建立新的助理。設定助理的名稱和指令之後，即可新增函式。選取 [+ 新增函式]。
[新增函式] 選項會開啟一個畫面，其中包含兩個索引標籤。瀏覽至 [Logic Apps] 索引標籤，以瀏覽具有要求觸發程序的工作流程。從清單中選取工作流程，然後選取 [儲存]。

注意

此清單只會顯示具有要求觸發程序的使用量 SKU 工作流程。

您現在已成功匯入工作流程，並可供叫用。系統會根據 Logic Apps 工作流程 Swagger 產生函式規格，並根據您在要求觸發程序動作中進行的設定來包含結構描述和描述。

Azure OpenAI 助理現在會根據使用者提示叫用工作流程。以下是根據使用者提示自動叫用工作流程以取得天氣的範例。

您可以查看記錄和工作流程執行歷程記錄來確認叫用。

常見問題集

什麼是邏輯應用程式連接器？

Azure Logic Apps 具有數百個企業營運 (LOB) 應用程式和資料庫的連接器，包括但不限於：SAP、Salesforce、Oracle、SQL 等。您也可以連線到 SaaS 應用程式或裝載於虛擬網路中的內部應用程式。這些現成連接器可讓您執行以多種格式傳送和接收資料的作業。利用這些功能搭配 Azure OpenAI 助理，應該就能快速地將資料帶入由 Azure OpenAI 提供的 Intelligent Insights。

在 Azure OpenAI Studio 中匯入 Logic Apps 並叫用時，會發生什麼情況

Logic Apps Swagger 檔案可用來填入函式定義。 Azure 邏輯應用程式會根據工作流程的註釋，為具有要求觸發程序的工作流程發行 OpenAPI 2.0 定義 (Swagger)。使用者可以更新工作流程來修改此 Swagger 的內容。 Azure OpenAI Studio 會使用此項目來產生助理所需的函式定義。

從 Azure OpenAI Studio 到 Logic Apps 的驗證如何運作？

Logic Apps 支援兩種主要驗證類型來叫用要求觸發程序。

共用存取簽章 (SAS) 型驗證。

使用者可以使用列出回呼 URL API 來取得包含 SAS 的回呼 URL。 Logic Apps 也支援使用多個金鑰，並視需要加以輪替。 Logic Apps 也支援使用指定的有效期間建立 SAS URL。如需詳細資訊，請參閱 Logic Apps 文件。
Microsoft Entra ID 型 OAuth 基底驗證原則。

Logic Apps 也支援使用 Microsoft Entra ID OAuth 叫用驗證觸發程序，其中您可以指定要用於驗證 OAuth 權杖的驗證原則。如需詳細資訊，請參閱 Logic Apps 文件。

當 Azure OpenAI 助理需要在函式呼叫的過程中叫用邏輯應用程式時，Azure OpenAI Studio 會使用 SAS 擷取回呼 URL 以叫用工作流程。

另請參閱

深入了解助理

共用方式為