Conversation Authoring Trained Model - Get Evaluation Status

サービス:

Azure AI Services

API バージョン:

2025-05-15-preview

評価ジョブの状態を取得します。

GET {Endpoint}/language/authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}/evaluate/jobs/{jobId}?api-version=2025-05-15-preview

URI パラメーター

名前	/	必須	型	説明
Endpoint	path	True	string	サポートされている Cognitive Services エンドポイント (例: https://.api.cognitiveservices.azure.com.)
jobId	path	True	string	ジョブ ID。
projectName	path	True	string maxLength: 100	新しいプロジェクト名。
trainedModelLabel	path	True	string	トレーニング済みのモデル ラベル。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

応答

名前	型	説明
200 OK	AnalyzeConversationAuthoringEvaluationJobState	要求は成功しました。
Other Status Codes	Azure.Core.Foundations.ErrorResponse	予期しないエラー応答。 ヘッダー x-ms-error-code: string

セキュリティ

Ocp-Apim-Subscription-Key

型: apiKey
/: header

OAuth2Auth

型: oauth2
フロー: accessCode
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize
Token URL (トークン URL): https://login.microsoftonline.com/common/oauth2/token

スコープ

名前	説明
https://cognitiveservices.azure.com/.default

例

Successful Get Evaluation Status

要求のサンプル

HTTP

GET {Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/models/model1/evaluate/jobs/8ccf2ffe-e758-4d04-a44a-31512918c7e8_637858368000000000?api-version=2025-05-15-preview

応答のサンプル

状態コード:

200

{
  "result": {
    "evaluationOptions": {
      "kind": "percentage",
      "trainingSplitPercentage": 60,
      "testingSplitPercentage": 40
    },
    "modelLabel": "model1",
    "trainingConfigVersion": "2022-05-01",
    "percentComplete": 30
  },
  "jobId": "8ccf2ffe-e758-4d04-a44a-31512918c7e8_637858368000000000",
  "createdDateTime": "2022-04-18T15:44:44Z",
  "lastUpdatedDateTime": "2022-04-18T15:45:48Z",
  "expirationDateTime": "2022-04-25T15:44:44Z",
  "status": "running"
}

定義

名前	説明
AnalyzeConversationAuthoringEvaluationJobResult
AnalyzeConversationAuthoringEvaluationJobState	評価ジョブの状態を表します。
AnalyzeConversationAuthoringEvaluationOptions	評価の実行に使用されるオプションを表します。
Azure.Core.Foundations.Error	エラー オブジェクト。
Azure.Core.Foundations.ErrorResponse	エラーの詳細を含む応答。
Azure.Core.Foundations.InnerError	エラーに関するより具体的な情報を含むオブジェクト。 Microsoft One API のガイドラインに従って - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
EvaluationKind
JobStatus

AnalyzeConversationAuthoringEvaluationJobResult

Object

名前	型	説明
evaluationOptions	AnalyzeConversationAuthoringEvaluationOptions	評価の実行に使用されるオプションを表します。
modelLabel	string	トレーニング済みのモデル ラベルを表します。
percentComplete	integer (int32)	進行状況の割合を表します。
trainingConfigVersion	string	トレーニング構成バージョンを表します。

AnalyzeConversationAuthoringEvaluationJobState

Object

評価ジョブの状態を表します。

名前	型	説明
createdDateTime	string (date-time)	ジョブの作成日時。
errors	Azure.Core.Foundations.Error[]	ジョブの実行中に発生したエラー。
expirationDateTime	string (date-time)	ジョブの有効期限の日時。
jobId	string	ジョブ ID。
lastUpdatedDateTime	string (date-time)	ジョブが更新された最後の日付。
result	AnalyzeConversationAuthoringEvaluationJobResult	評価タスクの詳細な結果を表します。
status	JobStatus	ジョブの状態。
warnings	Azure.Core.Foundations.Error[]	ジョブの実行中に発生した警告。

AnalyzeConversationAuthoringEvaluationOptions

Object

評価の実行に使用されるオプションを表します。

名前	型	説明
kind	EvaluationKind	評価の種類を表します。 既定では、評価の種類はパーセンテージに設定されます。
testingSplitPercentage	integer (int32)	テスト データセットの分割率を表します。 評価の種類がパーセンテージの場合にのみ必要です。
trainingSplitPercentage	integer (int32)	トレーニング データセットの分割率を表します。 評価の種類がパーセンテージの場合にのみ必要です。

Azure.Core.Foundations.Error

Object

エラー オブジェクト。

名前	型	説明
code	string	サーバー定義の一連のエラー コードの 1 つ。
details	Azure.Core.Foundations.Error[]	この報告されたエラーの原因となった特定のエラーに関する詳細の配列。
innererror	Azure.Core.Foundations.InnerError	エラーに関する現在のオブジェクトよりも具体的な情報を含むオブジェクト。
message	string	エラーの人間が判読できる表現。
target	string	エラーのターゲット。

Azure.Core.Foundations.ErrorResponse

Object

エラーの詳細を含む応答。

名前	型	説明
error	Azure.Core.Foundations.Error	エラー オブジェクト。

Azure.Core.Foundations.InnerError

Object

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

名前	型	説明
code	string	サーバー定義の一連のエラー コードの 1 つ。
innererror	Azure.Core.Foundations.InnerError	内部エラー。

EvaluationKind

列挙

値	説明
manual	データ内のすべての例について、選択したデータセットに従ってデータを分割します。
percentage	ユーザー定義のパーセンテージに従って、データをトレーニング セットとテスト セットに分割します。

JobStatus

列挙

値	説明
cancelled
cancelling
failed
notStarted
partiallyCompleted
running
succeeded