런타임 API를 사용하여 모델 배포 및 텍스트 분류

모델의 성능에 만족하면 배포할 준비가 된 것입니다. 을 사용하여 텍스트를 분류합니다. 모델을 배포하면 예측 API를 통해 모델을 사용할 수 있습니다.

필수 조건

• 구성된 Azure Storage 계정이 있는 사용자 지정 텍스트 분류 프로젝트,
• 스토리지 계정에 업로드되는 텍스트 데이터입니다.
• 레이블이 지정된 데이터 및 성공적으로 학습된 모델
• 모델 평가 세부 정보를 검토하여 모델의 성능을 확인했습니다.

프로젝트 개발 수명 주기를 참조하세요.

모델 배포(REST API)

모델의 성능을 검토하고 환경에서 사용할 수 있다고 결정한 후에는 모델을 쿼리할 수 있도록 배포에 할당해야 합니다. 모델을 배포에 할당하면 예측 API를 통해 사용할 수 있습니다. 지금까지 빌드한 최상의 모델을 할당하여 시스템에서 사용할 production라는 이름의 배포를 만드는 것이 좋습니다. 현재 작업 중인 모델을 테스트할 수 있도록 할당할 수 있는 staging이라는 또 다른 배포를 만들 수 있습니다. 프로젝트에 최대 10개의 배포를 사용할 수 있습니다.

배포 작업 제출

다음 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}

헤더

다음 헤더를 사용하여 요청을 인증합니다.

응답 본문

요청을 보내면 다음 응답이 표시됩니다. status 매개 변수가 "succeeded"로 변경될 때까지 이 엔드포인트를 계속 폴링합니다. 요청의 성공을 나타내는 200 코드를 확인해 야 합니다.

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

스왑 배포(REST API)

한 배포에 할당된 모델을 테스트한 후 배포를 교환하고 다른 배포에 할당하려고 할 수 있습니다. 배포 교환에서는 첫 번째 배포에 할당된 모델을 사용하고 두 번째 배포에 할당합니다. 그런 다음, 두 번째 배포에 할당된 모델을 사용하고 첫 번째 배포에 할당합니다. 이 단계는 production에 할당된 모델을 가져와 staging에 할당하려는 경우, staging 및 production 배포를 교환하는 데 사용할 수 있습니다.

다음 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 .

배포 삭제(REST API)

다음 URL, 헤더, JSON 본문을 사용하는 DELETE 요청을 만들어 배포를 삭제합니다.

요청 URL

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

헤더

다음 헤더를 사용하여 요청을 인증합니다.

API 요청을 보내면 성공을 나타내는 응답을 받게 202 됩니다. 즉, 배포가 삭제됩니다. 작업의 상태를 확인하는 데 사용되는 Operation-Location 헤더가 포함된 성공적인 호출 결과.

배포 리소스 할당(REST API)

여러 지역에 있는 다양한 언어 리소스를 할당하여 프로젝트를 여러 지역에 배포할 수 있습니다.

프로그래밍 방식으로 배포 리소스를 할당하려면 Microsoft Entra 인증이 필요합니다. Microsoft Entra ID는 다중 지역 배포를 위해 프로젝트에 할당하려는 리소스에 대한 액세스 권한이 있는지 확인하는 데 사용됩니다. REST API를 호출할 때 프로그래밍 방식으로 Microsoft Entra 인증을 사용하려면 Foundry 도구 설명서에서 자세히 알아보세요.

리소스 할당

다음 URL, 헤더 및 JSON 본문을 사용하여 POST 요청을 제출하여 배포 리소스를 할당합니다.

요청 URL

API 요청을 만들 때 다음 URL을 사용합니다. 자리 표시자 값을 사용자 고유의 값으로 바꿉니다.

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

헤더

이 API를 인증하려면 Microsoft Entra 인증을 사용합니다.

본문

다음 샘플 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"
}

배포 리소스 할당 취소(REST API)

프로젝트에서 배포 리소스를 할당 취소하거나 제거하면 이전에 해당 리소스 지역에 배포된 모든 배포도 삭제됩니다.

리소스 할당 해제

다음 URL, 헤더 및 JSON 본문을 사용하여 POST 요청을 제출하여 프로젝트에서 배포 리소스를 할당 취소하거나 제거합니다.

요청 URL

API 요청을 만들 때 다음 URL을 사용합니다. 자리 표시자 값을 사용자 고유의 값으로 바꿉니다.

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

헤더

다음 헤더를 사용하여 요청을 인증합니다.

본문

다음 샘플 JSON을 본문으로 사용합니다.

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

리소스 할당 취소 상태 가져오기

다음 GET 요청을 사용하여 배포 리소스 할당 취소 작업의 상태를 가져옵니다. 자리 표시자 값을 사용자 고유의 값으로 바꿉니다.

요청 URL

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

헤더

다음 헤더를 사용하여 요청을 인증합니다.

응답 본문

요청을 보내면 다음 응답이 표시됩니다. status 매개 변수가 "succeeded"로 변경될 때까지 이 엔드포인트를 계속 폴링합니다.

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

다음 단계

• 모델을 쿼리하도록 예측 API 사용