Conversation Authoring Project - Create Project

Servicio:

Azure AI Services

Versión de la API:

2025-11-01

Crea un nuevo proyecto o actualiza uno existente.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
Endpoint	path	True	string (uri)	Punto de conexión de Cognitive Services admitido, por ejemplo, https://< resource-name.api.cognitiveservices.azure.com>.
projectName	path	True	string maxLength: 100	Nombre del nuevo proyecto.
api-version	query	True	string minLength: 1	La versión de API que se va a utilizar para esta operación.

Cuerpo de la solicitud

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

Nombre	Requerido	Tipo	Description
language	True	string	Lenguaje del proyecto. Esta es la representación BCP-47 de un idioma. Por ejemplo, use "en" para inglés, "en-gb" para inglés (Reino Unido), "es" para español, etc.
projectKind	True	ProjectKind	Representa el tipo de proyecto.
projectName	True	string	Nombre del nuevo proyecto.
description		string	Descripción del proyecto.
multilingual		boolean	Si el proyecto se usaría para varios lenguajes o no.
settings		AnalyzeConversationAuthoringProjectSettings	Configuración del proyecto.

Respuestas

Nombre	Tipo	Description
200 OK	AnalyzeConversationAuthoringProjectMetadata	La solicitud se ha realizado correctamente.
201 Created	AnalyzeConversationAuthoringProjectMetadata	La solicitud se ha realizado correctamente y se ha creado un nuevo recurso como resultado.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Una respuesta de error inesperada. Encabezados x-ms-error-code: string

Seguridad

Ocp-Apim-Subscription-Key

Tipo: apiKey
En: header

OAuth2Auth

Tipo: oauth2
Flujo: accessCode
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize
Dirección URL del token: https://login.microsoftonline.com/common/oauth2/token

Ámbitos

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

Ejemplos

Successful Create Project

Solicitud de ejemplo

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
}

Respuesta de muestra

status code:

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"
}

status code:

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"
}

Definiciones

Nombre	Description
AnalyzeConversationAuthoringCreateProjectOptions	Representa las opciones usadas para crear o actualizar un proyecto.
AnalyzeConversationAuthoringProjectMetadata	Representa los metadatos de un proyecto.
AnalyzeConversationAuthoringProjectSettings	Representa la configuración utilizada para definir el comportamiento del proyecto.
Azure.Core.Foundations.Error	Objeto de error.
Azure.Core.Foundations.ErrorResponse	Respuesta que contiene los detalles del error.
Azure.Core.Foundations.InnerError	Objeto que contiene información más específica sobre el error. Según las directrices de la API de REST de Azure: https://aka.ms/AzureRestApiGuidelines#handling-errors.
ProjectKind

AnalyzeConversationAuthoringCreateProjectOptions

Object

Representa las opciones usadas para crear o actualizar un proyecto.

Nombre	Tipo	Description
description	string	Descripción del proyecto.
language	string	Lenguaje del proyecto. Esta es la representación BCP-47 de un idioma. Por ejemplo, use "en" para inglés, "en-gb" para inglés (Reino Unido), "es" para español, etc.
multilingual	boolean	Si el proyecto se usaría para varios lenguajes o no.
projectKind	ProjectKind	Representa el tipo de proyecto.
projectName	string	Nombre del nuevo proyecto.
settings	AnalyzeConversationAuthoringProjectSettings	Configuración del proyecto.

AnalyzeConversationAuthoringProjectMetadata

Object

Representa los metadatos de un proyecto.

Nombre	Tipo	Description
createdDateTime	string (date-time)	Representa la fecha y hora de creación del proyecto.
description	string	Descripción del proyecto.
language	string	Lenguaje del proyecto. Esta es la representación BCP-47 de un idioma. Por ejemplo, use "en" para inglés, "en-gb" para inglés (Reino Unido), "es" para español, etc.
lastDeployedDateTime	string (date-time)	Representa la fecha y hora implementada por última vez en el proyecto.
lastModifiedDateTime	string (date-time)	Representa la fecha y hora de creación del proyecto.
lastTrainedDateTime	string (date-time)	Representa la fecha y hora del último entrenamiento del proyecto.
multilingual	boolean	Si el proyecto se usaría para varios lenguajes o no.
projectKind	ProjectKind	Representa el tipo de proyecto.
projectName	string maxLength: 100	Nombre del nuevo proyecto.
settings	AnalyzeConversationAuthoringProjectSettings	Configuración del proyecto.

AnalyzeConversationAuthoringProjectSettings

Object

Representa la configuración utilizada para definir el comportamiento del proyecto.

Nombre	Tipo	Description
confidenceThreshold	number (float)	El umbral de la intención con la mayor confianza, en el que la predicción se cambiará automáticamente a "Ninguna". El valor del umbral debe estar comprendido entre 0 y 1 inclusive.

Azure.Core.Foundations.Error

Object

Objeto de error.

Nombre	Tipo	Description
code	string	Uno de un conjunto definido por el servidor de códigos de error.
details	Azure.Core.Foundations.Error[]	Matriz de detalles sobre errores específicos que llevaron a este error notificado.
innererror	Azure.Core.Foundations.InnerError	Objeto que contiene información más específica que el objeto actual sobre el error.
message	string	Representación legible del error.
target	string	Destino del error.

Azure.Core.Foundations.ErrorResponse

Object

Respuesta que contiene los detalles del error.

Nombre	Tipo	Description
error	Azure.Core.Foundations.Error	Objeto de error.

Azure.Core.Foundations.InnerError

Object

Objeto que contiene información más específica sobre el error. Según las directrices de la API de REST de Azure: https://aka.ms/AzureRestApiGuidelines#handling-errors.

Nombre	Tipo	Description
code	string	Uno de un conjunto definido por el servidor de códigos de error.
innererror	Azure.Core.Foundations.InnerError	Error interno.

ProjectKind

Enumeración

Valor	Description
Conversation	Un proyecto para crear lenguaje natural en aplicaciones, bots y dispositivos IoT.
Orchestration	Un proyecto para conectar y orquestar proyectos de conversación, respuesta a preguntas personalizadas y LUIS en un solo proyecto.