次の方法で共有

Conversational Analysis Authoring - Get Model Evaluation Results

  • リファレンス
サービス:
Azure AI Services
API バージョン:
2022-05-01

トレーニング済みモデルの評価の詳細な結果を取得します。 これには、評価プロセスに含まれるデータの生の推論結果が含まれます。

GET {Endpoint}/language/authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}/evaluation/result?stringIndexType=Utf16CodeUnit&api-version=2022-05-01
省略可能なパラメーターを含む: 
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 パラメーター

名前 / 必須 型 説明
Endpoint
 path True

string

サポートされている Cognitive Services エンドポイント (例: https://.api.cognitiveservices.azure.com).
projectName
 path True

string

使用するプロジェクトの名前。
trainedModelLabel
 path True

string

トレーニング済みのモデル ラベル。
api-version
 query True

string

クライアント API バージョン。
stringIndexType
 query True

StringIndexType

文字列オフセットを解釈するために使用するメソッドを指定します。 詳細については、https://aka.ms/text-analytics-offsets のトピックを参照してください。
maxpagesize
 query

integer

int32

1 つの応答に含めるリソースの最大数。
skip
 query

integer

int32

返される最初のリソースのコレクションへのオフセット。
top
 query

integer

int32

コレクションから返されるリソースの最大数。

要求ヘッダー

名前 必須 型 説明
Ocp-Apim-Subscription-Key True

string

言語サービス リソースのサブスクリプション キー。

応答

名前 型 説明
200 OK

ConversationalAnalysisAuthoringEvaluationResults

評価予測の一覧。
Other Status Codes

ErrorResponse

エラー応答。

セキュリティ

Ocp-Apim-Subscription-Key

言語サービス リソースのサブスクリプション キー。

型: apiKey
/: header

例

Successful Get Model Evaluation

要求のサンプル

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

応答のサンプル

状態コード:
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"
}

定義

名前 説明
ConversationalAnalysisAuthoringEvaluationResults

発話の評価結果の一覧を表します。
ConversationalAnalysisAuthoringUtteranceEntitiesEvaluationResult

発話に対して予想されるエンティティと予測されるエンティティの比較を表します。
ConversationalAnalysisAuthoringUtteranceEntityEvaluationResult

エンティティ ラベルまたは予測の評価出力を表します。
ConversationalAnalysisAuthoringUtteranceEvaluationResult

発話の評価結果を表します。
ConversationalAnalysisAuthoringUtteranceIntentsEvaluationResult

発話に対して予想される意図と予測される意図の比較を表します。
Error

error オブジェクト。
ErrorCode

人間が判読できるエラー コード。
ErrorResponse

エラー応答。
InnerErrorCode

人間が判読できるエラー コード。
InnerErrorModel

エラーに関するより具体的な情報を含むオブジェクト。 Microsoft One API のガイドラインに従って - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses。
StringIndexType

文字列オフセットを解釈するために使用するメソッドを指定します。 詳細については、https://aka.ms/text-analytics-offsets のトピックを参照してください。

ConversationalAnalysisAuthoringEvaluationResults

発話の評価結果の一覧を表します。

名前 型 説明
nextLink

string

次のページ リンク。
value

ConversationalAnalysisAuthoringUtteranceEvaluationResult[]

発話の評価結果。

ConversationalAnalysisAuthoringUtteranceEntitiesEvaluationResult

発話に対して予想されるエンティティと予測されるエンティティの比較を表します。

名前 型 説明
expectedEntities

ConversationalAnalysisAuthoringUtteranceEntityEvaluationResult[]

予想されるエンティティ ラベルを表します。
predictedEntities

ConversationalAnalysisAuthoringUtteranceEntityEvaluationResult[]

予測されるエンティティ ラベルを表します。

ConversationalAnalysisAuthoringUtteranceEntityEvaluationResult

エンティティ ラベルまたは予測の評価出力を表します。

名前 型 説明
category

string

エンティティ カテゴリを表します。
length

integer

エンティティの長さを表します。
offset

integer

元のテキストに対するエンティティ オフセット インデックスを表します。

ConversationalAnalysisAuthoringUtteranceEvaluationResult

発話の評価結果を表します。

名前 型 説明
entitiesResult

ConversationalAnalysisAuthoringUtteranceEntitiesEvaluationResult

発話のエンティティの結果を表します。
intentsResult

ConversationalAnalysisAuthoringUtteranceIntentsEvaluationResult

発話の意図の結果を表します。
language

string

発話言語を表します。 これは、言語の BCP-47 表現です。 たとえば、英語の場合は "en"、英語 (英国) の場合は "en-gb"、スペイン語の場合は "es" を使用します。
text

string

発話テキストを表します。

ConversationalAnalysisAuthoringUtteranceIntentsEvaluationResult

発話に対して予想される意図と予測される意図の比較を表します。

名前 型 説明
expectedIntent

string

発話の予期される意図を表します。
predictedIntent

string

発話の予測された意図を表します。

Error

error オブジェクト。

名前 型 説明
code

ErrorCode

サーバー定義のエラー コードのセットの 1 つ。
details

Error[]

この報告されたエラーの原因となった特定のエラーに関する詳細の配列。
innererror

InnerErrorModel

エラーに関する現在のオブジェクトよりも具体的な情報を含む オブジェクト。
message

string

エラーの人間が判読できる表現。
target

string

エラーのターゲット。

ErrorCode

人間が判読できるエラー コード。

名前 型 説明
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

エラー応答。

名前 型 説明
error

Error

error オブジェクト。

InnerErrorCode

人間が判読できるエラー コード。

名前 型 説明
AzureCognitiveSearchNotFound

string

AzureCognitiveSearchThrottling

string

EmptyRequest

string

ExtractionFailure

string

InvalidCountryHint

string

InvalidDocument

string

InvalidDocumentBatch

string

InvalidParameterValue

string

InvalidRequest

string

InvalidRequestBodyFormat

string

KnowledgeBaseNotFound

string

MissingInputDocuments

string

ModelVersionIncorrect

string

UnsupportedLanguageCode

string

InnerErrorModel

エラーに関するより具体的な情報を含むオブジェクト。 Microsoft One API のガイドラインに従って - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses。

名前 型 説明
code

InnerErrorCode

サーバー定義のエラー コードのセットの 1 つ。
details

object

エラーの詳細。
innererror

InnerErrorModel

エラーに関する現在のオブジェクトよりも具体的な情報を含む オブジェクト。
message

string

エラー メッセージ。
target

string

エラー ターゲット。

StringIndexType

文字列オフセットを解釈するために使用するメソッドを指定します。 詳細については、https://aka.ms/text-analytics-offsets のトピックを参照してください。

名前 型 説明
Utf16CodeUnit

string

オフセットと長さの値は UTF-16 コード単位に対応します。 アプリケーションが Unicode (Java、JavaScript など) をサポートする言語で記述されている場合は、このオプションを使用します。