Text Analysis Authoring - Get Model Evaluation Results

참조

서비스:: Azure AI Services

API 버전:: 2023-04-01

학습된 모델에 대한 평가의 자세한 결과를 가져옵니다. 여기에는 평가 프로세스에 포함된 데이터에 대한 원시 유추 결과가 포함됩니다.

GET {Endpoint}/language/authoring/analyze-text/projects/{projectName}/models/{trainedModelLabel}/evaluation/result?api-version=2023-04-01&stringIndexType=Utf16CodeUnit

선택적 매개 변수:

GET {Endpoint}/language/authoring/analyze-text/projects/{projectName}/models/{trainedModelLabel}/evaluation/result?api-version=2023-04-01&top={top}&skip={skip}&maxpagesize={maxpagesize}&stringIndexType=Utf16CodeUnit

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
Endpoint	path	True	string url	지원되는 Cognitive Services 엔드포인트(예: https://.api.cognitiveservices.azure.com.
projectName	path	True	string	새 프로젝트 이름입니다.
trainedModelLabel	path	True	string	학습된 모델 레이블입니다.
api-version	query	True	string	이 작업에 사용할 API 버전입니다.
stringIndexType	query	True	StringIndexType	문자열 오프셋을 해석하는 데 사용되는 메서드를 지정합니다. 자세한 내용은 https://aka.ms/text-analytics-offsets참조하세요.
maxpagesize	query		integer int32	페이지당 결과 항목의 최대 수입니다.
skip	query		integer int32	건너뛸 결과 항목의 수입니다.
top	query		integer int32	반환할 결과 항목의 수입니다.

응답

Name	형식	Description
200 OK	PagedTextAnalysisAuthoringDocumentEvaluationResult	요청이 성공했습니다.
Other Status Codes	ErrorResponse	예기치 않은 오류 응답입니다.

보안

Ocp-Apim-Subscription-Key

형식: apiKey
In(다음 안에): header

OAuth2Auth

형식: oauth2
Flow: accessCode
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize
토큰 URL: https://login.microsoftonline.com/common/oauth2/token

범위

Name	Description
https://cognitiveservices.azure.com/.default

예제

SuccessfulGetModelEvaluation

샘플 요청

HTTP

GET {Endpoint}/language/authoring/analyze-text/projects/LoanAgreements/models/model2/evaluation/result?api-version=2023-04-01&maxpagesize=10&stringIndexType=Utf16CodeUnit

샘플 응답

상태 코드:: 200

{
  "value": [
    {
      "location": "11.txt",
      "language": "en-us",
      "projectKind": "CustomEntityRecognition",
      "customEntityRecognitionResult": {
        "entities": [
          {
            "expectedEntities": [
              {
                "category": "Date",
                "offset": 5,
                "length": 9
              },
              {
                "category": "BorrowerName",
                "offset": 160,
                "length": 13
              },
              {
                "category": "BorrowerAddress",
                "offset": 181,
                "length": 34
              },
              {
                "category": "BorrowerCity",
                "offset": 225,
                "length": 6
              },
              {
                "category": "BorrowerState",
                "offset": 242,
                "length": 8
              },
              {
                "category": "LenderName",
                "offset": 271,
                "length": 12
              },
              {
                "category": "LenderAddress",
                "offset": 310,
                "length": 20
              },
              {
                "category": "LenderCity",
                "offset": 340,
                "length": 8
              },
              {
                "category": "LenderState",
                "offset": 359,
                "length": 11
              },
              {
                "category": "LoanAmountWords",
                "offset": 448,
                "length": 52
              },
              {
                "category": "LoanAmountNumbers",
                "offset": 502,
                "length": 10
              },
              {
                "category": "Interest",
                "offset": 588,
                "length": 2
              }
            ],
            "predictedEntities": [
              {
                "category": "Date",
                "offset": 5,
                "length": 9
              },
              {
                "category": "BorrowerName",
                "offset": 160,
                "length": 13
              },
              {
                "category": "BorrowerAddress",
                "offset": 200,
                "length": 15
              },
              {
                "category": "BorrowerCity",
                "offset": 225,
                "length": 6
              },
              {
                "category": "BorrowerState",
                "offset": 242,
                "length": 8
              },
              {
                "category": "LenderName",
                "offset": 271,
                "length": 12
              },
              {
                "category": "LenderAddress",
                "offset": 310,
                "length": 20
              },
              {
                "category": "LenderCity",
                "offset": 340,
                "length": 8
              },
              {
                "category": "LenderState",
                "offset": 359,
                "length": 11
              },
              {
                "category": "LoanAmountWords",
                "offset": 448,
                "length": 52
              },
              {
                "category": "LoanAmountNumbers",
                "offset": 502,
                "length": 10
              },
              {
                "category": "Interest",
                "offset": 588,
                "length": 2
              }
            ],
            "regionOffset": 0,
            "regionLength": 1780
          }
        ]
      }
    },
    {
      "location": "01.txt",
      "language": "en-us",
      "projectKind": "CustomEntityRecognition",
      "customEntityRecognitionResult": {
        "entities": [
          {
            "expectedEntities": [
              {
                "category": "Date",
                "offset": 5,
                "length": 9
              },
              {
                "category": "BorrowerName",
                "offset": 160,
                "length": 13
              },
              {
                "category": "BorrowerAddress",
                "offset": 200,
                "length": 13
              },
              {
                "category": "BorrowerCity",
                "offset": 223,
                "length": 9
              },
              {
                "category": "BorrowerState",
                "offset": 243,
                "length": 8
              },
              {
                "category": "LenderName",
                "offset": 273,
                "length": 14
              },
              {
                "category": "LenderAddress",
                "offset": 314,
                "length": 15
              },
              {
                "category": "LenderCity",
                "offset": 339,
                "length": 10
              },
              {
                "category": "LenderState",
                "offset": 360,
                "length": 8
              },
              {
                "category": "LoanAmountWords",
                "offset": 446,
                "length": 66
              },
              {
                "category": "LoanAmountNumbers",
                "offset": 514,
                "length": 11
              },
              {
                "category": "Interest",
                "offset": 601,
                "length": 2
              }
            ],
            "predictedEntities": [
              {
                "category": "Date",
                "offset": 5,
                "length": 9
              },
              {
                "category": "BorrowerName",
                "offset": 160,
                "length": 13
              },
              {
                "category": "BorrowerAddress",
                "offset": 200,
                "length": 13
              },
              {
                "category": "BorrowerCity",
                "offset": 223,
                "length": 9
              },
              {
                "category": "BorrowerState",
                "offset": 243,
                "length": 8
              },
              {
                "category": "LenderName",
                "offset": 273,
                "length": 14
              },
              {
                "category": "LenderAddress",
                "offset": 314,
                "length": 15
              },
              {
                "category": "LenderCity",
                "offset": 339,
                "length": 10
              },
              {
                "category": "LenderState",
                "offset": 360,
                "length": 8
              },
              {
                "category": "LoanAmountWords",
                "offset": 446,
                "length": 66
              },
              {
                "category": "LoanAmountNumbers",
                "offset": 514,
                "length": 11
              },
              {
                "category": "Interest",
                "offset": 601,
                "length": 2
              }
            ],
            "regionOffset": 0,
            "regionLength": 1793
          }
        ]
      }
    }
  ],
  "nextLink": "https://api.example.com/language/authoring/analyze-text/projects/LoanAgreements/models/model2/evaluation/result/?api-version=2023-04-15-preview&top=2147483645&skip=100&maxpagesize=100"
}

정의

Name	Description
Error	오류 개체입니다.
ErrorCode	사람이 읽을 수 있는 오류 코드입니다.
ErrorResponse	오류 응답입니다.
InnerErrorCode	사람이 읽을 수 있는 오류 코드입니다.
InnerErrorModel	오류에 대한 보다 구체적인 정보를 포함하는 개체입니다. Microsoft One API 지침에 따라 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
PagedTextAnalysisAuthoringDocumentEvaluationResult	TextAnalysisAuthoringDocumentEvaluationResult 항목의 페이징된 컬렉션
ProjectKind
StringIndexType
TextAnalysisAuthoringCustomEntityRecognitionDocumentEvaluationResult	사용자 지정 엔터티 인식 프로젝트에 대한 문서 평가 결과를 나타냅니다.
TextAnalysisAuthoringCustomMultiLabelClassificationDocumentEvaluationResult	사용자 지정 다중 레이블 분류 프로젝트에 대한 문서 평가 결과를 나타냅니다.
TextAnalysisAuthoringCustomSingleLabelClassificationDocumentEvaluationResult	사용자 지정 단일 레이블 분류 프로젝트에 대한 문서 평가 결과를 나타냅니다.
TextAnalysisAuthoringDocumentEntityLabelEvaluationResult	평가 결과 엔터티 레이블을 나타냅니다.
TextAnalysisAuthoringDocumentEntityRecognitionEvaluationResult	문서에 대한 엔터티 인식 평가 결과를 나타냅니다.
TextAnalysisAuthoringDocumentEntityRegionEvaluationResult	문서 영역의 예상 엔터티와 예측 엔터티 간의 평가 비교를 나타냅니다.
TextAnalysisAuthoringDocumentMultiLabelClassificationEvaluationResult	평가 작업에서 생성된 예상 클래스와 예측 클래스 간의 비교를 나타냅니다.
TextAnalysisAuthoringDocumentSingleLabelClassificationEvaluationResult	평가 작업으로 인한 예상 클래스와 예측 클래스 간의 비교를 나타냅니다.

Error

오류 개체입니다.

Name	형식	Description
code	ErrorCode	서버에서 정의한 오류 코드 집합 중 하나입니다.
details	Error[]	이 보고된 오류로 이어진 특정 오류에 대한 세부 정보 배열입니다.
innererror	InnerErrorModel	오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.
message	string	사람이 읽을 수 있는 오류 표현입니다.
target	string	오류의 대상입니다.

ErrorCode

사람이 읽을 수 있는 오류 코드입니다.

Name	형식	Description
AzureCognitiveSearchIndexLimitReached	string
AzureCognitiveSearchIndexNotFound	string
AzureCognitiveSearchNotFound	string
AzureCognitiveSearchThrottling	string
Conflict	string
Forbidden	string
InternalServerError	string
InvalidArgument	string
InvalidRequest	string
NotFound	string
OperationNotFound	string
ProjectNotFound	string
QuotaExceeded	string
ServiceUnavailable	string
Timeout	string
TooManyRequests	string
Unauthorized	string
Warning	string

ErrorResponse

오류 응답입니다.

Name	형식	Description
error	Error	오류 개체입니다.

InnerErrorCode

사람이 읽을 수 있는 오류 코드입니다.

Name	형식	Description
AzureCognitiveSearchNotFound	string
AzureCognitiveSearchThrottling	string
EmptyRequest	string
ExtractionFailure	string
InvalidCountryHint	string
InvalidDocument	string
InvalidDocumentBatch	string
InvalidParameterValue	string
InvalidRequest	string
InvalidRequestBodyFormat	string
KnowledgeBaseNotFound	string
MissingInputDocuments	string
ModelVersionIncorrect	string
UnsupportedLanguageCode	string

InnerErrorModel

오류에 대한 보다 구체적인 정보를 포함하는 개체입니다. Microsoft One API 지침에 따라 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Name	형식	Description
code	InnerErrorCode	서버에서 정의한 오류 코드 집합 중 하나입니다.
details	object	오류 세부 정보입니다.
innererror	InnerErrorModel	오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

PagedTextAnalysisAuthoringDocumentEvaluationResult

TextAnalysisAuthoringDocumentEvaluationResult 항목의 페이징된 컬렉션

Name	형식	Description
nextLink	string	항목의 다음 페이지에 대한 링크
value	TextAnalysisAuthoringDocumentEvaluationResult[]: TextAnalysisAuthoringCustomEntityRecognitionDocumentEvaluationResult[] TextAnalysisAuthoringCustomMultiLabelClassificationDocumentEvaluationResult[] TextAnalysisAuthoringCustomSingleLabelClassificationDocumentEvaluationResult[]	이 페이지의 TextAnalysisAuthoringDocumentEvaluationResult 항목

ProjectKind

Name	형식	Description
CustomEntityRecognition	string	사용자 고유의 데이터를 사용하여 도메인 범주를 식별하는 추출 모델을 빌드합니다.
CustomMultiLabelClassification	string	사용자 고유의 데이터를 사용하여 텍스트를 분류하는 분류 모델을 빌드하는 경우 각 파일에는 하나 이상의 레이블이 있을 수 있습니다. 예를 들어 파일 1은 A, B 및 C로 분류되고 파일 2는 B 및 C로 분류됩니다.
CustomSingleLabelClassification	string	사용자 고유의 데이터를 사용하여 텍스트를 분류하는 분류 모델을 빌드하는 경우 각 파일에는 레이블이 하나만 있습니다. 예를 들어 파일 1은 A로 분류되고 파일 2는 B로 분류됩니다.

StringIndexType

Name	형식	Description
Utf16CodeUnit	string	오프셋 및 길이 값은 UTF-16 코드 단위에 해당합니다. 애플리케이션이 유니코드를 지원하는 언어(예: Java, JavaScript)로 작성된 경우 이 옵션을 사용합니다.

TextAnalysisAuthoringCustomEntityRecognitionDocumentEvaluationResult

사용자 지정 엔터티 인식 프로젝트에 대한 문서 평가 결과를 나타냅니다.

Name	형식	Description
customEntityRecognitionResult	TextAnalysisAuthoringDocumentEntityRecognitionEvaluationResult	엔터티 인식에 대한 평가 예측을 나타냅니다.
language	string	문서 언어를 나타냅니다. 이는 언어의 BCP-47 표현입니다. 예를 들어 영어에 "en", 영어(영국)의 경우 "en-gb", 스페인어의 경우 "es"를 사용합니다.
location	string	문서 경로를 나타냅니다.
projectKind	string: CustomEntityRecognition	프로젝트 종류를 나타냅니다.

TextAnalysisAuthoringCustomMultiLabelClassificationDocumentEvaluationResult

사용자 지정 다중 레이블 분류 프로젝트에 대한 문서 평가 결과를 나타냅니다.

Name	형식	Description
customMultiLabelClassificationResult	TextAnalysisAuthoringDocumentMultiLabelClassificationEvaluationResult	다중 레이블 분류에 대한 평가 예측을 나타냅니다.
language	string	문서 언어를 나타냅니다. 이는 언어의 BCP-47 표현입니다. 예를 들어 영어에 "en", 영어(영국)의 경우 "en-gb", 스페인어의 경우 "es"를 사용합니다.
location	string	문서 경로를 나타냅니다.
projectKind	string: CustomMultiLabelClassification	프로젝트 종류를 나타냅니다.

TextAnalysisAuthoringCustomSingleLabelClassificationDocumentEvaluationResult

사용자 지정 단일 레이블 분류 프로젝트에 대한 문서 평가 결과를 나타냅니다.

Name	형식	Description
customSingleLabelClassificationResult	TextAnalysisAuthoringDocumentSingleLabelClassificationEvaluationResult	단일 레이블 분류에 대한 평가 예측을 나타냅니다.
language	string	문서 언어를 나타냅니다. 이는 언어의 BCP-47 표현입니다. 예를 들어 영어에 "en", 영어(영국)의 경우 "en-gb", 스페인어의 경우 "es"를 사용합니다.
location	string	문서 경로를 나타냅니다.
projectKind	string: CustomSingleLabelClassification	프로젝트 종류를 나타냅니다.

TextAnalysisAuthoringDocumentEntityLabelEvaluationResult

평가 결과 엔터티 레이블을 나타냅니다.

Name	형식	Description
category	string	엔터티 범주를 나타냅니다.
length	integer	엔터티 길이를 나타냅니다.
offset	integer	원래 텍스트를 기준으로 엔터티 오프셋 인덱스를 나타냅니다.

TextAnalysisAuthoringDocumentEntityRecognitionEvaluationResult

문서에 대한 엔터티 인식 평가 결과를 나타냅니다.

Name	형식	Description
entities	TextAnalysisAuthoringDocumentEntityRegionEvaluationResult[]	레이블이 지정된 문서 엔터티를 나타냅니다.

TextAnalysisAuthoringDocumentEntityRegionEvaluationResult

문서 영역의 예상 엔터티와 예측 엔터티 간의 평가 비교를 나타냅니다.

Name	형식	Description
expectedEntities	TextAnalysisAuthoringDocumentEntityLabelEvaluationResult[]	지역의 예상 엔터티 레이블을 나타냅니다.
predictedEntities	TextAnalysisAuthoringDocumentEntityLabelEvaluationResult[]	지역의 예측 엔터티 레이블을 나타냅니다.
regionLength	integer	영역 길이를 나타냅니다.
regionOffset	integer	지역 오프셋을 나타냅니다.

TextAnalysisAuthoringDocumentMultiLabelClassificationEvaluationResult

평가 작업에서 생성된 예상 클래스와 예측 클래스 간의 비교를 나타냅니다.

Name	형식	Description
expectedClasses	string[]	문서의 예상 클래스를 나타냅니다.
predictedClasses	string[]	문서의 예측 클래스를 나타냅니다.

TextAnalysisAuthoringDocumentSingleLabelClassificationEvaluationResult

평가 작업으로 인한 예상 클래스와 예측 클래스 간의 비교를 나타냅니다.

Name	형식	Description
expectedClass	string	문서의 예상 클래스를 나타냅니다.
predictedClass	string	문서의 예측 클래스를 나타냅니다.

다음을 통해 공유