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. Ciò include i risultati dell'inferenza non elaborata 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 servizi cognitivi supportati (ad esempio, https://.api.cognitiveservices.azure.com).
projectName	path	True	string	Nome del progetto da usare.
trainedModelLabel	path	True	string	Etichetta del modello con training.
api-version	query	True	string	Versione API client.
stringIndexType	query	True	StringIndexType	Specifica il metodo usato per interpretare gli offset di stringa. Per ulteriori 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 lingua.

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 lingua.

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 della 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 o di una stima dell'entità.
ConversationalAnalysisAuthoringUtteranceEvaluationResult	Rappresenta il risultato della valutazione per un'espressione.
ConversationalAnalysisAuthoringUtteranceIntentsEvaluationResult	Rappresenta il confronto tra l'oggetto previsto e la finalità stimata per un'espressione.
Error	Oggetto error.
ErrorCode	Codice di errore leggibile dall'utente.
ErrorResponse	Risposta di errore.
InnerErrorCode	Codice di errore leggibile dall'utente.
InnerErrorModel	Oggetto contenente informazioni più specifiche sull'errore. In base alle linee guida per l'API Microsoft One - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
StringIndexType	Specifica il metodo usato per interpretare gli offset di stringa. Per ulteriori informazioni, vedere https://aka.ms/text-analytics-offsets.

ConversationalAnalysisAuthoringEvaluationResults

Rappresenta un elenco dei risultati della valutazione delle espressioni.

Nome	Tipo	Descrizione
nextLink	string	Collegamento alla pagina successiva.
value	ConversationalAnalysisAuthoringUtteranceEvaluationResult[]	L'espressione restituisce i risultati della valutazione.

ConversationalAnalysisAuthoringUtteranceEntitiesEvaluationResult

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

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

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.

ConversationalAnalysisAuthoringUtteranceEvaluationResult

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 di espressione. Si tratta della rappresentazione BCP-47 di una lingua. Ad esempio, usare "en" per inglese, "en-gb" per inglese (UK), "es" per spagnolo e così via.
text	string	Rappresenta il testo dell'espressione.

ConversationalAnalysisAuthoringUtteranceIntentsEvaluationResult

Rappresenta il confronto tra l'oggetto previsto e la finalità stimata per un'espressione.

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

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 dall'utente.

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