Conversation Authoring Project - Create Project

서비스:

Azure AI Services

API 버전:

2025-11-01

새 프로젝트를 만들거나 기존 프로젝트를 업데이트합니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
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 버전입니다.

요청 본문

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

Name	필수	형식	Description
language	True	string	프로젝트 언어입니다. 이는 언어의 BCP-47 표현입니다. 예를 들어 영어에 "en", 영어(영국)의 경우 "en-gb", 스페인어의 경우 "es"를 사용합니다.
projectKind	True	ProjectKind	프로젝트 종류를 나타냅니다.
projectName	True	string	새 프로젝트 이름입니다.
description		string	프로젝트 설명입니다.
multilingual		boolean	프로젝트를 여러 언어로 사용할지 여부입니다.
settings		AnalyzeConversationAuthoringProjectSettings	프로젝트 설정입니다.

응답

Name	형식	Description
200 OK	AnalyzeConversationAuthoringProjectMetadata	요청이 성공했습니다.
201 Created	AnalyzeConversationAuthoringProjectMetadata	요청이 성공했고 결과적으로 새 리소스가 생성되었습니다.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	예기치 않은 오류 응답입니다. 헤더 x-ms-error-code: string

보안

Ocp-Apim-Subscription-Key

형식: apiKey
In(다음 안에): header

OAuth2Auth

형식: oauth2
Flow: accessCode
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize
토큰 URL: https://login.microsoftonline.com/common/oauth2/token

범위

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

예제

Successful Create Project

샘플 요청

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
}

샘플 응답

상태 코드:

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

상태 코드:

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

정의

Name	Description
AnalyzeConversationAuthoringCreateProjectOptions	프로젝트를 만들거나 업데이트하는 데 사용되는 옵션을 나타냅니다.
AnalyzeConversationAuthoringProjectMetadata	프로젝트의 메타데이터를 나타냅니다.
AnalyzeConversationAuthoringProjectSettings	프로젝트 동작을 정의하는 데 사용되는 설정을 나타냅니다.
Azure.Core.Foundations.Error	오류 개체입니다.
Azure.Core.Foundations.ErrorResponse	오류 세부 정보가 포함된 응답입니다.
Azure.Core.Foundations.InnerError	오류에 대한 보다 구체적인 정보를 포함하는 개체입니다. Azure REST API 지침에 따라 - https://aka.ms/AzureRestApiGuidelines#handling-errors.
ProjectKind

AnalyzeConversationAuthoringCreateProjectOptions

Object

프로젝트를 만들거나 업데이트하는 데 사용되는 옵션을 나타냅니다.

Name	형식	Description
description	string	프로젝트 설명입니다.
language	string	프로젝트 언어입니다. 이는 언어의 BCP-47 표현입니다. 예를 들어 영어에 "en", 영어(영국)의 경우 "en-gb", 스페인어의 경우 "es"를 사용합니다.
multilingual	boolean	프로젝트를 여러 언어로 사용할지 여부입니다.
projectKind	ProjectKind	프로젝트 종류를 나타냅니다.
projectName	string	새 프로젝트 이름입니다.
settings	AnalyzeConversationAuthoringProjectSettings	프로젝트 설정입니다.

AnalyzeConversationAuthoringProjectMetadata

Object

프로젝트의 메타데이터를 나타냅니다.

Name	형식	Description
createdDateTime	string (date-time)	프로젝트 생성 날짜/시간을 나타냅니다.
description	string	프로젝트 설명입니다.
language	string	프로젝트 언어입니다. 이는 언어의 BCP-47 표현입니다. 예를 들어 영어에 "en", 영어(영국)의 경우 "en-gb", 스페인어의 경우 "es"를 사용합니다.
lastDeployedDateTime	string (date-time)	프로젝트가 마지막으로 배포된 날짜/시간을 나타냅니다.
lastModifiedDateTime	string (date-time)	프로젝트 생성 날짜/시간을 나타냅니다.
lastTrainedDateTime	string (date-time)	프로젝트가 마지막으로 학습된 날짜/시간을 나타냅니다.
multilingual	boolean	프로젝트를 여러 언어로 사용할지 여부입니다.
projectKind	ProjectKind	프로젝트 종류를 나타냅니다.
projectName	string maxLength: 100	새 프로젝트 이름입니다.
settings	AnalyzeConversationAuthoringProjectSettings	프로젝트 설정입니다.

AnalyzeConversationAuthoringProjectSettings

Object

프로젝트 동작을 정의하는 데 사용되는 설정을 나타냅니다.

Name	형식	Description
confidenceThreshold	number (float)	예측이 자동으로 "없음"으로 변경되는 신뢰도가 가장 높은 의도의 임계값입니다. 임계값은 0에서 1 사이여야 합니다.

Azure.Core.Foundations.Error

Object

오류 개체입니다.

Name	형식	Description
code	string	서버에서 정의한 오류 코드 집합 중 하나입니다.
details	Azure.Core.Foundations.Error[]	이 보고된 오류로 이어진 특정 오류에 대한 세부 정보 배열입니다.
innererror	Azure.Core.Foundations.InnerError	오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.
message	string	사람이 읽을 수 있는 오류 표현입니다.
target	string	오류의 대상입니다.

Azure.Core.Foundations.ErrorResponse

Object

오류 세부 정보가 포함된 응답입니다.

Name	형식	Description
error	Azure.Core.Foundations.Error	오류 개체입니다.

Azure.Core.Foundations.InnerError

Object

오류에 대한 보다 구체적인 정보를 포함하는 개체입니다. Azure REST API 지침에 따라 - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	형식	Description
code	string	서버에서 정의한 오류 코드 집합 중 하나입니다.
innererror	Azure.Core.Foundations.InnerError	내부 오류입니다.

ProjectKind

열거형

값	Description
Conversation	앱, 봇 및 IoT 장치에 자연어를 구축하는 프로젝트입니다.
Orchestration	대화, 사용자 지정 질문 답변 및 LUIS 프로젝트를 하나의 단일 프로젝트에서 함께 연결하고 오케스트레이션하는 프로젝트입니다.