Text Analysis Authoring - Get Model Evaluation Results

Referentie

Service:: Azure AI Services

API-versie:: 2023-04-01

Haalt de gedetailleerde resultaten van de evaluatie voor een getraind model op. Dit omvat de onbewerkte deductieresultaten voor de gegevens die zijn opgenomen in het evaluatieproces.

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

Met optionele parameters:

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-parameters

Name	In	Vereist	Type	Description
Endpoint	path	True	string url	Ondersteund Cognitive Services-eindpunt, bijvoorbeeld https://.api.cognitiveservices.azure.com.
projectName	path	True	string	De naam van het nieuwe project.
trainedModelLabel	path	True	string	Het getrainde modellabel.
api-version	query	True	string	De API-versie die voor deze bewerking moet worden gebruikt.
stringIndexType	query	True	StringIndexType	Hiermee geeft u de methode op die wordt gebruikt om tekenreeksverschuivingen te interpreteren. Zie https://aka.ms/text-analytics-offsetsvoor meer informatie.
maxpagesize	query		integer int32	Het maximum aantal resultaatitems per pagina.
skip	query		integer int32	Het aantal resultaatitems dat moet worden overgeslagen.
top	query		integer int32	Het aantal resultaatitems dat moet worden geretourneerd.

Antwoorden

Name	Type	Description
200 OK	PagedTextAnalysisAuthoringDocumentEvaluationResult	De aanvraag is voltooid.
Other Status Codes	ErrorResponse	Een onverwachte foutreactie.

Beveiliging

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

OAuth2Auth

Type: oauth2
Stroom: accessCode
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize
Token-URL: https://login.microsoftonline.com/common/oauth2/token

Bereiken

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

Voorbeelden

SuccessfulGetModelEvaluation

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:: 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"
}

Definities

Name	Description
Error	Het foutobject.
ErrorCode	Leesbare foutcode.
ErrorResponse	Foutreactie.
InnerErrorCode	Leesbare foutcode.
InnerErrorModel	Een object met meer specifieke informatie over de fout. Volgens de richtlijnen voor Microsoft One-API- https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
PagedTextAnalysisAuthoringDocumentEvaluationResult	Gepaginade verzameling TextAnalysisAuthoringDocumentEvaluationResult-items
ProjectKind
StringIndexType
TextAnalysisAuthoringCustomEntityRecognitionDocumentEvaluationResult	Vertegenwoordigt het documentevaluatieresultaat voor een aangepast entiteitsherkenningsproject.
TextAnalysisAuthoringCustomMultiLabelClassificationDocumentEvaluationResult	Vertegenwoordigt het documentevaluatieresultaat voor een aangepast classificatieproject met meerdere labels.
TextAnalysisAuthoringCustomSingleLabelClassificationDocumentEvaluationResult	Vertegenwoordigt het documentevaluatieresultaat voor een aangepast classificatieproject met één label.
TextAnalysisAuthoringDocumentEntityLabelEvaluationResult	Vertegenwoordigt een entiteitslabel voor evaluatieresultaten.
TextAnalysisAuthoringDocumentEntityRecognitionEvaluationResult	Vertegenwoordigt het evaluatieresultaat voor entiteitsherkenning voor een document.
TextAnalysisAuthoringDocumentEntityRegionEvaluationResult	Vertegenwoordigt de evaluatievergelijking tussen de verwachte en voorspelde entiteiten van een documentregio.
TextAnalysisAuthoringDocumentMultiLabelClassificationEvaluationResult	Vertegenwoordigt de vergelijking tussen de verwachte en voorspelde klassen die het resultaat zijn van de evaluatiebewerking.
TextAnalysisAuthoringDocumentSingleLabelClassificationEvaluationResult	Vertegenwoordigt de vergelijking tussen de verwachte en voorspelde klasse die het resultaat is van een evaluatiebewerking.

Error

Het foutobject.

Name	Type	Description
code	ErrorCode	Een van een door de server gedefinieerde set foutcodes.
details	Error[]	Een matrix met details over specifieke fouten die hebben geleid tot deze gemelde fout.
innererror	InnerErrorModel	Een object met meer specifieke informatie dan het huidige object over de fout.
message	string	Een leesbare weergave van de fout.
target	string	Het doel van de fout.

ErrorCode

Leesbare foutcode.

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

Foutreactie.

Name	Type	Description
error	Error	Het foutobject.

InnerErrorCode

Leesbare foutcode.

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

Een object met meer specifieke informatie over de fout. Volgens de richtlijnen voor Microsoft One-API- https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Name	Type	Description
code	InnerErrorCode	Een van een door de server gedefinieerde set foutcodes.
details	object	Foutdetails.
innererror	InnerErrorModel	Een object met meer specifieke informatie dan het huidige object over de fout.
message	string	Foutmelding.
target	string	Foutdoel.

PagedTextAnalysisAuthoringDocumentEvaluationResult

Gepaginade verzameling TextAnalysisAuthoringDocumentEvaluationResult-items

Name	Type	Description
nextLink	string	De koppeling naar de volgende pagina met items
value	TextAnalysisAuthoringDocumentEvaluationResult[]: TextAnalysisAuthoringCustomEntityRecognitionDocumentEvaluationResult[] TextAnalysisAuthoringCustomMultiLabelClassificationDocumentEvaluationResult[] TextAnalysisAuthoringCustomSingleLabelClassificationDocumentEvaluationResult[]	De textAnalysisAuthoringDocumentEvaluationResult-items op deze pagina

ProjectKind

