Conversational Analysis Authoring - Get Model Evaluation Results

Referenz

Dienst:: Azure AI Services

API-Version:: 2022-05-01

Ruft die detaillierten Ergebnisse der Auswertung für ein trainiertes Modell ab. Dazu gehören die rohen Rückschlussergebnisse für die Daten, die im Auswertungsprozess enthalten sind.

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

Mit optionalen Parametern:

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
Endpoint	path	True	string	Unterstützter Cognitive Services-Endpunkt (z. B. https://.api.cognitiveservices.azure.com).
projectName	path	True	string	Der Name des zu verwendenden Projekts.
trainedModelLabel	path	True	string	Die trainierte Modellbezeichnung.
api-version	query	True	string	Client-API-Version.
stringIndexType	query	True	StringIndexType	Gibt die Methode an, die zum Interpretieren von Zeichenfolgenoffsets verwendet wird. Weitere Informationen finden Sie unter https://aka.ms/text-analytics-offsets.
maxpagesize	query		integer int32	Die maximale Anzahl von Ressourcen, die in eine einzelne Antwort eingeschlossen werden sollen.
skip	query		integer int32	Ein Offset in die Auflistung der ersten zurückzugebenden Ressource.
top	query		integer int32	Die maximale Anzahl von Ressourcen, die aus der Auflistung zurückgegeben werden sollen.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
Ocp-Apim-Subscription-Key	True	string	Ein Abonnementschlüssel für eine Sprachdienstressource.

Antworten

Name	Typ	Beschreibung
200 OK	ConversationalAnalysisAuthoringEvaluationResults	Liste der Auswertungsvorhersagen.
Other Status Codes	ErrorResponse	Fehlerantwort.

Sicherheit

Ocp-Apim-Subscription-Key

Ein Abonnementschlüssel für eine Sprachdienstressource.

Typ: apiKey
In: header

Beispiele

Successful Get Model Evaluation

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

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

Definitionen

Name	Beschreibung
ConversationalAnalysisAuthoringEvaluationResults	Stellt eine Liste der Auswertungsergebnisse von Äußerungen dar.
ConversationalAnalysisAuthoringUtteranceEntitiesEvaluationResult	Stellt den Vergleich zwischen den erwarteten und vorhergesagten Entitäten für eine Äußerung dar.
ConversationalAnalysisAuthoringUtteranceEntityEvaluationResult	Stellt die Auswertungsausgabe einer Entitätsbezeichnung oder Vorhersage dar.
ConversationalAnalysisAuthoringUtteranceEvaluationResult	Stellt das Auswertungsergebnis für eine Äußerung dar.
ConversationalAnalysisAuthoringUtteranceIntentsEvaluationResult	Stellt den Vergleich zwischen der erwarteten und der vorhergesagten Absicht für eine Äußerung dar.
Error	Das Fehlerobjekt.
ErrorCode	Lesbarer Fehlercode.
ErrorResponse	Fehlerantwort.
InnerErrorCode	Lesbarer Fehlercode.
InnerErrorModel	Ein Objekt, das spezifischere Informationen zum Fehler enthält. Gemäß den Richtlinien der Microsoft One-API: https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
StringIndexType	Gibt die Methode an, die zum Interpretieren von Zeichenfolgenoffsets verwendet wird. Weitere Informationen finden Sie unter https://aka.ms/text-analytics-offsets.

ConversationalAnalysisAuthoringEvaluationResults

Stellt eine Liste der Auswertungsergebnisse von Äußerungen dar.

Name	Typ	Beschreibung
nextLink	string	Der Link für die nächste Seite.
value	ConversationalAnalysisAuthoringUtteranceEvaluationResult[]	Die Auswertungsergebnisse der Äußerungen.

ConversationalAnalysisAuthoringUtteranceEntitiesEvaluationResult

Stellt den Vergleich zwischen den erwarteten und vorhergesagten Entitäten für eine Äußerung dar.

Name	Typ	Beschreibung
expectedEntities	ConversationalAnalysisAuthoringUtteranceEntityEvaluationResult[]	Stellt die erwarteten Entitätsbezeichnungen dar.
predictedEntities	ConversationalAnalysisAuthoringUtteranceEntityEvaluationResult[]	Stellt die vorhergesagten Entitätsbezeichnungen dar.

ConversationalAnalysisAuthoringUtteranceEntityEvaluationResult

Stellt die Auswertungsausgabe einer Entitätsbezeichnung oder Vorhersage dar.

Name	Typ	Beschreibung
category	string	Stellt die Entitätskategorie dar.
length	integer	Stellt die Entitätslänge dar.
offset	integer	Stellt den Entitätsoffsetindex relativ zum ursprünglichen Text dar.

ConversationalAnalysisAuthoringUtteranceEvaluationResult

Stellt das Auswertungsergebnis für eine Äußerung dar.

Name	Typ	Beschreibung
entitiesResult	ConversationalAnalysisAuthoringUtteranceEntitiesEvaluationResult	Stellt die Entitätsergebnisse für die Äußerung dar.
intentsResult	ConversationalAnalysisAuthoringUtteranceIntentsEvaluationResult	Stellt die Absichtsergebnisse für die Äußerung dar.
language	string	Stellt die Äußerungssprache dar. Dies ist die BCP-47-Darstellung einer Sprache. Verwenden Sie beispielsweise "en" für Englisch, "en-gb" für Englisch (UK), "es" für Spanisch usw.
text	string	Stellt den Äußerungstext dar.

ConversationalAnalysisAuthoringUtteranceIntentsEvaluationResult

Stellt den Vergleich zwischen der erwarteten und der vorhergesagten Absicht für eine Äußerung dar.

Name	Typ	Beschreibung
expectedIntent	string	Stellt die erwartete Absicht der Äußerung dar.
predictedIntent	string	Stellt die vorhergesagte Absicht der Äußerung dar.

Error

Das Fehlerobjekt.

Name	Typ	Beschreibung
code	ErrorCode	Einer von einem serverdefiniertem Satz von Fehlercodes.
details	Error[]	Ein Array von Details zu bestimmten Fehlern, die zu diesem gemeldeten Fehler geführt haben.
innererror	InnerErrorModel	Ein -Objekt, das spezifischere Informationen enthält als das aktuelle Objekt über den Fehler.
message	string	Eine lesbare Darstellung des Fehlers.
target	string	Das Ziel des Fehlers.

ErrorCode

Lesbarer Fehlercode.

Name	Typ	Beschreibung
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

Fehlerantwort.

Name	Typ	Beschreibung
error	Error	Das Fehlerobjekt.

InnerErrorCode