Conversational Analysis Authoring - Get Model Evaluation Results

Reference

Služba:: Azure AI Services

Verze rozhraní API:: 2022-05-01

Získá podrobné výsledky vyhodnocení pro natrénovaný model. To zahrnuje nezpracované výsledky odvozování dat zahrnutých do procesu vyhodnocení.

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

S volitelnými parametry:

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
Endpoint	path	True	string	Podporovaný koncový bod služeb Cognitive Services (např. https://.api.cognitiveservices.azure.com).
projectName	path	True	string maxLength: 100	Název projektu, který se má použít.
trainedModelLabel	path	True	string	Popisek natrénovaného modelu.
api-version	query	True	string	Verze rozhraní API klienta.
stringIndexType	query	True	StringIndexType	Určuje metodu použitou k interpretaci posunů řetězců. Další informace najdete v tématu https://aka.ms/text-analytics-offsets.
maxpagesize	query		integer (int32)	Maximální počet prostředků, které se mají zahrnout do jedné odpovědi.
skip	query		integer (int32)	Posun do kolekce prvního prostředku, který se má vrátit.
top	query		integer (int32)	Maximální počet prostředků, které se mají vrátit z kolekce.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
Ocp-Apim-Subscription-Key	True	string	Klíč předplatného pro prostředek služby jazyka.

Odpovědi

Name	Typ	Description
200 OK	ConversationalAnalysisAuthoringEvaluationResults	Seznam předpovědí vyhodnocení
Other Status Codes	ErrorResponse	Chybová odpověď.

Zabezpečení

Ocp-Apim-Subscription-Key

Klíč předplatného pro prostředek služby jazyka.

Typ: apiKey
V: header

Příklady

Successful Get Model Evaluation

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:: 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"
}

Definice

Name	Description
ConversationalAnalysisAuthoringEvaluationResults	Představuje seznam výsledků vyhodnocení promluv.
ConversationalAnalysisAuthoringUtteranceEntitiesEvaluationResult	Představuje porovnání mezi očekávanými a predikovanými entitami promluvy.
ConversationalAnalysisAuthoringUtteranceEntityEvaluationResult	Představuje výstup vyhodnocení popisku entity nebo předpovědi.
ConversationalAnalysisAuthoringUtteranceEvaluationResult	Představuje výsledek vyhodnocení promluvy.
ConversationalAnalysisAuthoringUtteranceIntentsEvaluationResult	Představuje porovnání mezi očekávaným a předpokládaným záměrem promluvy.
Error	Objekt chyby.
ErrorCode	Kód chyby čitelné člověkem
ErrorResponse	Chybová odpověď.
InnerErrorCode	Kód chyby čitelné člověkem
InnerErrorModel	Objekt obsahující konkrétnější informace o chybě. Podle pokynů k rozhraní API Microsoft One – https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
StringIndexType	Určuje metodu použitou k interpretaci posunů řetězců. Další informace najdete v tématu https://aka.ms/text-analytics-offsets.

ConversationalAnalysisAuthoringEvaluationResults

Objekt

Představuje seznam výsledků vyhodnocení promluv.

Name	Typ	Description
nextLink	string	Odkaz na další stránku.
value	ConversationalAnalysisAuthoringUtteranceEvaluationResult[]	Výsledky vyhodnocení promluv.

ConversationalAnalysisAuthoringUtteranceEntitiesEvaluationResult

Objekt

Představuje porovnání mezi očekávanými a predikovanými entitami promluvy.

Name	Typ	Description
expectedEntities	ConversationalAnalysisAuthoringUtteranceEntityEvaluationResult[]	Představuje očekávané popisky entit.
predictedEntities	ConversationalAnalysisAuthoringUtteranceEntityEvaluationResult[]	Představuje predikované popisky entit.

ConversationalAnalysisAuthoringUtteranceEntityEvaluationResult

Objekt

Představuje výstup vyhodnocení popisku entity nebo předpovědi.

