Text Analysis Authoring - Get Model Evaluation Results

Reference

Služba:: Azure AI Services

Verze rozhraní API:: 2023-04-01

Získá podrobné výsledky vyhodnocení pro natrénovaný model. To zahrnuje nezpracované výsledky odvozování dat zahrnutých do procesu vyhodnocení.

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

S volitelnými parametry:

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
Endpoint	path	True	string url	Podporovaný koncový bod služeb Cognitive Services, například https://.api.cognitiveservices.azure.com.
projectName	path	True	string	Název nového projektu.
trainedModelLabel	path	True	string	Popisek natrénovaného modelu.
api-version	query	True	string	Verze rozhraní API, která se má použít pro tuto operaci.
stringIndexType	query	True	StringIndexType	Určuje metodu použitou k interpretaci posunů řetězců. Další informace najdete v tématu https://aka.ms/text-analytics-offsets.
maxpagesize	query		integer int32	Maximální počet výsledků položek na stránku.
skip	query		integer int32	Počet položek výsledků, které se mají přeskočit.
top	query		integer int32	Počet výsledných položek, které se mají vrátit.

Odpovědi

Name	Typ	Description
200 OK	PagedTextAnalysisAuthoringDocumentEvaluationResult	Požadavek byl úspěšný.
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Zabezpečení

Ocp-Apim-Subscription-Key

Typ: apiKey
V: header

OAuth2Auth

Typ: oauth2
Tok: accessCode
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize
URL tokenu: https://login.microsoftonline.com/common/oauth2/token

Rozsahy

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

Příklady

SuccessfulGetModelEvaluation

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:: 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"
}

Definice

Name	Description
Error	Objekt chyby.
ErrorCode	Kód chyby čitelné člověkem
ErrorResponse	Chybová odpověď.
InnerErrorCode	Kód chyby čitelné člověkem
InnerErrorModel	Objekt obsahující konkrétnější informace o chybě. Podle pokynů k rozhraní API Microsoft One – https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
PagedTextAnalysisAuthoringDocumentEvaluationResult	Paged collection of TextAnalysisAuthoringDocumentEvaluationResult items
ProjectKind
StringIndexType
TextAnalysisAuthoringCustomEntityRecognitionDocumentEvaluationResult	Představuje výsledek vyhodnocení dokumentu pro projekt rozpoznávání vlastních entit.
TextAnalysisAuthoringCustomMultiLabelClassificationDocumentEvaluationResult	Představuje výsledek vyhodnocení dokumentu pro vlastní projekt klasifikace s více popisky.
TextAnalysisAuthoringCustomSingleLabelClassificationDocumentEvaluationResult	Představuje výsledek vyhodnocení dokumentu pro vlastní projekt klasifikace s jedním popiskem.
TextAnalysisAuthoringDocumentEntityLabelEvaluationResult	Představuje popisek entity výsledku vyhodnocení.
TextAnalysisAuthoringDocumentEntityRecognitionEvaluationResult	Představuje výsledek vyhodnocení rozpoznávání entit pro dokument.
TextAnalysisAuthoringDocumentEntityRegionEvaluationResult	Představuje porovnání vyhodnocení mezi očekávanými a predikovanými entitami oblasti dokumentu.
TextAnalysisAuthoringDocumentMultiLabelClassificationEvaluationResult	Představuje porovnání mezi očekávanými a predikovanými třídami, které jsou výsledkem operace vyhodnocení.
TextAnalysisAuthoringDocumentSingleLabelClassificationEvaluationResult	Představuje porovnání mezi očekávanou a predikovanou třídou, která je výsledkem operace vyhodnocení.

Error

Objekt chyby.

Name	Typ	Description
code	ErrorCode	Jedna ze serverově definovaných kódů chyb.
details	Error[]	Pole podrobností o konkrétních chybách, které vedly k této nahlášené chybě.
innererror	InnerErrorModel	Objekt obsahující konkrétnější informace, než je aktuální objekt o chybě.
message	string	Čitelné znázornění chyby člověkem.
target	string	Cíl chyby.

ErrorCode

Kód chyby čitelné člověkem

Name	Typ	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

Chybová odpověď.

Name	Typ	Description
error	Error	Objekt chyby.

InnerErrorCode

Kód chyby čitelné člověkem

Name	Typ	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

Objekt obsahující konkrétnější informace o chybě. Podle pokynů k rozhraní API Microsoft One – https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Name	Typ	Description
code	InnerErrorCode	Jedna ze serverově definovaných kódů chyb.
details	object	Podrobnosti o chybě
innererror	InnerErrorModel	Objekt obsahující konkrétnější informace, než je aktuální objekt o chybě.
message	string	Zpráva o chybě.
target	string	Cíl chyby

PagedTextAnalysisAuthoringDocumentEvaluationResult

Paged collection of TextAnalysisAuthoringDocumentEvaluationResult items

Name	Typ	Description
nextLink	string	Odkaz na další stránku položek
value	TextAnalysisAuthoringDocumentEvaluationResult[]: TextAnalysisAuthoringCustomEntityRecognitionDocumentEvaluationResult[] TextAnalysisAuthoringCustomMultiLabelClassificationDocumentEvaluationResult[] TextAnalysisAuthoringCustomSingleLabelClassificationDocumentEvaluationResult[]	Položky TextAnalysisAuthoringDocumentEvaluationResult na této stránce

