Conversational Analysis Authoring - Get Model Evaluation Results

Referentie

Service:: Azure AI Services

API-versie:: 2022-05-01

Hiermee worden de gedetailleerde resultaten van de evaluatie voor een getraind model opgehaald. Dit omvat de onbewerkte deductieresultaten voor de gegevens die zijn opgenomen in het evaluatieproces.

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

Met optionele parameters:

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-parameters

Name	In	Vereist	Type	Description
Endpoint	path	True	string	Ondersteund Cognitive Services-eindpunt (bijvoorbeeld https://.api.cognitiveservices.azure.com).
projectName	path	True	string	De naam van het project dat moet worden gebruikt.
trainedModelLabel	path	True	string	Het label van het getrainde model.
api-version	query	True	string	Client-API-versie.
stringIndexType	query	True	StringIndexType	Hiermee geeft u de methode op die wordt gebruikt voor het interpreteren van tekenreeks offsets. Zie voor meer informatie https://aka.ms/text-analytics-offsets.
maxpagesize	query		integer int32	Het maximum aantal resources dat in één antwoord moet worden opgenomen.
skip	query		integer int32	Een verschuiving in de verzameling van de eerste resource die moet worden geretourneerd.
top	query		integer int32	Het maximum aantal resources dat uit de verzameling moet worden geretourneerd.

Aanvraagkoptekst

Name	Vereist	Type	Description
Ocp-Apim-Subscription-Key	True	string	Een abonnementssleutel voor een taalserviceresource.

Antwoorden

Name	Type	Description
200 OK	ConversationalAnalysisAuthoringEvaluationResults	Lijst met de evaluatievoorspellingen.
Other Status Codes	ErrorResponse	Foutreactie.

Beveiliging

Ocp-Apim-Subscription-Key

Een abonnementssleutel voor een taalserviceresource.

Type: apiKey
In: header

Voorbeelden

Successful Get Model Evaluation

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

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

Definities

Name	Description
ConversationalAnalysisAuthoringEvaluationResults	Vertegenwoordigt een lijst met evaluatieresultaten van utterances.
ConversationalAnalysisAuthoringUtteranceEntitiesEvaluationResult	Vertegenwoordigt de vergelijking tussen de verwachte en voorspelde entiteiten voor een uiting.
ConversationalAnalysisAuthoringUtteranceEntityEvaluationResult	Vertegenwoordigt de evaluatie-uitvoer van een entiteitslabel of voorspelling.
ConversationalAnalysisAuthoringUtteranceEvaluationResult	Vertegenwoordigt het evaluatieresultaat voor een uiting.
ConversationalAnalysisAuthoringUtteranceIntentsEvaluationResult	Vertegenwoordigt de vergelijking tussen de verwachte en de voorspelde intentie voor een uiting.
Error	Het foutobject.
ErrorCode	Door mensen leesbare foutcode.
ErrorResponse	Foutreactie.
InnerErrorCode	Door mensen leesbare foutcode.
InnerErrorModel	Een object met specifiekere informatie over de fout. Volgens de richtlijnen voor Microsoft One API: https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
StringIndexType	Hiermee geeft u de methode op die wordt gebruikt voor het interpreteren van tekenreeks offsets. Zie voor meer informatie https://aka.ms/text-analytics-offsets.

ConversationalAnalysisAuthoringEvaluationResults

Vertegenwoordigt een lijst met evaluatieresultaten van utterances.

Name	Type	Description
nextLink	string	De koppeling naar de volgende pagina.
value	ConversationalAnalysisAuthoringUtteranceEvaluationResult[]	De evaluatieresultaten van de utterances.

ConversationalAnalysisAuthoringUtteranceEntitiesEvaluationResult

Vertegenwoordigt de vergelijking tussen de verwachte en voorspelde entiteiten voor een uiting.

Name	Type	Description
expectedEntities	ConversationalAnalysisAuthoringUtteranceEntityEvaluationResult[]	Vertegenwoordigt de verwachte entiteitslabels.
predictedEntities	ConversationalAnalysisAuthoringUtteranceEntityEvaluationResult[]	Vertegenwoordigt de voorspelde entiteitslabels.

ConversationalAnalysisAuthoringUtteranceEntityEvaluationResult

Vertegenwoordigt de evaluatie-uitvoer van een entiteitslabel of voorspelling.

Name	Type	Description
category	string	Vertegenwoordigt de entiteitscategorie.
length	integer	Vertegenwoordigt de lengte van de entiteit.
offset	integer	Vertegenwoordigt de verschuivingsindex van de entiteit ten opzichte van de oorspronkelijke tekst.

ConversationalAnalysisAuthoringUtteranceEvaluationResult

Vertegenwoordigt het evaluatieresultaat voor een uiting.

Name	Type	Description
entitiesResult	ConversationalAnalysisAuthoringUtteranceEntitiesEvaluationResult	Vertegenwoordigt de entiteitsresultaten voor de uiting.
intentsResult	ConversationalAnalysisAuthoringUtteranceIntentsEvaluationResult	Vertegenwoordigt de intentieresultaten voor de uiting.
language	string	Vertegenwoordigt de taal van de uiting. Dit is BCP-47-weergave van een taal. Gebruik bijvoorbeeld 'en' voor Engels, 'en-gb' voor Engels (VK), 'es' voor Spaans, enzovoort.
text	string	Vertegenwoordigt de uitingstekst.

ConversationalAnalysisAuthoringUtteranceIntentsEvaluationResult

Vertegenwoordigt de vergelijking tussen de verwachte en de voorspelde intentie voor een uiting.

Name	Type	Description
expectedIntent	string	Vertegenwoordigt de verwachte intentie van de uiting.
predictedIntent	string	Vertegenwoordigt de voorspelde intentie van de uiting.

Error

Het foutobject.

Name	Type	Description
code	ErrorCode	Een van een door de server gedefinieerde set foutcodes.
details	Error[]	Een matrix met details over specifieke fouten die tot deze gerapporteerde fout hebben geleid.
innererror	InnerErrorModel	Een object met specifiekere informatie dan het huidige object over de fout.
message	string	Een door mensen leesbare weergave van de fout.
target	string	Het doel van de fout.

ErrorCode

Door mensen leesbare foutcode.

Name	Type	Description
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

Foutreactie.

Name	Type	Description
error	Error	Het foutobject.

InnerErrorCode