Conversation Authoring Project - Create Project

Dienst:: Azure AI Services

API-Version:: 2025-11-01

Erstellt ein neues Projekt oder aktualisiert ein vorhandenes.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
Endpoint	path	True	string (uri)	Unterstützter Cognitive Services-Endpunkt, z. B. https://< resource-name.api.cognitiveservices.azure.com>.
projectName	path	True	string maxLength: 100	Der neue Projektname.
api-version	query	True	string minLength: 1	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

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

Name	Erforderlich	Typ	Beschreibung
language	True	string	Die Projektsprache. Dies ist die BCP-47-Darstellung einer Sprache. Verwenden Sie z. B. "en" für Englisch, "en-gb" für Englisch (UK), "es" für Spanisch usw.
projectKind	True	ProjectKind	Stellt die Projektart dar.
projectName	True	string	Der neue Projektname.
description		string	Die Projektbeschreibung.
multilingual		boolean	Gibt an, ob das Projekt für mehrere Sprachen verwendet wird oder nicht.
settings		AnalyzeConversationAuthoringProjectSettings	Die Projekteinstellungen.

Antworten

Name	Typ	Beschreibung
200 OK	AnalyzeConversationAuthoringProjectMetadata	Die Anforderung war erfolgreich.
201 Created	AnalyzeConversationAuthoringProjectMetadata	Die Anforderung ist erfolgreich und eine neue Ressource wurde als Ergebnis erstellt.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Unerwartete Fehlerantwort. Header x-ms-error-code: string

Name

Typ

Beschreibung

200 OK

AnalyzeConversationAuthoringProjectMetadata

Die Anforderung war erfolgreich.

201 Created

AnalyzeConversationAuthoringProjectMetadata

Die Anforderung ist erfolgreich und eine neue Ressource wurde als Ergebnis erstellt.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Unerwartete Fehlerantwort.

Header

x-ms-error-code: string

Sicherheit

Ocp-Apim-Subscription-Key

Typ: apiKey
In: header

OAuth2Auth

Typ: oauth2
Ablauf: accessCode
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize
Token-URL: https://login.microsoftonline.com/common/oauth2/token

Bereiche

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

Beispiele

Successful Create Project

Beispielanforderung

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
}

Beispiel für eine Antwort

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

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

Definitionen

Name	Beschreibung
AnalyzeConversationAuthoringCreateProjectOptions	Stellt die Optionen dar, die zum Erstellen oder Aktualisieren eines Projekts verwendet werden.
AnalyzeConversationAuthoringProjectMetadata	Stellt die Metadaten eines Projekts dar.
AnalyzeConversationAuthoringProjectSettings	Stellt die Einstellungen dar, die zum Definieren des Projektverhaltens verwendet werden.
Azure.Core.Foundations.Error	Das Fehlerobjekt.
Azure.Core.Foundations.ErrorResponse	Eine Antwort, die Fehlerdetails enthält.
Azure.Core.Foundations.InnerError	Ein Objekt, das spezifischere Informationen zum Fehler enthält. Gemäß den Richtlinien der Azure-REST-API: . https://aka.ms/AzureRestApiGuidelines#handling-errors
ProjectKind

AnalyzeConversationAuthoringCreateProjectOptions

Objekt

Stellt die Optionen dar, die zum Erstellen oder Aktualisieren eines Projekts verwendet werden.

Name	Typ	Beschreibung
description	string	Die Projektbeschreibung.
language	string	Die Projektsprache. Dies ist die BCP-47-Darstellung einer Sprache. Verwenden Sie z. B. "en" für Englisch, "en-gb" für Englisch (UK), "es" für Spanisch usw.
multilingual	boolean	Gibt an, ob das Projekt für mehrere Sprachen verwendet wird oder nicht.
projectKind	ProjectKind	Stellt die Projektart dar.
projectName	string	Der neue Projektname.
settings	AnalyzeConversationAuthoringProjectSettings	Die Projekteinstellungen.

