创建 CLU 微调任务

1. 在 Language Studio 中，找到名为 “了解问题和对话语言 ”的部分，然后选择“ 对话语言理解”。

   

2. 当 对话语言理解项目 页面打开时，选择“ 创建新项目”。

   

3. 若要创建新项目，请提供以下信息：

   价值	DESCRIPTION
   名称	项目名称。 创建后，无法更改名称。
   DESCRIPTION	可选项目说明。
   语句主要语言	项目的主要语言。 训练数据应主要使用此语言。
   启用多种语言	是否要让项目同时支持 多种语言 。

4. 完成后，选择“ 创建”。 现在应会看到项目的 “入门” 登陆页面。

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

请求的 URL

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

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

标头

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

身体

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

{
  "projectName": "{PROJECT-NAME}",
  "language": "{LANGUAGE-CODE}",
  "projectKind": "Conversation",
  "description": "Project description",
  "multilingual": true
}

可以随时将 CLU 项目导出为 JSON 文件。 在对话项目页上，选择一个项目，然后在顶部菜单中选择“ 导出”。

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

如果有现有的语言理解（LUIS）应用程序，可以直接将 LUIS 应用程序 JSON 导入 CLU。 它创建一个对话项目，其中包含当前可用的所有部分：意向、机器学习实体和言语。 有关详细信息，请参阅从语言理解（LUIS）迁移到对话语言理解（CLU）。

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

可以将 CLU JSON 导入服务。

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

请求的 URL

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

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

标头

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

身体

所发送的 JSON 正文类似于以下示例。 有关 JSON 对象的详细信息，请参阅 参考文档。

{
  "projectFileVersion": "{API-VERSION}",
  "stringIndexType": "Utf16CodeUnit",
  "metadata": {
    "projectKind": "Conversation",
    "settings": {
      "confidenceThreshold": 0.7
    },
    "projectName": "{PROJECT-NAME}",
    "multilingual": true,
    "description": "Trying out CLU",
    "language": "{LANGUAGE-CODE}"
  },
  "assets": {
    "projectKind": "Conversation",
    "intents": [
      {
        "category": "intent1"
      },
      {
        "category": "intent2"
      }
    ],
    "entities": [
      {
        "category": "entity1"
      }
    ],
    "utterances": [
      {
        "text": "text1",
        "dataset": "{DATASET}",
        "intent": "intent1",
        "entities": [
          {
            "category": "entity1",
            "offset": 5,
            "length": 5
          }
        ]
      },
      {
        "text": "text2",
        "language": "{LANGUAGE-CODE}",
        "dataset": "{DATASET}",
        "intent": "intent2",
        "entities": []
      }
    ]
  }
}

成功请求后，API 响应包含 URL operation-location 标头，可用于检查导入作业的状态。 标头的格式如下例所示：

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

可以随时将 CLU 项目导出为 JSON 文件。 在对话项目页上，选择一个项目，然后选择“ 导出”。

可以随时将 CLU 项目导出为 JSON 文件。

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

请求的 URL

创建 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": "Conversation",
  "projectName": "{PROJECT-NAME}",
  "multilingual": true,
  "description": "This is a sample conversation project.",
  "language": "{LANGUAGE-CODE}"
}

发送 API 请求后，您会收到一个表明成功的200响应，其中包含带有项目详细信息的 JSON 响应正文。

不再需要项目时，可以使用 Language Studio 删除项目。 在左窗格中，选择“ 项目”，选择要删除的项目，然后从顶部菜单中选择“ 删除 ”。

如果不再需要项目，则可以使用 REST API 将其删除。 若要继续，请访问 REST API，并按照记录的步骤删除项目以完成此作。

使用以下 URL、标头和 JSON 正文创建 DELETE 请求，以删除对话语言理解项目。

请求的 URL

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

标头

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

发送 API 请求后，会收到指示 202 成功（这意味着项目已删除）的响应。