Conversational 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-conversations/projects/{projectName}/models/{trainedModelLabel}/evaluation/result?stringIndexType=Utf16CodeUnit&api-version=2022-05-01

Con parametri facoltativi:

GET {Endpoint}/language/authoring/analyze-conversations/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	ConversationalAnalysisAuthoringEvaluationResults	Elenco delle stime di 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-conversations/projects/EmailApp/models/model1/evaluation/result?stringIndexType=Utf16CodeUnit&maxpagesize=10&api-version=2022-05-01

Risposta di esempio

Codice di stato:: 200

{
  "value": [
    {
      "text": "send the email",
      "language": "en-us",
      "entitiesResult": {
        "expectedEntities": [],
        "predictedEntities": []
      },
      "intentsResult": {
        "expectedIntent": "SendEmail",
        "predictedIntent": "SendEmail"
      }
    },
    {
      "text": "send a mail to daniel",
      "language": "en-us",
      "entitiesResult": {
        "expectedEntities": [
          {
            "category": "ContactName",
            "offset": 15,
            "length": 6
          }
        ],
        "predictedEntities": [
          {
            "category": "ContactName",
            "offset": 15,
            "length": 6
          }
        ]
      },
      "intentsResult": {
        "expectedIntent": "SendEmail",
        "predictedIntent": "SendEmail"
      }
    },
    {
      "text": "i forgot to add an important part to that email to james . please set it up to edit",
      "language": "en-us",
      "entitiesResult": {
        "expectedEntities": [
          {
            "category": "ContactName",
            "offset": 51,
            "length": 5
          }
        ],
        "predictedEntities": [
          {
            "category": "Category",
            "offset": 19,
            "length": 9
          },
          {
            "category": "ContactName",
            "offset": 51,
            "length": 5
          }
        ]
      },
      "intentsResult": {
        "expectedIntent": "AddMore",
        "predictedIntent": "AddMore"
      }
    },
    {
      "text": "send email to a and tian",
      "language": "en-us",
      "entitiesResult": {
        "expectedEntities": [
          {
            "category": "ContactName",
            "offset": 14,
            "length": 1
          },
          {
            "category": "ContactName",
            "offset": 20,
            "length": 4
          }
        ],
        "predictedEntities": [
          {
            "category": "ContactName",
            "offset": 14,
            "length": 1
          },
          {
            "category": "ContactName",
            "offset": 20,
            "length": 4
          }
        ]
      },
      "intentsResult": {
        "expectedIntent": "SendEmail",
        "predictedIntent": "SendEmail"
      }
    },
    {
      "text": "send thomas an email",
      "language": "en-us",
      "entitiesResult": {
        "expectedEntities": [
          {
            "category": "ContactName",
            "offset": 5,
            "length": 6
          }
        ],
        "predictedEntities": [
          {
            "category": "ContactName",
            "offset": 5,
            "length": 6
          }
        ]
      },
      "intentsResult": {
        "expectedIntent": "SendEmail",
        "predictedIntent": "SendEmail"
      }
    },
    {
      "text": "i need to add more to the email message i am sending to vincent",
      "language": "en-us",
      "entitiesResult": {
        "expectedEntities": [
          {
            "category": "ContactName",
            "offset": 56,
            "length": 7
          }
        ],
        "predictedEntities": [
          {
            "category": "ContactName",
            "offset": 56,
            "length": 7
          }
        ]
      },
      "intentsResult": {
        "expectedIntent": "AddMore",
        "predictedIntent": "AddMore"
      }
    },
    {
      "text": "send an email to lily roth and abc123@microsoft.com",
      "language": "en-us",
      "entitiesResult": {
        "expectedEntities": [
          {
            "category": "ContactName",
            "offset": 17,
            "length": 9
          }
        ],
        "predictedEntities": [
          {
            "category": "ContactName",
            "offset": 17,
            "length": 9
          }
        ]
      },
      "intentsResult": {
        "expectedIntent": "SendEmail",
        "predictedIntent": "SendEmail"
      }
    },
    {
      "text": "i need to add something else to my email to cheryl",
      "language": "en-us",
      "entitiesResult": {
        "expectedEntities": [
          {
            "category": "ContactName",
            "offset": 44,
            "length": 6
          }
        ],
        "predictedEntities": [
          {
            "category": "ContactName",
            "offset": 44,
            "length": 6
          }
        ]
      },
      "intentsResult": {
        "expectedIntent": "AddMore",
        "predictedIntent": "AddMore"
      }
    },
    {
      "text": "send an email to larry , joseph and billy larkson",
      "language": "en-us",
      "entitiesResult": {
        "expectedEntities": [
          {
            "category": "ContactName",
            "offset": 17,
            "length": 5
          },
          {
            "category": "ContactName",
            "offset": 25,
            "length": 6
          },
          {
            "category": "ContactName",
            "offset": 36,
            "length": 13
          }
        ],
        "predictedEntities": [
          {
            "category": "ContactName",
            "offset": 17,
            "length": 5
          },
          {
            "category": "ContactName",
            "offset": 25,
            "length": 6
          },
          {
            "category": "ContactName",
            "offset": 36,
            "length": 13
          }
        ]
      },
      "intentsResult": {
        "expectedIntent": "SendEmail",
        "predictedIntent": "SendEmail"
      }
    },
    {
      "text": "send mail to dorothy",
      "language": "en-us",
      "entitiesResult": {
        "expectedEntities": [
          {
            "category": "ContactName",
            "offset": 13,
            "length": 7
          }
        ],
        "predictedEntities": [
          {
            "category": "ContactName",
            "offset": 13,
            "length": 7
          }
        ]
      },
      "intentsResult": {
        "expectedIntent": "SendEmail",
        "predictedIntent": "SendEmail"
      }
    }
  ],
  "nextLink": "{Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/models/model1/evaluation/result/?api-version=2022-05-01&top=2147483637&skip=10&maxpagesize=10"
}

