Text Analysis Authoring - Get Model Evaluation Results

Riferimento

Servizio:: Azure AI Services

Versione API:: 2022-05-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?stringIndexType=Utf16CodeUnit&api-version=2022-05-01

Con parametri facoltativi:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
Endpoint	path	True	string	Endpoint di Servizi cognitivi supportato (ad esempio, https://.api.cognitiveservices.azure.com).
projectName	path	True	string maxLength: 100	Nome del progetto da utilizzare.
trainedModelLabel	path	True	string	Etichetta del modello con training.
api-version	query	True	string	Versione dell'API client.
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 risorse da includere in una singola risposta.
skip	query		integer (int32)	Offset nella raccolta della prima risorsa da restituire.
top	query		integer (int32)	Numero massimo di risorse da restituire dalla raccolta.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
Ocp-Apim-Subscription-Key	True	string	Chiave di sottoscrizione per una risorsa del servizio di linguaggio.

Risposte

Nome	Tipo	Descrizione
200 OK	TextAnalysisAuthoringEvaluationResults	Elenco dei risultati della valutazione.
Other Status Codes	ErrorResponse	Risposta di errore.

Sicurezza

Ocp-Apim-Subscription-Key

Chiave di sottoscrizione per una risorsa del servizio di linguaggio.

Tipo: apiKey
In: header

Esempio

Successful Get Model Evaluation

Esempio di richiesta

HTTP

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

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": "{Endpoint}/language/authoring/analyze-text/projects/LoanAgreements/models/model2/evaluation/result/?api-version=2022-05-01&top=2147483645&skip=2&maxpagesize=2"
}

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.
ProjectKind	Tipo di progetto.
StringIndexType	Specifica il metodo utilizzato per interpretare gli offset di stringa. Per altre informazioni, vedere https://aka.ms/text-analytics-offsets.
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.
TextAnalysisAuthoringEvaluationResults	Rappresenta un elenco di risultati per un'operazione di valutazione.

Error

Object

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

Enumerazione

Codice di errore leggibile.

Valore	Descrizione
AzureCognitiveSearchIndexLimitReached
AzureCognitiveSearchIndexNotFound
AzureCognitiveSearchNotFound
AzureCognitiveSearchThrottling
Conflict
Forbidden
InternalServerError
InvalidArgument
InvalidRequest
NotFound
OperationNotFound
ProjectNotFound
QuotaExceeded
ServiceUnavailable
Timeout
TooManyRequests
Unauthorized
Warning

ErrorResponse

Object

Risposta di errore.

Nome	Tipo	Descrizione
error	Error	Oggetto error.

InnerErrorCode

Enumerazione

Codice di errore leggibile.

Valore	Descrizione
AzureCognitiveSearchNotFound
AzureCognitiveSearchThrottling
EmptyRequest
ExtractionFailure
InvalidCountryHint
InvalidDocument
InvalidDocumentBatch
InvalidParameterValue
InvalidRequest
InvalidRequestBodyFormat
KnowledgeBaseNotFound
MissingInputDocuments
ModelVersionIncorrect
UnsupportedLanguageCode

InnerErrorModel

Object

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.

ProjectKind

Enumerazione

Tipo di progetto.

Valore	Descrizione
CustomEntityRecognition	Per creare un modello di estrazione per identificare le categorie di dominio usando i propri dati.
CustomMultiLabelClassification	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	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

Enumerazione

Specifica il metodo utilizzato per interpretare gli offset di stringa. Per altre informazioni, vedere https://aka.ms/text-analytics-offsets.

Valore	Descrizione
Utf16CodeUnit	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

Object

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

Object

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

Object

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

Object

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

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

TextAnalysisAuthoringDocumentEntityRecognitionEvaluationResult

Object

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

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

TextAnalysisAuthoringDocumentEntityRegionEvaluationResult

Object

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 (int32)	Rappresenta la lunghezza dell'area.
regionOffset	integer (int32)	Rappresenta l'offset dell'area.

TextAnalysisAuthoringDocumentMultiLabelClassificationEvaluationResult

Object

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

Object

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.

TextAnalysisAuthoringEvaluationResults

Object

Rappresenta un elenco di risultati per un'operazione di valutazione.

Nome	Tipo	Descrizione
nextLink	string	Collegamento alla pagina successiva.
value	TextAnalysisAuthoringDocumentEvaluationResult[]: TextAnalysisAuthoringCustomEntityRecognitionDocumentEvaluationResult[] TextAnalysisAuthoringCustomMultiLabelClassificationDocumentEvaluationResult[] TextAnalysisAuthoringCustomSingleLabelClassificationDocumentEvaluationResult[]	Elenco dei risultati della valutazione dei documenti.

Condividi tramite

Text Analysis Authoring - Get Model Evaluation Results

Parametri dell'URI

Intestazione della richiesta

Risposte

Sicurezza

Ocp-Apim-Subscription-Key

Esempio

Successful Get Model Evaluation

Esempio di richiesta

Risposta di esempio

Definizioni

Error

ErrorCode

ErrorResponse

InnerErrorCode

InnerErrorModel

ProjectKind

StringIndexType

TextAnalysisAuthoringCustomEntityRecognitionDocumentEvaluationResult

TextAnalysisAuthoringCustomMultiLabelClassificationDocumentEvaluationResult

TextAnalysisAuthoringCustomSingleLabelClassificationDocumentEvaluationResult

TextAnalysisAuthoringDocumentEntityLabelEvaluationResult

TextAnalysisAuthoringDocumentEntityRecognitionEvaluationResult

TextAnalysisAuthoringDocumentEntityRegionEvaluationResult

TextAnalysisAuthoringDocumentMultiLabelClassificationEvaluationResult

TextAnalysisAuthoringDocumentSingleLabelClassificationEvaluationResult

TextAnalysisAuthoringEvaluationResults

Risorse aggiuntive