Conversation Authoring Project - Create Project

Layanan:

Azure AI Services

Versi API:

2025-11-01

Membuat proyek baru atau memperbarui proyek yang sudah ada.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
Endpoint	path	True	string (uri)	Titik akhir Cognitive Services yang didukung, misalnya, https://< resource-name.api.cognitiveservices.azure.com>.
projectName	path	True	string maxLength: 100	Nama proyek baru.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.

Isi Permintaan

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

Nama	Diperlukan	Jenis	Deskripsi
language	True	string	Bahasa proyek. Ini adalah representasi BCP-47 dari sebuah bahasa. Misalnya, gunakan "en" untuk bahasa Inggris, "en-gb" untuk bahasa Inggris (Inggris), "es" untuk bahasa Spanyol dll.
projectKind	True	ProjectKind	Mewakili jenis proyek.
projectName	True	string	Nama proyek baru.
description		string	Deskripsi proyek.
multilingual		boolean	Apakah proyek akan digunakan untuk beberapa bahasa atau tidak.
settings		AnalyzeConversationAuthoringProjectSettings	Pengaturan proyek.

Respons

Nama	Jenis	Deskripsi
200 OK	AnalyzeConversationAuthoringProjectMetadata	Permintaan itu berhasil.
201 Created	AnalyzeConversationAuthoringProjectMetadata	Permintaan telah berhasil dan sumber daya baru telah dibuat sebagai hasilnya.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Respons kesalahan tak terduga. Header x-ms-error-code: string

Keamanan

Ocp-Apim-Subscription-Key

Jenis: apiKey
Dalam: header

OAuth2Auth

Jenis: oauth2
Alur: accessCode
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize
URL token: https://login.microsoftonline.com/common/oauth2/token

Cakupan

Nama	Deskripsi
https://cognitiveservices.azure.com/.default

Contoh

Successful Create Project

Permintaan sampel

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
}

Respon sampel

Kode status:

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

Kode status:

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

Definisi

Nama	Deskripsi
AnalyzeConversationAuthoringCreateProjectOptions	Mewakili opsi yang digunakan untuk membuat atau memperbarui proyek.
AnalyzeConversationAuthoringProjectMetadata	Mewakili metadata proyek.
AnalyzeConversationAuthoringProjectSettings	Mewakili pengaturan yang digunakan untuk menentukan perilaku proyek.
Azure.Core.Foundations.Error	Objek kesalahan.
Azure.Core.Foundations.ErrorResponse	Respons yang berisi detail kesalahan.
Azure.Core.Foundations.InnerError	Objek yang berisi informasi yang lebih spesifik tentang kesalahan. Sesuai pedoman Azure REST API - https://aka.ms/AzureRestApiGuidelines#handling-errors.
ProjectKind

AnalyzeConversationAuthoringCreateProjectOptions

Objek

Mewakili opsi yang digunakan untuk membuat atau memperbarui proyek.

Nama	Jenis	Deskripsi
description	string	Deskripsi proyek.
language	string	Bahasa proyek. Ini adalah representasi BCP-47 dari sebuah bahasa. Misalnya, gunakan "en" untuk bahasa Inggris, "en-gb" untuk bahasa Inggris (Inggris), "es" untuk bahasa Spanyol dll.
multilingual	boolean	Apakah proyek akan digunakan untuk beberapa bahasa atau tidak.
projectKind	ProjectKind	Mewakili jenis proyek.
projectName	string	Nama proyek baru.
settings	AnalyzeConversationAuthoringProjectSettings	Pengaturan proyek.

AnalyzeConversationAuthoringProjectMetadata

Objek

Mewakili metadata proyek.

Nama	Jenis	Deskripsi
createdDateTime	string (date-time)	Mewakili tanggalwaktu pembuatan proyek.
description	string	Deskripsi proyek.
language	string	Bahasa proyek. Ini adalah representasi BCP-47 dari sebuah bahasa. Misalnya, gunakan "en" untuk bahasa Inggris, "en-gb" untuk bahasa Inggris (Inggris), "es" untuk bahasa Spanyol dll.
lastDeployedDateTime	string (date-time)	Mewakili tanggalwaktu yang terakhir diterapkan proyek.
lastModifiedDateTime	string (date-time)	Mewakili tanggalwaktu pembuatan proyek.
lastTrainedDateTime	string (date-time)	Mewakili tanggalwaktu yang terakhir dilatih proyek.
multilingual	boolean	Apakah proyek akan digunakan untuk beberapa bahasa atau tidak.
projectKind	ProjectKind	Mewakili jenis proyek.
projectName	string maxLength: 100	Nama proyek baru.
settings	AnalyzeConversationAuthoringProjectSettings	Pengaturan proyek.

AnalyzeConversationAuthoringProjectSettings

Objek

Mewakili pengaturan yang digunakan untuk menentukan perilaku proyek.

Nama	Jenis	Deskripsi
confidenceThreshold	number (float)	Ambang batas niat dengan kepercayaan tertinggi, di mana prediksi akan secara otomatis diubah menjadi "Tidak Ada". Nilai ambang batas harus antara 0 dan 1 inklusif.

Azure.Core.Foundations.Error

Objek

Objek kesalahan.

Nama	Jenis	Deskripsi
code	string	Salah satu sekumpulan kode kesalahan yang ditentukan server.
details	Azure.Core.Foundations.Error[]	Array detail tentang kesalahan tertentu yang menyebabkan kesalahan yang dilaporkan ini.
innererror	Azure.Core.Foundations.InnerError	Objek yang berisi informasi yang lebih spesifik daripada objek saat ini tentang kesalahan.
message	string	Representasi kesalahan yang dapat dibaca manusia.
target	string	Target kesalahan.

Azure.Core.Foundations.ErrorResponse

Objek

Respons yang berisi detail kesalahan.

Nama	Jenis	Deskripsi
error	Azure.Core.Foundations.Error	Objek kesalahan.

Azure.Core.Foundations.InnerError

Objek

Objek yang berisi informasi yang lebih spesifik tentang kesalahan. Sesuai pedoman Azure REST API - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Nama	Jenis	Deskripsi
code	string	Salah satu sekumpulan kode kesalahan yang ditentukan server.
innererror	Azure.Core.Foundations.InnerError	Kesalahan dalam.

ProjectKind

Enumeration

Nilai	Deskripsi
Conversation	Proyek untuk membangun bahasa alami ke dalam aplikasi, bot, dan perangkat IoT.
Orchestration	Proyek untuk menghubungkan dan mengatur proyek Percakapan, Jawaban pertanyaan khusus, dan LUIS bersama-sama dalam satu proyek.