Text Analysis Authoring - Get Model Evaluation Results

Riferimento

Servizio:: Azure AI Services

Versione API:: 2023-04-01

Ottiene i risultati dettagliati della valutazione per un modello sottoposto a training. Sono inclusi i risultati di inferenza non elaborati per i dati inclusi nel processo di valutazione.

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

Con parametri facoltativi:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
Endpoint	path	True	string url	Endpoint di Servizi cognitivi supportati, ad esempio https://.api.cognitiveservices.azure.com.
projectName	path	True	string	Nome del nuovo progetto.
trainedModelLabel	path	True	string	Etichetta del modello con training.
api-version	query	True	string	Versione dell'API da usare per questa operazione.
stringIndexType	query	True	StringIndexType	Specifica il metodo utilizzato per interpretare gli offset di stringa. Per altre informazioni, vedere https://aka.ms/text-analytics-offsets.
maxpagesize	query		integer int32	Numero massimo di elementi dei risultati per pagina.
skip	query		integer int32	Numero di elementi dei risultati da ignorare.
top	query		integer int32	Numero di elementi dei risultati da restituire.

Risposte

Nome	Tipo	Descrizione
200 OK	PagedTextAnalysisAuthoringDocumentEvaluationResult	La richiesta ha avuto esito positivo.
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Sicurezza

Ocp-Apim-Subscription-Key

Tipo: apiKey
In: header

OAuth2Auth

Tipo: oauth2
Flow: accessCode
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize
URL token: https://login.microsoftonline.com/common/oauth2/token

Ambiti

Nome	Descrizione
https://cognitiveservices.azure.com/.default

Esempio

SuccessfulGetModelEvaluation

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:: 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"
}

Definizioni

Nome	Descrizione
Error	Oggetto error.
ErrorCode	Codice di errore leggibile.
ErrorResponse	Risposta di errore.
InnerErrorCode	Codice di errore leggibile.
InnerErrorModel	Oggetto contenente informazioni più specifiche sull'errore. In base alle linee guida dell'API Microsoft One , https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
PagedTextAnalysisAuthoringDocumentEvaluationResult	Raccolta di pagine di elementi TextAnalysisAuthoringDocumentEvaluationResult
ProjectKind
StringIndexType
TextAnalysisAuthoringCustomEntityRecognitionDocumentEvaluationResult	Rappresenta il risultato della valutazione del documento per un progetto di riconoscimento di entità personalizzato.
TextAnalysisAuthoringCustomMultiLabelClassificationDocumentEvaluationResult	Rappresenta il risultato della valutazione del documento per un progetto di classificazione con più etichette personalizzato.
TextAnalysisAuthoringCustomSingleLabelClassificationDocumentEvaluationResult	Rappresenta il risultato della valutazione del documento per un progetto di classificazione con etichetta singola personalizzato.
TextAnalysisAuthoringDocumentEntityLabelEvaluationResult	Rappresenta un'etichetta di entità del risultato della valutazione.
TextAnalysisAuthoringDocumentEntityRecognitionEvaluationResult	Rappresenta il risultato della valutazione del riconoscimento dell'entità per un documento.
TextAnalysisAuthoringDocumentEntityRegionEvaluationResult	Rappresenta il confronto di valutazione tra le entità previste e stimate di un'area del documento.
TextAnalysisAuthoringDocumentMultiLabelClassificationEvaluationResult	Rappresenta il confronto tra le classi previste e previste risultanti dall'operazione di valutazione.
TextAnalysisAuthoringDocumentSingleLabelClassificationEvaluationResult	Rappresenta il confronto tra la classe prevista e quella stimata risultante da un'operazione di valutazione.

Error

Oggetto error.

Nome	Tipo	Descrizione
code	ErrorCode	Uno di un set definito dal server di codici di errore.
details	Error[]	Matrice di dettagli sugli errori specifici che hanno causato l'errore segnalato.
innererror	InnerErrorModel	Oggetto contenente informazioni più specifiche dell'oggetto corrente sull'errore.
message	string	Rappresentazione leggibile dell'errore.
target	string	Destinazione dell'errore.

ErrorCode

Codice di errore leggibile.

Nome	Tipo	Descrizione
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

Risposta di errore.

Nome	Tipo	Descrizione
error	Error	Oggetto error.

InnerErrorCode

Codice di errore leggibile.

Nome	Tipo	Descrizione
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

Oggetto contenente informazioni più specifiche sull'errore. In base alle linee guida dell'API Microsoft One , https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Nome	Tipo	Descrizione
code	InnerErrorCode	Uno di un set definito dal server di codici di errore.
details	object	Dettagli errore.
innererror	InnerErrorModel	Oggetto contenente informazioni più specifiche dell'oggetto corrente sull'errore.
message	string	Messaggio di errore.
target	string	Destinazione errore.

PagedTextAnalysisAuthoringDocumentEvaluationResult

Raccolta di pagine di elementi TextAnalysisAuthoringDocumentEvaluationResult

Nome	Tipo	Descrizione
nextLink	string	Collegamento alla pagina successiva di elementi
value	TextAnalysisAuthoringDocumentEvaluationResult[]: TextAnalysisAuthoringCustomEntityRecognitionDocumentEvaluationResult[] TextAnalysisAuthoringCustomMultiLabelClassificationDocumentEvaluationResult[] TextAnalysisAuthoringCustomSingleLabelClassificationDocumentEvaluationResult[]	Elementi TextAnalysisAuthoringDocumentEvaluationResult in questa pagina

