사용자 지정 모델 쿼리

배포가 성공적으로 추가되면 배포를 쿼리하여 배포에 할당한 모델을 기반으로 텍스트에서 엔터티를 추출할 수 있습니다.

예측 API를 사용하거나 클라이언트 라이브러리(Azure SDK)를 통해 프로그래밍 방식으로 배포를 쿼리할 수 있습니다.

배포된 모델 테스트

프로젝트에 대한 최신 정보를 조회하고, 필요한 변경을 하고, Microsoft Foundry를 통해 프로젝트 관리 작업을 효율적으로 감독할 수 있습니다.

Language Studio 내에서 배포된 모델을 테스트하려면 다음을 수행합니다.

1. 왼쪽 메뉴에서 배포 테스트를 선택합니다.

2. 테스트할 배포를 선택합니다. 배포에 할당된 모델만 테스트할 수 있습니다.

3. 다국어 프로젝트의 경우 언어 드롭다운에서 테스트할 텍스트의 언어를 선택합니다.

4. 드롭다운에서 쿼리/테스트하려는 배포를 선택합니다.

5. 요청에 제출할 텍스트를 입력하거나 사용할 .txt 파일을 업로드할 수 있습니다.

6. 상단 메뉴에서 테스트 실행을 선택합니다.

7. 결과 탭에 텍스트에서 추출된 엔터티와 해당 형식이 표시됩니다. 또한 JSON 탭 아래에는 JSON 응답이 표시됩니다.

사용자 지정 NER 작업 제출

이 POST 요청을 사용하여 텍스트 분류 작업을 시작합니다.

{ENDPOINT}/language/analyze-text/jobs?api-version={API-VERSION}

헤더

본문

{
  "displayName": "Extracting entities",
  "analysisInput": {
    "documents": [
      {
        "id": "1",
        "language": "{LANGUAGE-CODE}",
        "text": "Text1"
      },
      {
        "id": "2",
        "language": "{LANGUAGE-CODE}",
        "text": "Text2"
      }
    ]
  },
  "tasks": [
     {
      "kind": "CustomEntityRecognition",
      "taskName": "Entity Recognition",
      "parameters": {
        "projectName": "{PROJECT-NAME}",
        "deploymentName": "{DEPLOYMENT-NAME}"
      }
    }
  ]
}

응답

작업이 성공적으로 제출되었음을 나타내는 202 응답이 표시됩니다. 응답 헤더에서 operation-location을 추출합니다. operation-location 형식은 다음과 같습니다.

{ENDPOINT}/language/analyze-text/jobs/{JOB-ID}?api-version={API-VERSION}

이 URL을 사용하여 작업 완료 상태를 쿼리하고 작업이 완료되면 결과를 가져올 수 있습니다.

작업 결과 가져오기

다음 GET 요청을 사용하여 사용자 지정 엔터티 인식 작업의 상태/결과를 쿼리합니다.

{ENDPOINT}/language/analyze-text/jobs/{JOB-ID}?api-version={API-VERSION}

헤더

응답 본문

응답은 다음 매개 변수가 포함된 JSON 문서입니다.

{
  "createdDateTime": "2021-05-19T14:32:25.578Z",
  "displayName": "MyJobName",
  "expirationDateTime": "2021-05-19T14:32:25.578Z",
  "jobId": "xxxx-xxxx-xxxxx-xxxxx",
  "lastUpdateDateTime": "2021-05-19T14:32:25.578Z",
  "status": "succeeded",
  "tasks": {
    "completed": 1,
    "failed": 0,
    "inProgress": 0,
    "total": 1,
    "items": [
      {
        "kind": "EntityRecognitionLROResults",
        "taskName": "Recognize Entities",
        "lastUpdateDateTime": "2020-10-01T15:01:03Z",
        "status": "succeeded",
        "results": {
          "documents": [
            {
              "entities": [
                {
                  "category": "Event",
                  "confidenceScore": 0.61,
                  "length": 4,
                  "offset": 18,
                  "text": "trip"
                },
                {
                  "category": "Location",
                  "confidenceScore": 0.82,
                  "length": 7,
                  "offset": 26,
                  "subcategory": "GPE",
                  "text": "Seattle"
                },
                {
                  "category": "DateTime",
                  "confidenceScore": 0.8,
                  "length": 9,
                  "offset": 34,
                  "subcategory": "DateRange",
                  "text": "last week"
                }
              ],
              "id": "1",
              "warnings": []
            }
          ],
          "errors": [],
          "modelVersion": "2020-04-01"
        }
      }
    ]
  }
}

다음 단계

• 자주 묻는 질문