Name	Typ	Description
category	string	Představuje kategorii entity.
length	integer (int32)	Představuje délku entity.
offset	integer (int32)	Představuje index posunu entity vzhledem k původnímu textu.

ConversationalAnalysisAuthoringUtteranceEvaluationResult

Objekt

Představuje výsledek vyhodnocení promluvy.

Name	Typ	Description
entitiesResult	ConversationalAnalysisAuthoringUtteranceEntitiesEvaluationResult	Představuje výsledky entit promluvy.
intentsResult	ConversationalAnalysisAuthoringUtteranceIntentsEvaluationResult	Představuje výsledky záměrů promluvy.
language	string	Představuje jazyk promluvy. Toto je reprezentace jazyka BCP-47. Například použijte "en" pro angličtinu, "en-gb" pro angličtinu (UK), "es" pro španělštinu atd.
text	string	Představuje text promluvy.

ConversationalAnalysisAuthoringUtteranceIntentsEvaluationResult

Objekt

Představuje porovnání mezi očekávaným a předpokládaným záměrem promluvy.

Name	Typ	Description
expectedIntent	string	Představuje očekávaný záměr promluvy.
predictedIntent	string	Představuje predikovaný záměr promluvy.

Error

Objekt

Objekt chyby.

Name	Typ	Description
code	ErrorCode	Jedna ze serverově definovaných kódů chyb.
details	Error[]	Pole podrobností o konkrétních chybách, které vedly k této nahlášené chybě.
innererror	InnerErrorModel	Objekt obsahující konkrétnější informace, než je aktuální objekt o chybě.
message	string	Čitelné znázornění chyby člověkem.
target	string	Cíl chyby.

ErrorCode

Výčet

Kód chyby čitelné člověkem

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

ErrorResponse

Objekt

Chybová odpověď.

Name	Typ	Description
error	Error	Objekt chyby.

InnerErrorCode

Výčet

Kód chyby čitelné člověkem

Hodnota	Description
AzureCognitiveSearchNotFound
AzureCognitiveSearchThrottling
EmptyRequest
ExtractionFailure
InvalidCountryHint
InvalidDocument
InvalidDocumentBatch
InvalidParameterValue
InvalidRequest
InvalidRequestBodyFormat
KnowledgeBaseNotFound
MissingInputDocuments
ModelVersionIncorrect
UnsupportedLanguageCode

InnerErrorModel

Objekt

Objekt obsahující konkrétnější informace o chybě. Podle pokynů k rozhraní API Microsoft One – https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Name	Typ	Description
code	InnerErrorCode	Jedna ze serverově definovaných kódů chyb.
details	object	Podrobnosti o chybě
innererror	InnerErrorModel	Objekt obsahující konkrétnější informace, než je aktuální objekt o chybě.
message	string	Zpráva o chybě.
target	string	Cíl chyby

StringIndexType

Výčet

Určuje metodu použitou k interpretaci posunů řetězců. Další informace najdete v tématu https://aka.ms/text-analytics-offsets.

Hodnota	Description
Utf16CodeUnit	Hodnoty posunu a délky budou odpovídat jednotkám kódu UTF-16. Tuto možnost použijte, pokud je vaše aplikace napsaná v jazyce, který podporuje Unicode, například JavaScript.

Sdílet prostřednictvím

Conversational Analysis Authoring - Get Model Evaluation Results

Parametry identifikátoru URI

Hlavička požadavku

Odpovědi

Zabezpečení

Ocp-Apim-Subscription-Key

Příklady

Successful Get Model Evaluation

Ukázkový požadavek

Ukázková odpověď

Definice

ConversationalAnalysisAuthoringEvaluationResults

ConversationalAnalysisAuthoringUtteranceEntitiesEvaluationResult

ConversationalAnalysisAuthoringUtteranceEntityEvaluationResult

ConversationalAnalysisAuthoringUtteranceEvaluationResult

ConversationalAnalysisAuthoringUtteranceIntentsEvaluationResult

Error

ErrorCode

ErrorResponse

InnerErrorCode

InnerErrorModel

StringIndexType

Další materiály