ProjectKind

Nome	Tipo	Descrizione
CustomEntityRecognition	string	Per creare un modello di estrazione per identificare le categorie di dominio usando i propri dati.
CustomMultiLabelClassification	string	Per creare un modello di classificazione per classificare il testo usando i propri dati. Ogni file può avere una o più etichette. Ad esempio, il file 1 viene classificato come A, B e C e il file 2 viene classificato come B e C.
CustomSingleLabelClassification	string	Per creare un modello di classificazione per classificare il testo usando i propri dati. Ogni file avrà una sola etichetta. Ad esempio, il file 1 viene classificato come A e il file 2 viene classificato come B.

StringIndexType

Nome	Tipo	Descrizione
Utf16CodeUnit	string	I valori di offset e lunghezza corrispondono alle unità di codice UTF-16. Usare questa opzione se l'applicazione viene scritta in un linguaggio che supporta Unicode, ad esempio JavaScript.

TextAnalysisAuthoringCustomEntityRecognitionDocumentEvaluationResult

Rappresenta il risultato della valutazione del documento per un progetto di riconoscimento di entità personalizzato.

Nome	Tipo	Descrizione
customEntityRecognitionResult	TextAnalysisAuthoringDocumentEntityRecognitionEvaluationResult	Rappresenta la stima di valutazione per il riconoscimento delle entità.
language	string	Rappresenta la lingua del documento. Si tratta della rappresentazione BCP-47 di una lingua. Ad esempio, usare "en" per l'inglese, "en-gb" per l'inglese (Regno Unito), "es" per lo spagnolo e così via.
location	string	Rappresenta il percorso del documento.
projectKind	string: CustomEntityRecognition	Rappresenta il tipo di progetto.

TextAnalysisAuthoringCustomMultiLabelClassificationDocumentEvaluationResult

Rappresenta il risultato della valutazione del documento per un progetto di classificazione con più etichette personalizzato.

Nome	Tipo	Descrizione
customMultiLabelClassificationResult	TextAnalysisAuthoringDocumentMultiLabelClassificationEvaluationResult	Rappresenta la stima di valutazione per la classificazione a più etichette.
language	string	Rappresenta la lingua del documento. Si tratta della rappresentazione BCP-47 di una lingua. Ad esempio, usare "en" per l'inglese, "en-gb" per l'inglese (Regno Unito), "es" per lo spagnolo e così via.
location	string	Rappresenta il percorso del documento.
projectKind	string: CustomMultiLabelClassification	Rappresenta il tipo di progetto.

TextAnalysisAuthoringCustomSingleLabelClassificationDocumentEvaluationResult

Rappresenta il risultato della valutazione del documento per un progetto di classificazione con etichetta singola personalizzato.

Nome	Tipo	Descrizione
customSingleLabelClassificationResult	TextAnalysisAuthoringDocumentSingleLabelClassificationEvaluationResult	Rappresenta la stima di valutazione per la classificazione a etichetta singola.
language	string	Rappresenta la lingua del documento. Si tratta della rappresentazione BCP-47 di una lingua. Ad esempio, usare "en" per l'inglese, "en-gb" per l'inglese (Regno Unito), "es" per lo spagnolo e così via.
location	string	Rappresenta il percorso del documento.
projectKind	string: CustomSingleLabelClassification	Rappresenta il tipo di progetto.

TextAnalysisAuthoringDocumentEntityLabelEvaluationResult

Rappresenta un'etichetta di entità del risultato della valutazione.

Nome	Tipo	Descrizione
category	string	Rappresenta la categoria di entità.
length	integer	Rappresenta la lunghezza dell'entità.
offset	integer	Rappresenta l'indice di offset dell'entità rispetto al testo originale.

TextAnalysisAuthoringDocumentEntityRecognitionEvaluationResult

Rappresenta il risultato della valutazione del riconoscimento dell'entità per un documento.

Nome	Tipo	Descrizione
entities	TextAnalysisAuthoringDocumentEntityRegionEvaluationResult[]	Rappresenta le entità etichettate dal documento.

TextAnalysisAuthoringDocumentEntityRegionEvaluationResult

Rappresenta il confronto di valutazione tra le entità previste e stimate di un'area del documento.

Nome	Tipo	Descrizione
expectedEntities	TextAnalysisAuthoringDocumentEntityLabelEvaluationResult[]	Rappresenta le etichette di entità previste dell'area.
predictedEntities	TextAnalysisAuthoringDocumentEntityLabelEvaluationResult[]	Rappresenta le etichette di entità stimate dell'area.
regionLength	integer	Rappresenta la lunghezza dell'area.
regionOffset	integer	Rappresenta l'offset dell'area.

TextAnalysisAuthoringDocumentMultiLabelClassificationEvaluationResult

Rappresenta il confronto tra le classi previste e previste risultanti dall'operazione di valutazione.

Nome	Tipo	Descrizione
expectedClasses	string[]	Rappresenta le classi previste del documento.
predictedClasses	string[]	Rappresenta le classi stimate del documento.

TextAnalysisAuthoringDocumentSingleLabelClassificationEvaluationResult

Rappresenta il confronto tra la classe prevista e quella stimata risultante da un'operazione di valutazione.

Nome	Tipo	Descrizione
expectedClass	string	Rappresenta la classe prevista del documento.
predictedClass	string	Rappresenta la classe stimata del documento.

Condividi tramite