Conversation Authoring Project - Train

Служба:: Azure AI Services

Версия API:: 2025-11-01

Активирует задание обучения для проекта.

POST {Endpoint}/language/authoring/analyze-conversations/projects/{projectName}/:train?api-version=2025-11-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
Endpoint	path	True	string (uri)	Поддерживаемая конечная точка Cognitive Services, например https://< resource-name.api.cognitiveservices.azure.com>.
projectName	path	True	string maxLength: 100	Имя используемого проекта.
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

Текст запроса

Имя	Обязательно	Тип	Описание
modelLabel	True	string	Представляет метку выходной модели.
trainingMode	True	TrainingMode	Представляет режим операции обучения.
evaluationOptions		AnalyzeConversationAuthoringEvaluationOptions	Представляет варианты оценки. По умолчанию тип оценки — процент, при этом процент разделения обучения равен 80, а процент разделения тестирования — 20.
trainingConfigVersion		string	Представляет версию конфигурации обучения. По умолчанию используется значение "latest", которое использует последнюю выпущенную версию конфигурации обучения.

Ответы

Имя	Тип	Описание
202 Accepted		Запрос был принят для обработки, но обработка еще не завершена. Заголовки Operation-Location: string
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Непредвиденное сообщение об ошибке. Заголовки x-ms-error-code: string

Имя

Тип

Описание

202 Accepted

Запрос был принят для обработки, но обработка еще не завершена.

Заголовки

Operation-Location: string

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Непредвиденное сообщение об ошибке.

Заголовки

x-ms-error-code: string

Безопасность

Ocp-Apim-Subscription-Key

Тип: apiKey
В: header

OAuth2Auth

Тип: oauth2
Flow: accessCode
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize
URL-адрес токена: https://login.microsoftonline.com/common/oauth2/token

Области

Имя	Описание
https://cognitiveservices.azure.com/.default

Примеры

Successful Train Project

Образец запроса

HTTP

POST {Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/:train?api-version=2025-11-01

{
  "modelLabel": "model1",
  "trainingMode": "standard",
  "trainingConfigVersion": "latest",
  "evaluationOptions": {
    "kind": "percentage",
    "testingSplitPercentage": 20,
    "trainingSplitPercentage": 80
  }
}

Пример ответа

Код состояния:: 202

operation-location: {Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/train/jobs/4d37982f-fded-4c2c-afe3-15953b5919b6_637858368000000000?api-version=2025-11-01

Определения

Имя	Описание
AnalyzeConversationAuthoringEvaluationOptions	Представляет параметры, используемые при выполнении оценки.
AnalyzeConversationAuthoringTrainingJobOptions	Представляет варианты запуска нового задания обучения.
Azure.Core.Foundations.Error	Объект ошибки.
Azure.Core.Foundations.ErrorResponse	Ответ, содержащий сведения об ошибке.
Azure.Core.Foundations.InnerError	Объект, содержащий более конкретные сведения об ошибке. В соответствии с рекомендациями по Azure REST API — https://aka.ms/AzureRestApiGuidelines#handling-errors.
EvaluationKind
TrainingMode

AnalyzeConversationAuthoringEvaluationOptions

Object

Представляет параметры, используемые при выполнении оценки.

Имя	Тип	Описание
kind	EvaluationKind	Представляет вид оценки. По умолчанию тип оценки установлен в процентах.
testingSplitPercentage	integer (int32)	Представляет процент разбиения тестового набора данных. Нужен только в том случае, если вид оценки - проценты.
trainingSplitPercentage	integer (int32)	Представляет процент разбиения обучающего набора данных. Нужен только в том случае, если вид оценки - проценты.

AnalyzeConversationAuthoringTrainingJobOptions

Object

Представляет варианты запуска нового задания обучения.

Имя	Тип	Описание
evaluationOptions	AnalyzeConversationAuthoringEvaluationOptions	Представляет варианты оценки. По умолчанию тип оценки — процент, при этом процент разделения обучения равен 80, а процент разделения тестирования — 20.
modelLabel	string	Представляет метку выходной модели.
trainingConfigVersion	string	Представляет версию конфигурации обучения. По умолчанию используется значение "latest", которое использует последнюю выпущенную версию конфигурации обучения.
trainingMode	TrainingMode	Представляет режим операции обучения.

Azure.Core.Foundations.Error

Object

Объект ошибки.

Имя	Тип	Описание
code	string	Один из определяемых сервером кодов ошибок.
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

Объект, содержащий более конкретные сведения об ошибке. В соответствии с рекомендациями по Azure REST API — https://aka.ms/AzureRestApiGuidelines#handling-errors.

Имя	Тип	Описание
code	string	Один из определяемых сервером кодов ошибок.
innererror	Azure.Core.Foundations.InnerError	Внутренняя ошибка.

EvaluationKind

Перечисление

Значение	Описание
percentage	Разделите данные на обучающие и тестовые наборы в соответствии с заданными пользователем процентами.
manual	Разделите данные в соответствии с выбранным набором данных для каждого примера в данных.

TrainingMode

Перечисление

Значение	Описание
advanced	Тренируется с использованием тонко настроенных нейросетевых трансформеров. Может обучать многоязычным проектам.
standard	Более быстрое обучение для более быстрых итераций.