如何在业务流程工作流中创建项目

1. 在 Language Studio 中，找到标记为“了解问题和会话语言”的部分，然后选择“业务流程工作流”。

   

2. 这会将你转到“业务流程工作流项目”页。 选择“创建新项目”。 为了创建项目，你将需要提供以下详细信息：

完成后，选择“下一步”，并查看详细信息。 选择“创建项目”以完成过程。 现在应会看到项目中的“生成架构”屏幕。

使用以下 URL、标头和 JSON 正文提交 PATCH 请求，以创建新项目。

创建 API 请求时，请使用以下 URL。 请将以下占位符值替换为你自己的值。

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?api-version={API-VERSION}

使用以下标头对请求进行身份验证。

使用以下示例 JSON 作为正文。

{
  "projectName": "{PROJECT-NAME}",
  "language": "{LANGUAGE-CODE}",
  "projectKind": "Orchestration",
  "description": "Project description"
 }

你随时可以将业务流程工作流项目导出为 JSON 文件，方式如下：转到业务流程工作流项目页，选择项目并单击顶部菜单中的“导出”。

该项目可以重新导入为新项目。 如果导入完全同名的项目，将用新导入项目的数据替换项目的数据。

若要导入项目，请选择“创建新项目”旁边的箭头按钮，选择“导入”，然后选择 JSON 文件。

可以将业务流程工作流 JSON 导入服务

使用以下 URL、标头和 JSON 正文提交 POST 请求，以导入项目。

创建 API 请求时，请使用以下 URL。 请将以下占位符值替换为你自己的值。

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/:import?api-version={API-VERSION}

使用以下标头对请求进行身份验证。

使用以下示例 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"
      }
    ]
  }
}

你随时可以将业务流程工作流项目导出为 JSON 文件，方式如下：转到业务流程工作流项目页，选择项目并按“导出”。

你随时可以将业务流程工作流项目导出为 JSON 文件。

使用以下 URL、标头和 JSON 正文创建 POST 请求，以导出项目。

创建 API 请求时，请使用以下 URL。 请将以下占位符值替换为你自己的值。

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/:export?stringIndexType=Utf16CodeUnit&api-version={API-VERSION}

使用以下标头对请求进行身份验证。

当你发送 API 请求后，将收到指示成功的 202 响应。 在响应头中，提取 operation-location 值。 其格式如下：

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}

JOB-ID 用于标识请求，因为此操作是异步操作。 使用此 URL 可以通过相同的身份验证方法获取导出的项目 JSON。

1. 转到 Language Studio 中的项目设置页面。

2. 可以看到项目详细信息。

3. 在此页中，可以更新项目说明。

4. 还可以从此页面检索资源主键。

   

若要获取业务流程工作流项目的详细信息，请使用以下 URL 和标头提交 GET 请求。 将占位符值替换为你自己的值。

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?api-version={API-VERSION}

使用以下标头对请求进行身份验证。

发送请求后，你将获得以下响应。

{
  "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 请求，以删除对话语言理解项目。

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?api-version={API-VERSION}

使用以下标头对请求进行身份验证。

发送 API 请求后，将收到一个指示成功的 202 响应，这意味着项目已被删除。