Text Analysis Authoring - Get Model Evaluation Results
학습된 모델에 대한 평가의 자세한 결과를 가져옵니다. 여기에는 평가 프로세스에 포함된 데이터에 대한 원시 유추 결과가 포함됩니다.
GET {Endpoint}/language/authoring/analyze-text/projects/{projectName}/models/{trainedModelLabel}/evaluation/result?stringIndexType=Utf16CodeUnit&api-version=2023-04-01GET {Endpoint}/language/authoring/analyze-text/projects/{projectName}/models/{trainedModelLabel}/evaluation/result?stringIndexType=Utf16CodeUnit&top={top}&skip={skip}&maxpagesize={maxpagesize}&api-version=2023-04-01URI 매개 변수
| Name | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Endpoint
|
path | True |
string |
지원되는 Cognitive Services 엔드포인트(예: https://.api.cognitiveservices.azure.com). |
|
project
|
path | True |
string |
사용할 프로젝트의 이름입니다. |
|
trained
|
path | True |
string |
학습된 모델 레이블입니다. |
|
api-version
|
query | True |
string |
클라이언트 API 버전입니다. |
|
string
|
query | True |
문자열 오프셋을 해석하는 데 사용되는 메서드를 지정합니다. 자세한 내용은 https://aka.ms/text-analytics-offsets를 참조하십시오. |
|
|
maxpagesize
|
query |
integer int32 |
단일 응답에 포함할 최대 리소스 수입니다. |
|
|
skip
|
query |
integer int32 |
반환할 첫 번째 리소스의 컬렉션에 대한 오프셋입니다. |
|
|
top
|
query |
integer int32 |
컬렉션에서 반환할 최대 리소스 수입니다. |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK |
평가 결과 목록입니다. |
|
| Other Status Codes |
오류 응답입니다. |
보안
AADToken
Azure Active Directory OAuth2 흐름입니다. Azure 역할 기반 액세스 제어와 쌍을 이루는 경우 Azure Maps REST API에 대한 액세스를 제어하는 데 사용할 수 있습니다. Azure 역할 기반 액세스 제어는 하나 이상의 Azure Maps 리소스 계정 또는 하위 리소스에 대한 액세스를 지정하는 데 사용됩니다. 모든 사용자, 그룹 또는 서비스 주체는 기본 제공 역할 또는 REST API를 Azure Maps 하나 이상의 권한으로 구성된 사용자 지정 역할을 통해 액세스 권한을 부여할 수 있습니다.
시나리오를 구현하려면 인증 개념을 보는 것이 좋습니다. 요약하자면, 이 보안 정의는 특정 API 및 범위에 대한 액세스 제어가 가능한 개체를 통해 애플리케이션을 모델링하는 솔루션을 제공합니다.
참고
- 이 보안 정의는 애플리케이션이
x-ms-client-id액세스를 요청하는 Azure Maps 리소스를 나타내기 위해 헤더를 사용해야 합니다. 이는 지도 관리 API에서 가져올 수 있습니다.
Authorization URL 은 Azure 퍼블릭 클라우드 instance 관련됩니다. 소버린 클라우드에는 고유한 권한 부여 URL 및 Azure Active Directory 구성이 있습니다.
* Azure 역할 기반 액세스 제어는 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면에서 구성됩니다.
* Azure Maps Web SDK를 사용하면 여러 사용 사례에 대한 애플리케이션의 구성 기반 설정을 사용할 수 있습니다.
- 현재 Azure Active Directory v1.0 또는 v2.0 은 회사, 학교 및 게스트를 지원하지만 개인 계정은 지원하지 않습니다.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
| Name | Description |
|---|---|
| https://cognitiveservices.azure.com/.default | https://cognitiveservices.azure.com/.default |
Ocp-Apim-Subscription-Key
언어 서비스 리소스에 대한 구독 키입니다.
Type:
apiKey
In:
header
예제
Successful Get Model Evaluation
Sample Request
GET {Endpoint}/language/authoring/analyze-text/projects/LoanAgreements/models/model2/evaluation/result?stringIndexType=Utf16CodeUnit&maxpagesize=10&api-version=2023-04-01
Sample Response
{
"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": "{Endpoint}/language/authoring/analyze-text/projects/LoanAgreements/models/model2/evaluation/result/?api-version=2023-04-01&top=2147483645&skip={maxpagesize}&maxpagesize={maxpagesize}"
}정의
Error
Error 개체.
| Name | 형식 | Description |
|---|---|---|
| code |
서버 정의 오류 코드 집합 중 하나입니다. |
|
| details |
Error[] |
이 보고된 오류로 이어진 특정 오류에 대한 세부 정보 배열입니다. |
| innererror |
오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다. |
|
| 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 |
서버 정의 오류 코드 집합 중 하나입니다. |
|
| details |
object |
오류 세부 정보입니다. |
| innererror |
오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다. |
|
| message |
string |
오류 메시지입니다. |
| target |
string |
오류 대상입니다. |
ProjectKind
프로젝트 종류입니다.
| Name | 형식 | Description |
|---|---|---|
| CustomEntityRecognition |
string |
사용자 고유의 데이터를 사용하여 도메인 범주를 식별하는 추출 모델을 빌드합니다. |
| CustomMultiLabelClassification |
string |
사용자 고유의 데이터를 사용하여 텍스트를 분류하는 분류 모델을 빌드합니다. 각 파일에는 하나 이상의 레이블이 있을 수 있습니다. 예를 들어 파일 1은 A, B 및 C로 분류되고 파일 2는 B 및 C로 분류됩니다. |
| CustomSingleLabelClassification |
string |
사용자 고유의 데이터를 사용하여 텍스트를 분류하는 분류 모델을 빌드합니다. 각 파일에는 레이블이 하나만 있습니다. 예를 들어 파일 1은 A로 분류되고 파일 2는 B로 분류됩니다. |
StringIndexType
문자열 오프셋을 해석하는 데 사용되는 메서드를 지정합니다. 자세한 내용은 https://aka.ms/text-analytics-offsets를 참조하십시오.
| Name | 형식 | Description |
|---|---|---|
| Utf16CodeUnit |
string |
오프셋 및 길이 값은 UTF-16 코드 단위에 해당합니다. 애플리케이션이 유니코드를 지원하는 언어(예: Java, JavaScript)로 작성된 경우 이 옵션을 사용합니다. |
TextAnalysisAuthoringCustomEntityRecognitionDocumentEvaluationResult
사용자 지정 엔터티 인식 프로젝트에 대한 문서 평가 결과를 나타냅니다.
| Name | 형식 | Description |
|---|---|---|
| customEntityRecognitionResult |
Text |
엔터티 인식에 대한 평가 예측을 나타냅니다. |
| language |
string |
문서 언어를 나타냅니다. 이는 언어의 BCP-47 표현입니다. 예를 들어 영어의 경우 "en", 영어(영국)의 경우 "en-gb", 스페인어의 경우 "es"를 사용합니다. |
| location |
string |
문서 경로를 나타냅니다. |
| projectKind |
string:
Custom |
프로젝트 종류를 나타냅니다. |
TextAnalysisAuthoringCustomMultiLabelClassificationDocumentEvaluationResult
사용자 지정 다중 레이블 분류 프로젝트에 대한 문서 평가 결과를 나타냅니다.
| Name | 형식 | Description |
|---|---|---|
| customMultiLabelClassificationResult |
Text |
다중 레이블 분류에 대한 평가 예측을 나타냅니다. |
| language |
string |
문서 언어를 나타냅니다. 이는 언어의 BCP-47 표현입니다. 예를 들어 영어의 경우 "en", 영어(영국)의 경우 "en-gb", 스페인어의 경우 "es"를 사용합니다. |
| location |
string |
문서 경로를 나타냅니다. |
| projectKind |
string:
Custom |
프로젝트 종류를 나타냅니다. |
TextAnalysisAuthoringCustomSingleLabelClassificationDocumentEvaluationResult
사용자 지정 단일 레이블 분류 프로젝트에 대한 문서 평가 결과를 나타냅니다.
| Name | 형식 | Description |
|---|---|---|
| customSingleLabelClassificationResult |
Text |
단일 레이블 분류에 대한 평가 예측을 나타냅니다. |
| language |
string |
문서 언어를 나타냅니다. 이는 언어의 BCP-47 표현입니다. 예를 들어 영어의 경우 "en", 영어(영국)의 경우 "en-gb", 스페인어의 경우 "es"를 사용합니다. |
| location |
string |
문서 경로를 나타냅니다. |
| projectKind |
string:
Custom |
프로젝트 종류를 나타냅니다. |
TextAnalysisAuthoringDocumentEntityLabelEvaluationResult
평가 결과 엔터티 레이블을 나타냅니다.
| Name | 형식 | Description |
|---|---|---|
| category |
string |
엔터티 범주를 나타냅니다. |
| length |
integer |
엔터티 길이를 나타냅니다. |
| offset |
integer |
원래 텍스트를 기준으로 엔터티 오프셋 인덱스를 나타냅니다. |
TextAnalysisAuthoringDocumentEntityRecognitionEvaluationResult
문서에 대한 엔터티 인식 평가 결과를 나타냅니다.
| Name | 형식 | Description |
|---|---|---|
| entities |
레이블이 지정된 문서 엔터티를 나타냅니다. |
TextAnalysisAuthoringDocumentEntityRegionEvaluationResult
문서 영역의 예상 엔터티와 예측 엔터티 간의 평가 비교를 나타냅니다.
| Name | 형식 | Description |
|---|---|---|
| expectedEntities |
지역의 예상 엔터티 레이블을 나타냅니다. |
|
| predictedEntities |
지역의 예측 엔터티 레이블을 나타냅니다. |
|
| regionLength |
integer |
영역 길이를 나타냅니다. |
| regionOffset |
integer |
지역 오프셋을 나타냅니다. |
TextAnalysisAuthoringDocumentMultiLabelClassificationEvaluationResult
평가 작업의 결과인 예상 클래스와 예측 클래스 간의 비교를 나타냅니다.
| Name | 형식 | Description |
|---|---|---|
| expectedClasses |
string[] |
문서의 예상 클래스를 나타냅니다. |
| predictedClasses |
string[] |
문서의 예측 클래스를 나타냅니다. |
TextAnalysisAuthoringDocumentSingleLabelClassificationEvaluationResult
평가 작업으로 인한 예상 클래스와 예측 클래스 간의 비교를 나타냅니다.
| Name | 형식 | Description |
|---|---|---|
| expectedClass |
string |
문서의 예상 클래스를 나타냅니다. |
| predictedClass |
string |
문서의 예측 클래스를 나타냅니다. |
TextAnalysisAuthoringEvaluationResults
평가 작업의 결과 목록을 나타냅니다.
| Name | 형식 | Description |
|---|---|---|
| nextLink |
string |
다음 페이지 링크입니다. |
| value | TextAnalysisAuthoringDocumentEvaluationResult[]: |
문서 평가 결과의 THe 목록입니다. |