部署模型并使用运行时 API 对文本进行分类

若要要从 Language Studio 中部署模型，请执行以下操作：

1. 在左侧菜单中，选择“部署模型”。

2. 选择“添加部署”，以开始新部署作业。

   

3. 选择“创建新部署”以创建新的部署，并从下面的下拉列表中分配已训练的模型。 还可以通过选择“覆盖现有部署”选项来覆盖现有部署，然后从下面的下拉列表中选择要为其分配的已训练的模型。

   注意

   覆盖现有部署不需要更改预测 API 调用，但产生的结果将基于新分配的模型。

   

4. 选择“部署”以启动部署作业。

5. 部署成功后，旁边将显示到期日期。 部署到期是指已部署的模型将无法用于预测，这通常发生在训练配置到期后的 12 个月内。

提交部署作业

使用以下 URL、标头和 JSON 正文提交 PUT 请求，以提交部署作业。 请将以下占位符值替换为你自己的值。

{Endpoint}/language/authoring/analyze-text/projects/{projectName}/deployments/{deploymentName}?api-version={API-VERSION}

头文件

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

请求正文

在请求正文中使用以下 JSON。 使用要分配给部署的模型名称。

{
  "trainedModelLabel": "{MODEL-NAME}"
}

发送 API 请求后，你将收到 202 响应，这表明作业已正确提交。 在响应头中，提取 operation-location 值。 其格式如下：

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

{JOB-ID} 用于标识请求，因为此操作是异步操作。 你可使用此 URL 获取部署状态。

获取部署作业状态

使用以下 GET 请求来查询部署作业的状态。 可以使用在上一步中收到的 URL，或者将下面的占位符值替换为你自己的值。

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

头文件

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

响应正文

发送请求后，你将获得以下响应。 继续轮询此终结点，直到“状态”参数变为“已成功”。 应获取一个 200 代码来指示请求的成功。

{
    "jobId":"{JOB-ID}",
    "createdDateTime":"{CREATED-TIME}",
    "lastUpdatedDateTime":"{UPDATED-TIME}",
    "expirationDateTime":"{EXPIRATION-TIME}",
    "status":"running"
}

从 Language Studio 中交换部署

1. 在“部署模型”页面中，选择要交换的两个部署，然后选择顶部菜单中的“交换部署”。

2. 从出现的窗口中，选择要交换的部署的名称。

使用以下 URL、标头和 JSON 正文创建 POST 请求，以启动交换部署作业。

请求 URL

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/deployments/:swap?api-version={API-VERSION}

头文件

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

请求正文

{
  "firstDeploymentName": "{FIRST-DEPLOYMENT-NAME}",
  "secondDeploymentName": "{SECOND-DEPLOYMENT-NAME}"
}

当你发送 API 请求后，将收到指示成功的 202 响应。

若要从 Language Studio 中删除部署，请转到“部署模型”页面。 选择要删除的部署，然后选择顶部菜单中的“删除部署”。

使用以下 URL、标头和 JSON 正文创建 DELETE 请求，以删除部署。

请求 URL

{Endpoint}/language/authoring/analyze-text/projects/{PROJECT-NAME}/deployments/{deploymentName}?api-version={API-VERSION}

头文件

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

发送 API 请求后，将收到一个指示成功的 202 响应，这意味着部署已被删除。 带有用于检查作业状态的 Operation-Location 标头的成功调用结果。

若要在 Language Studio 中分配位于其他区域的部署资源，请执行以下操作：

1. 确保你已将自己分配为用于创建项目的资源的认知服务语言所有者。
2. 转到 Language Studio 中的“部署模型”页。
3. 选择“区域”选项卡。
4. 选择“添加部署资源”。
5. 选择另一个区域中的语言资源。

现已准备好将项目部署到你分配了其中的资源的区域。

以编程方式分配部署资源需要进行 Microsoft Entra 身份验证。 Microsoft Entra ID 用于确认你是否有权访问你想要分配到项目以进行多区域部署的资源。 若要在发出 REST API 调用时以编程方式使用 Microsoft Entra 身份验证，请参阅 Azure AI 服务文档中的详细信息。

分配资源

使用以下 URL、标头和 JSON 正文提交 POST 请求以分配部署资源。

请求 URL

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

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/resources/:assign?api-version={API-VERSION}

标头

使用 Microsoft Entra 身份验证对此 API 进行身份验证。

正文

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

{
  "resourcesMetadata": [
    {
      "azureResourceId": "{AZURE-RESOURCE-ID}",
      "customDomain": "{CUSTOM-DOMAIN}",
      "region": "{REGION-CODE}"
    }
  ]
}

获取分配资源状态

使用以下 GET 请求获取分配部署资源作业的状态。 请将以下占位符值替换为你自己的值。

请求 URL

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

头文件

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

响应正文

发送请求后，你将获得以下响应。 继续轮询此终结点，直到 status 参数更改为 succeeded。

{
    "jobId":"{JOB-ID}",
    "createdDateTime":"{CREATED-TIME}",
    "lastUpdatedDateTime":"{UPDATED-TIME}",
    "expirationDateTime":"{EXPIRATION-TIME}",
    "status":"running"
}

若要使用 Language Studio 取消分配或删除其他区域中的部署资源，请执行以下操作：

1. 转到“部署模型”页中的“区域”选项卡。
2. 选择要取消分配的资源。
3. 选择“删除分配”按钮。
4. 在出现的窗口中，键入要删除的资源的名称。

取消分配资源

使用以下 URL、标头和 JSON 正文提交 POST 请求，以从项目中取消分配或删除部署资源。

请求 URL

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

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/resources/:unassign?api-version={API-VERSION}

头文件

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

Body

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

{
  "assignedResourceIds": [
    "{AZURE-RESOURCE-ID}"
  ]
}

获取取消分配资源状态

使用以下 GET 请求获取取消分配部署资源作业的状态。 请将以下占位符值替换为你自己的值。

请求 URL

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

头文件

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

响应正文

发送请求后，你将获得以下响应。 继续轮询此终结点，直到“状态”参数变为“已成功”。

{
    "jobId":"{JOB-ID}",
    "createdDateTime":"{CREATED-TIME}",
    "lastUpdatedDateTime":"{UPDATED-TIME}",
    "expirationDateTime":"{EXPIRATION-TIME}",
    "status":"running"
}