Conversation Authoring Project - Create Project

Service:

Azure AI Services

Version d'API:

2025-11-01

Crée un nouveau projet ou met à jour un projet existant.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
Endpoint	path	True	string (uri)	Point de terminaison Cognitive Services pris en charge, par exemple, https://< nom-ressource.api.cognitiveservices.azure.com>.
projectName	path	True	string maxLength: 100	Nouveau nom du projet.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Corps de la demande

Media Types: "application/merge-patch+json"

Nom	Obligatoire	Type	Description
language	True	string	Langue du projet. Il s’agit de la représentation BCP-47 d’une langue. Par exemple, utilisez « en » pour l’anglais, «en-gb» pour l’anglais (Royaume-Uni), « es » pour l’espagnol, etc.
projectKind	True	ProjectKind	Représente le type de projet.
projectName	True	string	Nouveau nom du projet.
description		string	Description du projet.
multilingual		boolean	Indique si le projet serait utilisé pour plusieurs langues ou non.
settings		AnalyzeConversationAuthoringProjectSettings	Paramètres du projet.

Réponses

Nom	Type	Description
200 OK	AnalyzeConversationAuthoringProjectMetadata	La demande a réussi.
201 Created	AnalyzeConversationAuthoringProjectMetadata	La requête a réussi et une nouvelle ressource a été créée en conséquence.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Réponse d’erreur inattendue. En-têtes x-ms-error-code: string

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 Create Project

Exemple de requête

HTTP

PATCH {Endpoint}/language/authoring/analyze-conversations/projects/myproject?api-version=2025-11-01

{
  "projectName": "myproject",
  "language": "en",
  "projectKind": "Conversation",
  "description": "This is a sample conversation project.",
  "multilingual": false
}

Exemple de réponse

Code d’état:

201

{
  "createdDateTime": "2022-04-18T13:53:03Z",
  "lastModifiedDateTime": "2022-04-18T13:53:03Z",
  "projectKind": "Conversation",
  "projectName": "myproject",
  "multilingual": false,
  "description": "This is a sample conversation project.",
  "language": "en"
}

Code d’état:

200

{
  "createdDateTime": "2022-04-18T13:53:03Z",
  "lastModifiedDateTime": "2022-04-18T13:53:03Z",
  "lastTrainedDateTime": "2022-04-18T14:14:28Z",
  "lastDeployedDateTime": "2022-04-18T14:49:01Z",
  "projectKind": "Conversation",
  "projectName": "myproject",
  "multilingual": false,
  "description": "This is a sample conversation project.",
  "language": "en"
}

Définitions

Nom	Description
AnalyzeConversationAuthoringCreateProjectOptions	Représente les options utilisées pour créer ou mettre à jour un projet.
AnalyzeConversationAuthoringProjectMetadata	Représente les métadonnées d’un projet.
AnalyzeConversationAuthoringProjectSettings	Représente les paramètres utilisés pour définir le comportement du projet.
Azure.Core.Foundations.Error	Objet d’erreur.
Azure.Core.Foundations.ErrorResponse	Réponse contenant les détails de l’erreur.
Azure.Core.Foundations.InnerError	Objet contenant des informations plus spécifiques sur l’erreur. Conformément aux directives de l’API REST Azure : https://aka.ms/AzureRestApiGuidelines#handling-errors.
ProjectKind

AnalyzeConversationAuthoringCreateProjectOptions

Object

Représente les options utilisées pour créer ou mettre à jour un projet.

Nom	Type	Description
description	string	Description du projet.
language	string	Langue du projet. Il s’agit de la représentation BCP-47 d’une langue. Par exemple, utilisez « en » pour l’anglais, «en-gb» pour l’anglais (Royaume-Uni), « es » pour l’espagnol, etc.
multilingual	boolean	Indique si le projet serait utilisé pour plusieurs langues ou non.
projectKind	ProjectKind	Représente le type de projet.
projectName	string	Nouveau nom du projet.
settings	AnalyzeConversationAuthoringProjectSettings	Paramètres du projet.

AnalyzeConversationAuthoringProjectMetadata

Object

Représente les métadonnées d’un projet.

Nom	Type	Description
createdDateTime	string (date-time)	Représente la date de création du projet.
description	string	Description du projet.
language	string	Langue du projet. Il s’agit de la représentation BCP-47 d’une langue. Par exemple, utilisez « en » pour l’anglais, «en-gb» pour l’anglais (Royaume-Uni), « es » pour l’espagnol, etc.
lastDeployedDateTime	string (date-time)	Représente la date et l’heure du dernier déploiement du projet.
lastModifiedDateTime	string (date-time)	Représente la date de création du projet.
lastTrainedDateTime	string (date-time)	Représente la dernière date/heure du dernier projet entraîné.
multilingual	boolean	Indique si le projet serait utilisé pour plusieurs langues ou non.
projectKind	ProjectKind	Représente le type de projet.
projectName	string maxLength: 100	Nouveau nom du projet.
settings	AnalyzeConversationAuthoringProjectSettings	Paramètres du projet.

AnalyzeConversationAuthoringProjectSettings

Object

Représente les paramètres utilisés pour définir le comportement du projet.

Nom	Type	Description
confidenceThreshold	number (float)	Seuil de l’intention avec le niveau de confiance le plus élevé, à partir duquel la prédiction sera automatiquement remplacée par « Aucun ». La valeur du seuil doit être comprise entre 0 et 1 inclus.

Azure.Core.Foundations.Error

Object

Objet d’erreur.

Nom	Type	Description
code	string	Un ensemble de codes d’erreur définis par le serveur.
details	Azure.Core.Foundations.Error[]	Tableau de détails sur des erreurs spécifiques qui ont conduit à cette erreur signalée.
innererror	Azure.Core.Foundations.InnerError	Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur.
message	string	Représentation lisible par l’homme de l’erreur.
target	string	Cible de l’erreur.

Azure.Core.Foundations.ErrorResponse

Object

Réponse contenant les détails de l’erreur.

Nom	Type	Description
error	Azure.Core.Foundations.Error	Objet d’erreur.

Azure.Core.Foundations.InnerError

Object

Objet contenant des informations plus spécifiques sur l’erreur. Conformément aux directives de l’API REST Azure : https://aka.ms/AzureRestApiGuidelines#handling-errors.

Nom	Type	Description
code	string	Un ensemble de codes d’erreur définis par le serveur.
innererror	Azure.Core.Foundations.InnerError	Erreur interne.

ProjectKind

Énumération

Valeur	Description
Conversation	Un projet visant à intégrer le langage naturel dans les applications, les bots et les appareils IoT.
Orchestration	Un projet pour connecter et orchestrer les projets Conversation, Questions personnalisées et LUIS en un seul projet.