Conversational Analysis Authoring - Train

Référence

Service:: Azure AI Services

Version d'API:: 2023-04-01

Déclenche un travail de formation pour un projet.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
Endpoint	path	True	string
projectName	path	True	string	Nom du projet à utiliser.
api-version	query	True	string	Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom	Obligatoire	Type	Description
modelLabel	True	string	Représente l’étiquette du modèle de sortie.
trainingMode	True	TrainingMode	Représente le mode de l’opération d’entraînement.
evaluationOptions		ConversationalAnalysisAuthoringEvaluationOptions	Représente les options d’évaluation. Par défaut, le type d’évaluation est pourcentage, avec le pourcentage de fractionnement de l’entraînement sur 80 et le pourcentage de fractionnement de test sur 20.
trainingConfigVersion		string	Représente la version de configuration d’entraînement. Par défaut, la valeur « latest » est utilisée qui utilise la dernière version de configuration d’entraînement publiée.

Réponses

Nom	Type	Description
202 Accepted		La demande a été acceptée pour traitement, mais le traitement n’a pas encore été terminé. En-têtes Operation-Location: string
Other Status Codes	ErrorResponse	Réponse d’erreur inattendue.

Nom

Type

Description

202 Accepted

La demande a été acceptée pour traitement, mais le traitement n’a pas encore été terminé.

En-têtes

Operation-Location: string

Other Status Codes

ErrorResponse

Réponse d’erreur inattendue.

Sécurité

Ocp-Apim-Subscription-Key

Type: apiKey
Dans: header

OAuth2Auth

Type: oauth2
Flux: accessCode
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize
URL du jeton: https://login.microsoftonline.com/common/oauth2/token

Étendues

Nom	Description
https://cognitiveservices.azure.com/.default

Exemples

Successful Train Project

Exemple de requête

HTTP

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

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

Exemple de réponse

Code d’état:: 202

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

Définitions

Nom	Description
ConversationalAnalysisAuthoringEvaluationOptions	Représente les options utilisées pour exécuter l’évaluation.
ConversationalAnalysisAuthoringTrainingJobOptions	Représente les options de démarrage d’un nouveau travail d’entraînement.
Error	Objet d’erreur.
ErrorCode	Code d’erreur lisible par l’homme.
ErrorResponse	Réponse d’erreur.
EvaluationKind
InnerErrorCode	Code d’erreur lisible par l’homme.
InnerErrorModel	Objet contenant des informations plus spécifiques sur l’erreur. Conformément aux instructions de l’API Microsoft One - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
TrainingMode

ConversationalAnalysisAuthoringEvaluationOptions

Représente les options utilisées pour exécuter l’évaluation.

Nom	Type	Description
kind	EvaluationKind	Représente le type d’évaluation. Par défaut, le type d’évaluation est défini sur pourcentage.
testingSplitPercentage	integer	Représente le pourcentage de fractionnement du jeu de données de test. Uniquement nécessaire au cas où le type d’évaluation était pourcentage.
trainingSplitPercentage	integer	Représente le pourcentage de fractionnement du jeu de données d’entraînement. Uniquement nécessaire au cas où le type d’évaluation était pourcentage.