Name	Type	Description
CustomEntityRecognition	string	Voor het bouwen van een extractiemodel om uw domeincategorieën te identificeren met behulp van uw eigen gegevens.
CustomMultiLabelClassification	string	Voor het bouwen van een classificatiemodel om tekst te classificeren met behulp van uw eigen gegevens. Elk bestand kan een of meer labels hebben. Bestand 1 is bijvoorbeeld geclassificeerd als A, B en C en bestand 2 is geclassificeerd als B en C.
CustomSingleLabelClassification	string	Voor het bouwen van een classificatiemodel om tekst te classificeren met behulp van uw eigen gegevens. Elk bestand heeft slechts één label. Bestand 1 is bijvoorbeeld geclassificeerd als A en bestand 2 wordt geclassificeerd als B.

StringIndexType

Name	Type	Description
Utf16CodeUnit	string	De offset- en lengtewaarden komen overeen met UTF-16-code-eenheden. Gebruik deze optie als uw toepassing is geschreven in een taal die Unicode ondersteunt, bijvoorbeeld JavaScript.

TextAnalysisAuthoringCustomEntityRecognitionDocumentEvaluationResult

Vertegenwoordigt het documentevaluatieresultaat voor een aangepast entiteitsherkenningsproject.

Name	Type	Description
customEntityRecognitionResult	TextAnalysisAuthoringDocumentEntityRecognitionEvaluationResult	Vertegenwoordigt de evaluatievoorspelling voor entiteitsherkenning.
language	string	Vertegenwoordigt de documenttaal. Dit is BCP-47-weergave van een taal. Gebruik bijvoorbeeld "en" voor Engels, "en-gb" voor Engels (VK), "es" voor Spaans, enzovoort.
location	string	Vertegenwoordigt het documentpad.
projectKind	string: CustomEntityRecognition	Vertegenwoordigt het projecttype.

TextAnalysisAuthoringCustomMultiLabelClassificationDocumentEvaluationResult

Vertegenwoordigt het documentevaluatieresultaat voor een aangepast classificatieproject met meerdere labels.

Name	Type	Description
customMultiLabelClassificationResult	TextAnalysisAuthoringDocumentMultiLabelClassificationEvaluationResult	Vertegenwoordigt de evaluatievoorspelling voor classificatie met meerdere labels.
language	string	Vertegenwoordigt de documenttaal. Dit is BCP-47-weergave van een taal. Gebruik bijvoorbeeld "en" voor Engels, "en-gb" voor Engels (VK), "es" voor Spaans, enzovoort.
location	string	Vertegenwoordigt het documentpad.
projectKind	string: CustomMultiLabelClassification	Vertegenwoordigt het projecttype.

TextAnalysisAuthoringCustomSingleLabelClassificationDocumentEvaluationResult

Vertegenwoordigt het documentevaluatieresultaat voor een aangepast classificatieproject met één label.

Name	Type	Description
customSingleLabelClassificationResult	TextAnalysisAuthoringDocumentSingleLabelClassificationEvaluationResult	Vertegenwoordigt de evaluatievoorspelling voor classificatie van één label.
language	string	Vertegenwoordigt de documenttaal. Dit is BCP-47-weergave van een taal. Gebruik bijvoorbeeld "en" voor Engels, "en-gb" voor Engels (VK), "es" voor Spaans, enzovoort.
location	string	Vertegenwoordigt het documentpad.
projectKind	string: CustomSingleLabelClassification	Vertegenwoordigt het projecttype.

TextAnalysisAuthoringDocumentEntityLabelEvaluationResult

Vertegenwoordigt een entiteitslabel voor evaluatieresultaten.

Name	Type	Description
category	string	Vertegenwoordigt de entiteitscategorie.
length	integer	Vertegenwoordigt de lengte van de entiteit.
offset	integer	Vertegenwoordigt de offsetindex van de entiteit ten opzichte van de oorspronkelijke tekst.

TextAnalysisAuthoringDocumentEntityRecognitionEvaluationResult

Vertegenwoordigt het evaluatieresultaat voor entiteitsherkenning voor een document.

Name	Type	Description
entities	TextAnalysisAuthoringDocumentEntityRegionEvaluationResult[]	Vertegenwoordigt de gelabelde entiteiten van het document.

TextAnalysisAuthoringDocumentEntityRegionEvaluationResult

Vertegenwoordigt de evaluatievergelijking tussen de verwachte en voorspelde entiteiten van een documentregio.

Name	Type	Description
expectedEntities	TextAnalysisAuthoringDocumentEntityLabelEvaluationResult[]	Vertegenwoordigt de verwachte entiteitslabels van de regio.
predictedEntities	TextAnalysisAuthoringDocumentEntityLabelEvaluationResult[]	Vertegenwoordigt de voorspelde entiteitslabels van de regio.
regionLength	integer	Vertegenwoordigt de lengte van de regio.
regionOffset	integer	Vertegenwoordigt de regio-offset.

TextAnalysisAuthoringDocumentMultiLabelClassificationEvaluationResult

Vertegenwoordigt de vergelijking tussen de verwachte en voorspelde klassen die het resultaat zijn van de evaluatiebewerking.

Name	Type	Description
expectedClasses	string[]	Vertegenwoordigt de verwachte klassen van het document.
predictedClasses	string[]	Vertegenwoordigt de voorspelde klassen van het document.

TextAnalysisAuthoringDocumentSingleLabelClassificationEvaluationResult

Vertegenwoordigt de vergelijking tussen de verwachte en voorspelde klasse die het resultaat is van een evaluatiebewerking.

Name	Type	Description
expectedClass	string	Vertegenwoordigt de verwachte klasse van het document.
predictedClass	string	Vertegenwoordigt de voorspelde klasse van het document.

Delen via