Definizioni

Nome	Descrizione
ConversationalAnalysisAuthoringEvaluationResults	Rappresenta un elenco dei risultati di valutazione delle espressioni.
ConversationalAnalysisAuthoringUtteranceEntitiesEvaluationResult	Rappresenta il confronto tra le entità previste e stimate per un'espressione.
ConversationalAnalysisAuthoringUtteranceEntityEvaluationResult	Rappresenta l'output di valutazione di un'etichetta di entità o di una stima.
ConversationalAnalysisAuthoringUtteranceEvaluationResult	Rappresenta il risultato della valutazione per un'espressione.
ConversationalAnalysisAuthoringUtteranceIntentsEvaluationResult	Rappresenta il confronto tra la finalità prevista e quella prevista per un'espressione.
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.
StringIndexType	Specifica il metodo utilizzato per interpretare gli offset di stringa. Per altre informazioni, vedere https://aka.ms/text-analytics-offsets.

ConversationalAnalysisAuthoringEvaluationResults

Object

Rappresenta un elenco dei risultati di valutazione delle espressioni.

Nome	Tipo	Descrizione
nextLink	string	Collegamento alla pagina successiva.
value	ConversationalAnalysisAuthoringUtteranceEvaluationResult[]	Risultati della valutazione delle espressioni.

ConversationalAnalysisAuthoringUtteranceEntitiesEvaluationResult

Object

Rappresenta il confronto tra le entità previste e stimate per un'espressione.

Nome	Tipo	Descrizione
expectedEntities	ConversationalAnalysisAuthoringUtteranceEntityEvaluationResult[]	Rappresenta le etichette di entità previste.
predictedEntities	ConversationalAnalysisAuthoringUtteranceEntityEvaluationResult[]	Rappresenta le etichette di entità stimate.

ConversationalAnalysisAuthoringUtteranceEntityEvaluationResult

Object

Rappresenta l'output di valutazione di un'etichetta di entità o di una stima.

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.

ConversationalAnalysisAuthoringUtteranceEvaluationResult

Object

Rappresenta il risultato della valutazione per un'espressione.

Nome	Tipo	Descrizione
entitiesResult	ConversationalAnalysisAuthoringUtteranceEntitiesEvaluationResult	Rappresenta i risultati delle entità per l'espressione.
intentsResult	ConversationalAnalysisAuthoringUtteranceIntentsEvaluationResult	Rappresenta i risultati delle finalità per l'espressione.
language	string	Rappresenta il linguaggio dell'espressione. 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.
text	string	Rappresenta il testo dell'espressione.

ConversationalAnalysisAuthoringUtteranceIntentsEvaluationResult

Object

Rappresenta il confronto tra la finalità prevista e quella prevista per un'espressione.

Nome	Tipo	Descrizione
expectedIntent	string	Rappresenta la finalità prevista dell'espressione.
predictedIntent	string	Rappresenta la finalità stimata dell'espressione.

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.

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.

Condividi tramite

Conversational 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

ConversationalAnalysisAuthoringEvaluationResults

ConversationalAnalysisAuthoringUtteranceEntitiesEvaluationResult

ConversationalAnalysisAuthoringUtteranceEntityEvaluationResult

ConversationalAnalysisAuthoringUtteranceEvaluationResult

ConversationalAnalysisAuthoringUtteranceIntentsEvaluationResult

Error

ErrorCode

ErrorResponse

InnerErrorCode

InnerErrorModel

StringIndexType

Risorse aggiuntive