Conversation Authoring Project - Create Project

Servizio:

Azure AI Services

Versione API:

2025-11-01

Crea un nuovo progetto o ne aggiorna uno esistente.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
Endpoint	path	True	string (uri)	Endpoint di Servizi cognitivi supportati, ad esempio https://< nome-risorsa.api.cognitiveservices.azure.com>.
projectName	path	True	string maxLength: 100	Nome del nuovo progetto.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

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

Nome	Necessario	Tipo	Descrizione
language	True	string	Linguaggio del progetto. Si tratta della rappresentazione BCP-47 di una lingua. Ad esempio, usare "en" per l'inglese, "en-gb" per l'inglese (Regno Unito), "es" per lo spagnolo e così via.
projectKind	True	ProjectKind	Rappresenta il tipo di progetto.
projectName	True	string	Nome del nuovo progetto.
description		string	Descrizione del progetto.
multilingual		boolean	Indica se il progetto verrà usato o meno per più lingue.
settings		AnalyzeConversationAuthoringProjectSettings	Impostazioni del progetto.

Risposte

Nome	Tipo	Descrizione
200 OK	AnalyzeConversationAuthoringProjectMetadata	La richiesta è andata a buon fine.
201 Created	AnalyzeConversationAuthoringProjectMetadata	La richiesta ha avuto esito positivo e di conseguenza è stata creata una nuova risorsa.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Risposta di errore imprevista. Intestazioni x-ms-error-code: string

Sicurezza

Ocp-Apim-Subscription-Key

Tipo: apiKey
In: header

OAuth2Auth

Tipo: oauth2
Flow: accessCode
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize
URL token: https://login.microsoftonline.com/common/oauth2/token

Ambiti

Nome	Descrizione
https://cognitiveservices.azure.com/.default

Esempio

Successful Create Project

Esempio di richiesta

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
}

Risposta di esempio

Codice di stato:

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

Codice di stato:

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

Definizioni

Nome	Descrizione
AnalyzeConversationAuthoringCreateProjectOptions	Rappresenta le opzioni utilizzate per creare o aggiornare un progetto.
AnalyzeConversationAuthoringProjectMetadata	Rappresenta i metadati di un progetto.
AnalyzeConversationAuthoringProjectSettings	Rappresenta le impostazioni utilizzate per definire il comportamento del progetto.
Azure.Core.Foundations.Error	Oggetto error.
Azure.Core.Foundations.ErrorResponse	Risposta contenente i dettagli dell'errore.
Azure.Core.Foundations.InnerError	Oggetto contenente informazioni più specifiche sull'errore. In base alle linee guida dell'API REST di Azure - https://aka.ms/AzureRestApiGuidelines#handling-errors.
ProjectKind

AnalyzeConversationAuthoringCreateProjectOptions

Object

Rappresenta le opzioni utilizzate per creare o aggiornare un progetto.

Nome	Tipo	Descrizione
description	string	Descrizione del progetto.
language	string	Linguaggio del progetto. Si tratta della rappresentazione BCP-47 di una lingua. Ad esempio, usare "en" per l'inglese, "en-gb" per l'inglese (Regno Unito), "es" per lo spagnolo e così via.
multilingual	boolean	Indica se il progetto verrà usato o meno per più lingue.
projectKind	ProjectKind	Rappresenta il tipo di progetto.
projectName	string	Nome del nuovo progetto.
settings	AnalyzeConversationAuthoringProjectSettings	Impostazioni del progetto.

AnalyzeConversationAuthoringProjectMetadata

Object

Rappresenta i metadati di un progetto.

Nome	Tipo	Descrizione
createdDateTime	string (date-time)	Rappresenta la data/ora di creazione del progetto.
description	string	Descrizione del progetto.
language	string	Linguaggio del progetto. Si tratta della rappresentazione BCP-47 di una lingua. Ad esempio, usare "en" per l'inglese, "en-gb" per l'inglese (Regno Unito), "es" per lo spagnolo e così via.
lastDeployedDateTime	string (date-time)	Rappresenta l'ultima data e ora di distribuzione del progetto.
lastModifiedDateTime	string (date-time)	Rappresenta la data/ora di creazione del progetto.
lastTrainedDateTime	string (date-time)	Rappresenta l'ultima data e ora di training del progetto.
multilingual	boolean	Indica se il progetto verrà usato o meno per più lingue.
projectKind	ProjectKind	Rappresenta il tipo di progetto.
projectName	string maxLength: 100	Nome del nuovo progetto.
settings	AnalyzeConversationAuthoringProjectSettings	Impostazioni del progetto.

AnalyzeConversationAuthoringProjectSettings

Object

Rappresenta le impostazioni utilizzate per definire il comportamento del progetto.

Nome	Tipo	Descrizione
confidenceThreshold	number (float)	Soglia dell'intento con l'attendibilità più alta, in corrispondenza della quale la stima verrà automaticamente modificata in "Nessuna". Il valore della soglia deve essere compreso tra 0 e 1 inclusi.

Azure.Core.Foundations.Error

Object

Oggetto error.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
details	Azure.Core.Foundations.Error[]	Matrice di dettagli sugli errori specifici che hanno causato l'errore segnalato.
innererror	Azure.Core.Foundations.InnerError	Oggetto contenente informazioni più specifiche dell'oggetto corrente sull'errore.
message	string	Rappresentazione leggibile dell'errore.
target	string	Destinazione dell'errore.

Azure.Core.Foundations.ErrorResponse

Object

Risposta contenente i dettagli dell'errore.

Nome	Tipo	Descrizione
error	Azure.Core.Foundations.Error	Oggetto error.

Azure.Core.Foundations.InnerError

Object

Oggetto contenente informazioni più specifiche sull'errore. In base alle linee guida dell'API REST di Azure - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
innererror	Azure.Core.Foundations.InnerError	Errore interno.

ProjectKind

Enumerazione

Valore	Descrizione
Conversation	Un progetto per creare un linguaggio naturale in app, bot e dispositivi IoT.
Orchestration	Un progetto per connettere e orchestrare contemporaneamente in un unico progetto Conversazione, Risposta alle domande personalizzata e progetti LUIS.