Conversation Authoring Project - Create Project

Hizmet:

Azure AI Services

API Sürümü:

2025-11-01

Yeni bir proje oluşturur veya mevcut bir projeyi güncelleştirir.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
Endpoint	path	True	string (uri)	Desteklenen Bilişsel Hizmetler uç noktası, örneğin, https://< resource-name.api.cognitiveservices.azure.com>.
projectName	path	True	string maxLength: 100	Yeni proje adı.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

İstek Gövdesi

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

Name	Gerekli	Tür	Description
language	True	string	Proje dili. Bu, bir dilin BCP-47 gösterimidir. Örneğin, İngilizce için "en", İngilizce (UK) için "en-gb" , İspanyolca için "es" vb. kullanın.
projectKind	True	ProjectKind	Proje türünü temsil eder.
projectName	True	string	Yeni proje adı.
description		string	Proje açıklaması.
multilingual		boolean	Projenin birden çok dil için kullanılıp kullanılmayacağı.
settings		AnalyzeConversationAuthoringProjectSettings	Proje ayarları.

Yanıtlar

Name	Tür	Description
200 OK	AnalyzeConversationAuthoringProjectMetadata	İstek başarılı oldu.
201 Created	AnalyzeConversationAuthoringProjectMetadata	İstek başarılı oldu ve sonuç olarak yeni bir kaynak oluşturuldu.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Beklenmeyen bir hata yanıtı. Üst Bilgiler x-ms-error-code: string

Güvenlik

Ocp-Apim-Subscription-Key

Tür: apiKey
İçinde: header

OAuth2Auth

Tür: oauth2
Akış: accessCode
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize
Belirteç URL'si: https://login.microsoftonline.com/common/oauth2/token

Kapsamlar

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

Örnekler

Successful Create Project

Örnek isteği

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
}

Örnek yanıt

Durum kodu:

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

Durum kodu:

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

Tanımlar

Name	Description
AnalyzeConversationAuthoringCreateProjectOptions	Proje oluşturmak veya güncelleştirmek için kullanılan seçenekleri temsil eder.
AnalyzeConversationAuthoringProjectMetadata	Projenin meta verilerini temsil eder.
AnalyzeConversationAuthoringProjectSettings	Proje davranışını tanımlamak için kullanılan ayarları temsil eder.
Azure.Core.Foundations.Error	Hata nesnesi.
Azure.Core.Foundations.ErrorResponse	Hata ayrıntılarını içeren bir yanıt.
Azure.Core.Foundations.InnerError	Hata hakkında daha ayrıntılı bilgi içeren bir nesne. Azure REST API yönergelerine göre - https://aka.ms/AzureRestApiGuidelines#handling-errors.
ProjectKind

AnalyzeConversationAuthoringCreateProjectOptions

Object

Proje oluşturmak veya güncelleştirmek için kullanılan seçenekleri temsil eder.

Name	Tür	Description
description	string	Proje açıklaması.
language	string	Proje dili. Bu, bir dilin BCP-47 gösterimidir. Örneğin, İngilizce için "en", İngilizce (UK) için "en-gb" , İspanyolca için "es" vb. kullanın.
multilingual	boolean	Projenin birden çok dil için kullanılıp kullanılmayacağı.
projectKind	ProjectKind	Proje türünü temsil eder.
projectName	string	Yeni proje adı.
settings	AnalyzeConversationAuthoringProjectSettings	Proje ayarları.

AnalyzeConversationAuthoringProjectMetadata

Object

Projenin meta verilerini temsil eder.

Name	Tür	Description
createdDateTime	string (date-time)	Proje oluşturma tarih saat değerini temsil eder.
description	string	Proje açıklaması.
language	string	Proje dili. Bu, bir dilin BCP-47 gösterimidir. Örneğin, İngilizce için "en", İngilizce (UK) için "en-gb" , İspanyolca için "es" vb. kullanın.
lastDeployedDateTime	string (date-time)	Projenin son dağıtılan tarih saatini temsil eder.
lastModifiedDateTime	string (date-time)	Proje oluşturma tarih saat değerini temsil eder.
lastTrainedDateTime	string (date-time)	Projenin son eğitilen tarih saatini temsil eder.
multilingual	boolean	Projenin birden çok dil için kullanılıp kullanılmayacağı.
projectKind	ProjectKind	Proje türünü temsil eder.
projectName	string maxLength: 100	Yeni proje adı.
settings	AnalyzeConversationAuthoringProjectSettings	Proje ayarları.

AnalyzeConversationAuthoringProjectSettings

Object

Proje davranışını tanımlamak için kullanılan ayarları temsil eder.

Name	Tür	Description
confidenceThreshold	number (float)	Tahminin otomatik olarak "Yok" olarak değiştirileceği en yüksek güvene sahip amaç eşiği. Eşiğin değeri 0 ile 1 (dahil) arasında olmalıdır.

Azure.Core.Foundations.Error

Object

Hata nesnesi.

Name	Tür	Description
code	string	Sunucu tanımlı hata kodları kümesinden biri.
details	Azure.Core.Foundations.Error[]	Bu bildirilen hataya yol açan belirli hatalar hakkında bir dizi ayrıntı.
innererror	Azure.Core.Foundations.InnerError	Hatayla ilgili geçerli nesneden daha belirli bilgiler içeren bir nesne.
message	string	Hatanın insan tarafından okunabilir bir gösterimi.
target	string	Hatanın hedefi.

Azure.Core.Foundations.ErrorResponse

Object

Hata ayrıntılarını içeren bir yanıt.

Name	Tür	Description
error	Azure.Core.Foundations.Error	Hata nesnesi.

Azure.Core.Foundations.InnerError

Object

Hata hakkında daha ayrıntılı bilgi içeren bir nesne. Azure REST API yönergelerine göre - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	Tür	Description
code	string	Sunucu tanımlı hata kodları kümesinden biri.
innererror	Azure.Core.Foundations.InnerError	İç hata.

ProjectKind

Listeleme

Değer	Description
Conversation	Uygulamalara, botlara ve IoT cihazlarına doğal dil oluşturma projesi.
Orchestration	Konuşma, Özel soru yanıtlama ve LUIS projelerini tek bir projede birbirine bağlamaya ve düzenlemeye yönelik bir proje.