如何在協調工作流程中建立專案
協調流程工作流程可讓您建立專案，以將應用程式連線到：
- 自訂 Language Understanding
- 問題解答
- LUIS
必要條件
開始使用協調流程工作流程之前，您需要數件事：
- Azure 訂用帳戶 - 免費建立一個訂用帳戶。
- Azure AI 語言資源
建立語言資源
開始使用協調流程工作流程之前，您需要 Azure AI 語言資源。
注意
- 您必須在 資源群組上指派擁有者 角色，才能建立語言資源。
- 如果您打算使用問答，則必須在資源建立中啟用問題解答
從 Azure 入口網站 建立新的資源
移至 Azure 入口網站以建立新的 Azure AI 語言資源。
選取 [繼續建立您的資源]
使用下列詳細數據建立語言資源。
從 Language Studio 建立新的語言資源
如果您是第一次登入，您會在 Language Studio 中看到一個視窗，可讓您選擇現有的語言資源或建立新的資源。 您也可以按下右上角的設定圖示，選取 [資源]，然後按兩下 [ 建立新資源] 來建立資源。
使用下列詳細數據建立語言資源。
| 實例詳細數據 |
必要值 |
| Azure 訂用帳戶 |
Azure 訂用帳戶 |
| Azure 資源群組 |
您的 Azure 資源群組 |
| Azure 資源名稱 |
您的 Azure 資源名稱 |
| 位置 |
深入瞭解 支持的區域。 |
| 定價層 |
深入瞭解 支持的定價層。 |
重要
- 建立語言資源時，請務必啟用 受控識別 。
- 閱讀並確認負責任 AI 通知
登入 Language Studio
若要建立新的意圖，請選取 [+新增] 按鈕，然後為意圖提供名稱來開始。 您會看到兩個選項，以連線至專案。 您可以連線到 （LUIS、問答或對話式 Language Understanding） 專案，或選擇 [否 ] 選項。
建立協調流程工作流程專案
建立語言資源之後，請建立協調流程工作流程專案。
在 Language Studio 中，尋找標示為 了解問題和交談語言 的區段，然後選取 [協調流程工作流程]。
這會帶您前往 協調流程工作流程項目 頁面。 選取 [建立新專案]。 若要建立專案，您必須提供下列詳細數據：
| 值 |
描述 |
| Name |
項目的名稱。 |
| 描述 |
選擇性專案描述。 |
| 語句主要語言 |
專案的主要語言。 您的定型數據主要應在此語言中。 |
完成後，請選取 [下一步 ]，並檢閱詳細數據。 選取 [建立專案 ] 以完成此程式。 您現在應該會在專案中看到 [ 建置架構 ] 畫面。
使用下列 URL、標頭和 JSON 主體提交 PATCH 要求，以建立新的專案。
要求 URL
建立 API 要求時，請使用下列 URL。 以您自己的值取代下方的佔位元值。
{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?api-version={API-VERSION}
| 預留位置 |
值 |
範例 |
{ENDPOINT} |
用於驗證 API 要求的端點。 |
https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
專案名稱。 此值區分大小寫。 |
myProject |
{API-VERSION} |
您正在呼叫的 API 版本。 |
2023-04-01 |
使用下列標頭來驗證您的要求。
| 機碼 |
值 |
Ocp-Apim-Subscription-Key |
資源的索引鍵。 用於驗證 API 要求。 |
本文
使用下列範例 JSON 作為主體。
{
"projectName": "{PROJECT-NAME}",
"language": "{LANGUAGE-CODE}",
"projectKind": "Orchestration",
"description": "Project description"
}
| 索引鍵 |
預留位置 |
值 |
範例 |
projectName |
{PROJECT-NAME} |
項目的名稱。 此值區分大小寫。 |
EmailApp |
language |
{LANGUAGE-CODE} |
字串，指定專案中所用語句的語言代碼。 如果您的專案是多語系專案，請選擇 大部分語句的語言代碼 。 |
en-us |
匯入協調流程工作流程專案
您可以隨時移至協調流程工作流程項目頁面、選取專案，然後從頂端功能表中按兩下 [匯出]，將協調流程工作流程項目匯出為 JSON 檔案。
該專案可以重新匯入為新專案。 如果您使用完全相同的名稱匯入專案，它會以新匯入的項目數據取代項目的數據。
若要匯入專案，請選取 [建立新專案] 旁邊的箭號按鈕，並選取 [匯入]，然後選取 JSON 檔案。
您可以將協調流程工作流程 JSON 匯入服務
使用下列 URL、標頭和 JSON 主體提交 POST 要求，以匯入您的專案。
要求 URL
建立 API 要求時，請使用下列 URL。 以您自己的值取代下方的佔位元值。
{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/:import?api-version={API-VERSION}
| 預留位置 |
值 |
範例 |
{ENDPOINT} |
用於驗證 API 要求的端點。 |
https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
專案名稱。 此值區分大小寫。 |
myProject |
{API-VERSION} |
您正在呼叫的 API 版本。 |
2023-04-01 |
使用下列標頭來驗證您的要求。
| 機碼 |
值 |
Ocp-Apim-Subscription-Key |
資源的索引鍵。 用於驗證 API 要求。 |
本文
注意
每個意圖只能是來自的一種類型（CLU、LUIS 和 qna）
使用下列範例 JSON 作為主體。
{
"projectFileVersion": "{API-VERSION}",
"stringIndexType": "Utf16CodeUnit",
"metadata": {
"projectKind": "Orchestration",
"settings": {
"confidenceThreshold": 0
},
"projectName": "{PROJECT-NAME}",
"description": "Project description",
"language": "{LANGUAGE-CODE}"
},
"assets": {
"projectKind": "Orchestration",
"intents": [
{
"category": "string",
"orchestration": {
"kind": "luis",
"luisOrchestration": {
"appId": "00000000-0000-0000-0000-000000000000",
"appVersion": "string",
"slotName": "string"
},
"cluOrchestration": {
"projectName": "string",
"deploymentName": "string"
},
"qnaOrchestration": {
"projectName": "string"
}
}
}
],
"utterances": [
{
"text": "Trying orchestration",
"language": "{LANGUAGE-CODE}",
"intent": "string"
}
]
}
}
| 索引鍵 |
預留位置 |
值 |
範例 |
api-version |
{API-VERSION} |
您正在呼叫的 API 版本。 這裡所使用的版本必須是 URL 中的相同 API 版本。 |
2022-03-01-preview |
projectName |
{PROJECT-NAME} |
項目的名稱。 此值區分大小寫。 |
EmailApp |
language |
{LANGUAGE-CODE} |
字串，指定專案中所用語句的語言代碼。 如果您的專案是多語系專案，請選擇 大部分語句的語言代碼 。 |
en-us |
匯出專案
您可以隨時移至協調流程工作流程項目頁面、選取專案，然後按 [匯出]，將協調流程工作流程項目匯出為 JSON 檔案。
您可以隨時將協調流程工作流程項目匯出為 JSON 檔案。
使用下列 URL、標頭和 JSON 主體建立 POST 要求，以匯出您的專案。
要求 URL
建立 API 要求時，請使用下列 URL。 以您自己的值取代下方的佔位元值。
{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/:export?stringIndexType=Utf16CodeUnit&api-version={API-VERSION}
| 預留位置 |
值 |
範例 |
{ENDPOINT} |
用於驗證 API 要求的端點。 |
https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
專案名稱。 此值區分大小寫。 |
EmailApp |
{API-VERSION} |
您正在呼叫的 API 版本。 |
2023-04-01 |
使用下列標頭來驗證您的要求。
| 機碼 |
值 |
Ocp-Apim-Subscription-Key |
資源的索引鍵。 用於驗證 API 要求。 |
傳送 API 要求之後，您會收到 202 指出成功的回應。 在響應標頭中，擷 operation-location 取值。 格式如下：
{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}
JOB-ID 是用來識別您的要求，因為這項作業是異步的。 使用此 URL 以使用相同的驗證方法來取得導出的專案 JSON。
取得協調流程專案詳細數據
在 Language Studio 中移至您的項目設定頁面。
您可以看到項目詳細數據。
在此頁面中，您可以更新專案描述。
您也可以從此頁面擷取您的資源主鍵。
若要取得協調流程工作流程專案的詳細數據，請使用下列 URL 和標頭提交 GET 要求。 將佔位元值取代為您自己的值。
{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?api-version={API-VERSION}
| 預留位置 |
值 |
範例 |
{ENDPOINT} |
用於驗證 API 要求的端點。 |
https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
專案名稱。 此值區分大小寫。 |
myProject |
{API-VERSION} |
您正在呼叫的 API 版本。 |
2023-04-01 |
使用下列標頭來驗證您的要求。
| 機碼 |
值 |
Ocp-Apim-Subscription-Key |
資源的索引鍵。 用於驗證 API 要求。 |
回應本文
傳送要求之後，您會收到下列回應。
{
"createdDateTime": "2022-04-18T13:53:03Z",
"lastModifiedDateTime": "2022-04-18T13:53:03Z",
"lastTrainedDateTime": "2022-04-18T14:14:28Z",
"lastDeployedDateTime": "2022-04-18T14:49:01Z",
"projectKind": "Orchestration",
"projectName": "{PROJECT-NAME}",
"description": "This is a sample orchestration project.",
"language": "{LANGUAGE-CODE}"
}
傳送 API 要求之後，您會收到 200 回應，指出成功和 JSON 回應本文，其中包含您的專案詳細數據。
刪除專案
當您不再需要專案時，可以使用 Language Studio 刪除專案。 從左側導覽功能表選取 [專案]，選取要刪除的專案，然後從頂端功能表選取 [刪除]。
當您不再需要專案時，可以使用 API 刪除專案。
使用下列 URL、標頭和 JSON 主體建立 DELETE 要求，以刪除交談語言理解專案。
要求 URL
{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?api-version={API-VERSION}
| 預留位置 |
值 |
範例 |
{ENDPOINT} |
用於驗證 API 要求的端點。 |
https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
專案名稱。 此值區分大小寫。 |
myProject |
{API-VERSION} |
您正在呼叫的 API 版本。 |
2023-04-01 |
使用下列標頭來驗證您的要求。
| 機碼 |
值 |
Ocp-Apim-Subscription-Key |
資源的索引鍵。 用於驗證 API 要求。 |
傳送 API 要求之後，您會收到 202 指出成功的回應，這表示您的專案已刪除。
後續步驟
建置結構描述
