Conversation Authoring Project - Create Project

Tjänst:

Azure AI Services

API-version:

2025-11-01

Skapar ett nytt projekt eller uppdaterar ett befintligt projekt.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
Endpoint	path	True	string (uri)	Cognitive Services-slutpunkt som stöds, t.ex. https://< resource-name.api.cognitiveservices.azure.com>.
projectName	path	True	string maxLength: 100	Det nya projektnamnet.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Begärandetext

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

Name	Obligatorisk	Typ	Description
language	True	string	Projektspråket. Det här är BCP-47-representation av ett språk. Använd till exempel "en" för engelska, "en-gb" för engelska (Storbritannien), "es" för spanska osv.
projectKind	True	ProjectKind	Representerar projekttypen.
projectName	True	string	Det nya projektnamnet.
description		string	Projektbeskrivningen.
multilingual		boolean	Om projektet skulle användas för flera språk eller inte.
settings		AnalyzeConversationAuthoringProjectSettings	Projektinställningarna.

Svar

Name	Typ	Description
200 OK	AnalyzeConversationAuthoringProjectMetadata	Begäran har slutförts.
201 Created	AnalyzeConversationAuthoringProjectMetadata	Begäran har slutförts och en ny resurs har skapats som ett resultat.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Ett oväntat felsvar. Sidhuvuden x-ms-error-code: string

Säkerhet

Ocp-Apim-Subscription-Key

Typ: apiKey
I: header

OAuth2Auth

Typ: oauth2
Flow: accessCode
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize
Token-webbadress: https://login.microsoftonline.com/common/oauth2/token

Omfattningar

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

Exempel

Successful Create Project

Exempelbegäran

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
}

Exempelsvar

Statuskod:

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

Statuskod:

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

Definitioner

Name	Description
AnalyzeConversationAuthoringCreateProjectOptions	Representerar de alternativ som används för att skapa eller uppdatera ett projekt.
AnalyzeConversationAuthoringProjectMetadata	Representerar metadata för ett projekt.
AnalyzeConversationAuthoringProjectSettings	Representerar de inställningar som används för att definiera projektbeteendet.
Azure.Core.Foundations.Error	Felobjektet.
Azure.Core.Foundations.ErrorResponse	Ett svar som innehåller felinformation.
Azure.Core.Foundations.InnerError	Ett objekt som innehåller mer specifik information om felet. Enligt riktlinjerna för Azure REST API – https://aka.ms/AzureRestApiGuidelines#handling-errors.
ProjectKind

AnalyzeConversationAuthoringCreateProjectOptions

Objekt

Representerar de alternativ som används för att skapa eller uppdatera ett projekt.

Name	Typ	Description
description	string	Projektbeskrivningen.
language	string	Projektspråket. Det här är BCP-47-representation av ett språk. Använd till exempel "en" för engelska, "en-gb" för engelska (Storbritannien), "es" för spanska osv.
multilingual	boolean	Om projektet skulle användas för flera språk eller inte.
projectKind	ProjectKind	Representerar projekttypen.
projectName	string	Det nya projektnamnet.
settings	AnalyzeConversationAuthoringProjectSettings	Projektinställningarna.

AnalyzeConversationAuthoringProjectMetadata

Objekt

Representerar metadata för ett projekt.

Name	Typ	Description
createdDateTime	string (date-time)	Representerar datumtid för projektskapande.
description	string	Projektbeskrivningen.
language	string	Projektspråket. Det här är BCP-47-representation av ett språk. Använd till exempel "en" för engelska, "en-gb" för engelska (Storbritannien), "es" för spanska osv.
lastDeployedDateTime	string (date-time)	Representerar projektets senast distribuerade datetime.
lastModifiedDateTime	string (date-time)	Representerar datumtid för projektskapande.
lastTrainedDateTime	string (date-time)	Representerar projektets senast tränade datetime.
multilingual	boolean	Om projektet skulle användas för flera språk eller inte.
projectKind	ProjectKind	Representerar projekttypen.
projectName	string maxLength: 100	Det nya projektnamnet.
settings	AnalyzeConversationAuthoringProjectSettings	Projektinställningarna.

AnalyzeConversationAuthoringProjectSettings

Objekt

Representerar de inställningar som används för att definiera projektbeteendet.

Name	Typ	Description
confidenceThreshold	number (float)	Tröskelvärdet för avsikten med högsta konfidens, där förutsägelsen automatiskt ändras till "Ingen". Värdet för tröskelvärdet ska vara mellan 0 och 1 inklusive.

Azure.Core.Foundations.Error

Objekt

Felobjektet.

Name	Typ	Description
code	string	En av en serverdefinierad uppsättning felkoder.
details	Azure.Core.Foundations.Error[]	En matris med information om specifika fel som ledde till det rapporterade felet.
innererror	Azure.Core.Foundations.InnerError	Ett objekt som innehåller mer specifik information än det aktuella objektet om felet.
message	string	En mänsklig läsbar representation av felet.
target	string	Målet för felet.

Azure.Core.Foundations.ErrorResponse

Objekt

Ett svar som innehåller felinformation.

Name	Typ	Description
error	Azure.Core.Foundations.Error	Felobjektet.

Azure.Core.Foundations.InnerError

Objekt

Ett objekt som innehåller mer specifik information om felet. Enligt riktlinjerna för Azure REST API – https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	Typ	Description
code	string	En av en serverdefinierad uppsättning felkoder.
innererror	Azure.Core.Foundations.InnerError	Inre fel.

ProjectKind

Uppräkning

Värde	Description
Conversation	Ett projekt för att bygga in naturligt språk i appar, robotar och IoT-enheter.
Orchestration	Ett projekt för att ansluta och orkestrera konversations-, anpassade frågesvars- och LUIS-projekt tillsammans i ett enda projekt.