AnalyzeConversationAuthoringProjectMetadata

Objekt

Stellt die Metadaten eines Projekts dar.

Name	Typ	Beschreibung
createdDateTime	string (date-time)	Stellt das Datum und die Uhrzeit der Projekterstellung dar.
description	string	Die Projektbeschreibung.
language	string	Die Projektsprache. Dies ist die BCP-47-Darstellung einer Sprache. Verwenden Sie z. B. "en" für Englisch, "en-gb" für Englisch (UK), "es" für Spanisch usw.
lastDeployedDateTime	string (date-time)	Stellt das Datum und die Uhrzeit der letzten Bereitstellung des Projekts dar.
lastModifiedDateTime	string (date-time)	Stellt das Datum und die Uhrzeit der Projekterstellung dar.
lastTrainedDateTime	string (date-time)	Stellt das Datum und die Uhrzeit des zuletzt trainierten Projekts dar.
multilingual	boolean	Gibt an, ob das Projekt für mehrere Sprachen verwendet wird oder nicht.
projectKind	ProjectKind	Stellt die Projektart dar.
projectName	string maxLength: 100	Der neue Projektname.
settings	AnalyzeConversationAuthoringProjectSettings	Die Projekteinstellungen.

AnalyzeConversationAuthoringProjectSettings

Objekt

Stellt die Einstellungen dar, die zum Definieren des Projektverhaltens verwendet werden.

Name	Typ	Beschreibung
confidenceThreshold	number (float)	Der Schwellenwert der Absicht mit der höchsten Konfidenz, bei dem die Vorhersage automatisch in "Keine" geändert wird. Der Wert des Schwellenwerts sollte zwischen 0 und einschließlich 1 liegen.

Azure.Core.Foundations.Error

Objekt

Das Fehlerobjekt.

Name	Typ	Beschreibung
code	string	Eine serverdefinierte Gruppe von Fehlercodes.
details	Azure.Core.Foundations.Error[]	Ein Array von Details zu bestimmten Fehlern, die zu diesem gemeldeten Fehler geführt haben.
innererror	Azure.Core.Foundations.InnerError	Ein Objekt, das spezifischere Informationen enthält als das aktuelle Objekt über den Fehler.
message	string	Eine lesbare Darstellung des Fehlers.
target	string	Das Ziel des Fehlers.

Azure.Core.Foundations.ErrorResponse

Objekt

Eine Antwort, die Fehlerdetails enthält.

Name	Typ	Beschreibung
error	Azure.Core.Foundations.Error	Das Fehlerobjekt.

Azure.Core.Foundations.InnerError

Objekt

Ein Objekt, das spezifischere Informationen zum Fehler enthält. Gemäß den Richtlinien der Azure-REST-API: . https://aka.ms/AzureRestApiGuidelines#handling-errors

Name	Typ	Beschreibung
code	string	Eine serverdefinierte Gruppe von Fehlercodes.
innererror	Azure.Core.Foundations.InnerError	Innerer Fehler.

ProjectKind

Enumeration

Wert	Beschreibung
Conversation	Ein Projekt zur Integration natürlicher Sprache in Apps, Bots und IoT-Geräte.
Orchestration	Ein Projekt zum Verbinden und Orchestrieren von Unterhaltungen, benutzerdefinierten Fragen und LUIS-Projekten in einem einzigen Projekt.

Freigeben über

Conversation Authoring Project - Create Project

URI-Parameter

Anforderungstext

Antworten

Sicherheit

Ocp-Apim-Subscription-Key

OAuth2Auth

Bereiche

Beispiele

Successful Create Project

Beispielanforderung

Beispiel für eine Antwort

Definitionen

AnalyzeConversationAuthoringCreateProjectOptions

AnalyzeConversationAuthoringProjectMetadata

AnalyzeConversationAuthoringProjectSettings

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

ProjectKind