Conversation Authoring Project - Create Project

Služba:

Azure AI Services

Verze rozhraní API:

2025-11-01

Vytvoří nový projekt nebo aktualizuje existující projekt.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
Endpoint	path	True	string (uri)	Podporovaný koncový bod služeb Cognitive Services, např. https://< resource-name.api.cognitiveservices.azure.com>.
projectName	path	True	string maxLength: 100	Název nového projektu.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

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

Name	Vyžadováno	Typ	Description
language	True	string	Jazyk projektu. Toto je reprezentace jazyka BCP-47. Například použijte "en" pro angličtinu, "en-gb" pro angličtinu (UK), "es" pro španělštinu atd.
projectKind	True	ProjectKind	Představuje druh projektu.
projectName	True	string	Název nového projektu.
description		string	Popis projektu.
multilingual		boolean	Bez ohledu na to, jestli se projekt použije pro více jazyků, nebo ne.
settings		AnalyzeConversationAuthoringProjectSettings	Nastavení projektu.

Odpovědi

Name	Typ	Description
200 OK	AnalyzeConversationAuthoringProjectMetadata	Žádost byla úspěšná.
201 Created	AnalyzeConversationAuthoringProjectMetadata	Požadavek byl úspěšný a v důsledku toho byl vytvořen nový prostředek.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Neočekávaná chybová odpověď Hlavičky x-ms-error-code: string

Zabezpečení

Ocp-Apim-Subscription-Key

Typ: apiKey
V: header

OAuth2Auth

Typ: oauth2
Tok: accessCode
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize
URL tokenu: https://login.microsoftonline.com/common/oauth2/token

Rozsahy

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

Příklady

Successful Create Project

Ukázkový požadavek

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
}

Ukázková odpověď

Stavový kód:

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

Stavový kód:

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

Definice

Name	Description
AnalyzeConversationAuthoringCreateProjectOptions	Představuje možnosti použité k vytvoření nebo aktualizaci projektu.
AnalyzeConversationAuthoringProjectMetadata	Představuje metadata projektu.
AnalyzeConversationAuthoringProjectSettings	Představuje nastavení použitá k definování chování projektu.
Azure.Core.Foundations.Error	Objekt chyby.
Azure.Core.Foundations.ErrorResponse	Odpověď obsahující podrobnosti o chybě.
Azure.Core.Foundations.InnerError	Objekt obsahující konkrétnější informace o chybě. Podle pokynů pro rozhraní Azure REST API - https://aka.ms/AzureRestApiGuidelines#handling-errors.
ProjectKind

AnalyzeConversationAuthoringCreateProjectOptions

Objekt

Představuje možnosti použité k vytvoření nebo aktualizaci projektu.

Name	Typ	Description
description	string	Popis projektu.
language	string	Jazyk projektu. Toto je reprezentace jazyka BCP-47. Například použijte "en" pro angličtinu, "en-gb" pro angličtinu (UK), "es" pro španělštinu atd.
multilingual	boolean	Bez ohledu na to, jestli se projekt použije pro více jazyků, nebo ne.
projectKind	ProjectKind	Představuje druh projektu.
projectName	string	Název nového projektu.
settings	AnalyzeConversationAuthoringProjectSettings	Nastavení projektu.

AnalyzeConversationAuthoringProjectMetadata

Objekt

Představuje metadata projektu.

Name	Typ	Description
createdDateTime	string (date-time)	Představuje datum a čas vytvoření projektu.
description	string	Popis projektu.
language	string	Jazyk projektu. Toto je reprezentace jazyka BCP-47. Například použijte "en" pro angličtinu, "en-gb" pro angličtinu (UK), "es" pro španělštinu atd.
lastDeployedDateTime	string (date-time)	Představuje datum a čas posledního nasazení projektu.
lastModifiedDateTime	string (date-time)	Představuje datum a čas vytvoření projektu.
lastTrainedDateTime	string (date-time)	Představuje datum a čas posledního naučení projektu.
multilingual	boolean	Bez ohledu na to, jestli se projekt použije pro více jazyků, nebo ne.
projectKind	ProjectKind	Představuje druh projektu.
projectName	string maxLength: 100	Název nového projektu.
settings	AnalyzeConversationAuthoringProjectSettings	Nastavení projektu.

AnalyzeConversationAuthoringProjectSettings

Objekt

Představuje nastavení použitá k definování chování projektu.

Name	Typ	Description
confidenceThreshold	number (float)	Prahová hodnota záměru s nejvyšší spolehlivostí, při které se predikce automaticky změní na "Žádná". Hodnota prahové hodnoty by měla být v rozmezí od 0 do 1 včetně.

Azure.Core.Foundations.Error

Objekt

Objekt chyby.

Name	Typ	Description
code	string	Jedna ze serverově definovaných kódů chyb.
details	Azure.Core.Foundations.Error[]	Pole podrobností o konkrétních chybách, které vedly k této nahlášené chybě.
innererror	Azure.Core.Foundations.InnerError	Objekt obsahující konkrétnější informace, než je aktuální objekt o chybě.
message	string	Čitelné znázornění chyby člověkem.
target	string	Cíl chyby.

Azure.Core.Foundations.ErrorResponse

Objekt

Odpověď obsahující podrobnosti o chybě.

Name	Typ	Description
error	Azure.Core.Foundations.Error	Objekt chyby.

Azure.Core.Foundations.InnerError

Objekt

Objekt obsahující konkrétnější informace o chybě. Podle pokynů pro rozhraní Azure REST API - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	Typ	Description
code	string	Jedna ze serverově definovaných kódů chyb.
innererror	Azure.Core.Foundations.InnerError	Vnitřní chyba.

ProjectKind

Výčet

Hodnota	Description
Conversation	Projekt na zabudování přirozeného jazyka do aplikací, robotů a zařízení IoT.
Orchestration	Projekt pro propojení a orchestraci projektů Conversation, Custom Question Answering a LUIS do jednoho projektu.