ProjectKind

Name	Typ	Description
CustomEntityRecognition	string	Pro vytvoření modelu extrakce pro identifikaci kategorií domény pomocí vlastních dat.
CustomMultiLabelClassification	string	Vytvoření klasifikačního modelu pro klasifikaci textu pomocí vlastních dat Každý soubor může mít jeden nebo více popisků. Například soubor 1 je klasifikován jako A, B a C a soubor 2 je klasifikován jako B a C.
CustomSingleLabelClassification	string	Vytvoření klasifikačního modelu pro klasifikaci textu pomocí vlastních dat Každý soubor bude mít jenom jeden popisek. Například soubor 1 je klasifikován jako A a soubor 2 je klasifikován jako B.

StringIndexType

Name	Typ	Description
Utf16CodeUnit	string	Hodnoty posunu a délky budou odpovídat jednotkám kódu UTF-16. Tuto možnost použijte, pokud je vaše aplikace napsaná v jazyce, který podporuje Unicode, například JavaScript.

TextAnalysisAuthoringCustomEntityRecognitionDocumentEvaluationResult

Představuje výsledek vyhodnocení dokumentu pro projekt rozpoznávání vlastních entit.

Name	Typ	Description
customEntityRecognitionResult	TextAnalysisAuthoringDocumentEntityRecognitionEvaluationResult	Představuje predikci vyhodnocení pro rozpoznávání entit.
language	string	Představuje jazyk dokumentu. Toto je reprezentace jazyka BCP-47. Například použijte "en" pro angličtinu, "en-gb" pro angličtinu (UK), "es" pro španělštinu atd.
location	string	Představuje cestu k dokumentu.
projectKind	string: CustomEntityRecognition	Představuje druh projektu.

TextAnalysisAuthoringCustomMultiLabelClassificationDocumentEvaluationResult

Představuje výsledek vyhodnocení dokumentu pro vlastní projekt klasifikace s více popisky.

Name	Typ	Description
customMultiLabelClassificationResult	TextAnalysisAuthoringDocumentMultiLabelClassificationEvaluationResult	Představuje predikci vyhodnocení pro klasifikaci více popisků.
language	string	Představuje jazyk dokumentu. Toto je reprezentace jazyka BCP-47. Například použijte "en" pro angličtinu, "en-gb" pro angličtinu (UK), "es" pro španělštinu atd.
location	string	Představuje cestu k dokumentu.
projectKind	string: CustomMultiLabelClassification	Představuje druh projektu.

TextAnalysisAuthoringCustomSingleLabelClassificationDocumentEvaluationResult

Představuje výsledek vyhodnocení dokumentu pro vlastní projekt klasifikace s jedním popiskem.

Name	Typ	Description
customSingleLabelClassificationResult	TextAnalysisAuthoringDocumentSingleLabelClassificationEvaluationResult	Představuje predikci vyhodnocení pro klasifikaci s jedním popiskem.
language	string	Představuje jazyk dokumentu. Toto je reprezentace jazyka BCP-47. Například použijte "en" pro angličtinu, "en-gb" pro angličtinu (UK), "es" pro španělštinu atd.
location	string	Představuje cestu k dokumentu.
projectKind	string: CustomSingleLabelClassification	Představuje druh projektu.

TextAnalysisAuthoringDocumentEntityLabelEvaluationResult

Představuje popisek entity výsledku vyhodnocení.

Name	Typ	Description
category	string	Představuje kategorii entity.
length	integer	Představuje délku entity.
offset	integer	Představuje index posunu entity vzhledem k původnímu textu.

TextAnalysisAuthoringDocumentEntityRecognitionEvaluationResult

Představuje výsledek vyhodnocení rozpoznávání entit pro dokument.

Name	Typ	Description
entities	TextAnalysisAuthoringDocumentEntityRegionEvaluationResult[]	Představuje dokument označený entitami.

TextAnalysisAuthoringDocumentEntityRegionEvaluationResult

Představuje porovnání vyhodnocení mezi očekávanými a predikovanými entitami oblasti dokumentu.

Name	Typ	Description
expectedEntities	TextAnalysisAuthoringDocumentEntityLabelEvaluationResult[]	Představuje očekávané popisky entit oblasti.
predictedEntities	TextAnalysisAuthoringDocumentEntityLabelEvaluationResult[]	Představuje předpovězené popisky entit oblasti.
regionLength	integer	Představuje délku oblasti.
regionOffset	integer	Představuje posun oblasti.

TextAnalysisAuthoringDocumentMultiLabelClassificationEvaluationResult

Představuje porovnání mezi očekávanými a predikovanými třídami, které jsou výsledkem operace vyhodnocení.

Name	Typ	Description
expectedClasses	string[]	Představuje očekávané třídy dokumentu.
predictedClasses	string[]	Představuje predikované třídy dokumentu.

TextAnalysisAuthoringDocumentSingleLabelClassificationEvaluationResult

Představuje porovnání mezi očekávanou a predikovanou třídou, která je výsledkem operace vyhodnocení.

Name	Typ	Description
expectedClass	string	Představuje očekávanou třídu dokumentu.
predictedClass	string	Představuje predikovanou třídu dokumentu.

Sdílet prostřednictvím