Conversational Analysis Authoring - Create Project

服務:

Azure AI Services

API 版本:

2022-05-01

建立新的專案或更新現有的專案。

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

URI 參數

名稱	位於	必要	類型	Description
Endpoint	path	True	string	支援的認知服務端點 （例如，https://.api.cognitiveservices.azure.com).
projectName	path	True	string maxLength: 100	要使用的項目名稱。
api-version	query	True	string	用戶端 API 版本。

要求標頭

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

名稱	必要	類型	Description
Ocp-Apim-Subscription-Key	True	string	語言服務資源的訂用帳戶金鑰。

要求本文

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

名稱	必要	類型	Description
language	True	string	項目語言。 這是語言的 BCP-47 表示法。 例如，使用 「en」 代表英文、“en-gb” 代表英文 （UK）、“es” 代表西班牙文等。
projectKind	True	ProjectKind	表示項目種類。
projectName	True	string	新的項目名稱。
description		string	專案描述。
multilingual		boolean	專案是否要用於多種語言。
settings		ConversationalAnalysisAuthoringProjectSettings	項目設定。

回應

名稱	類型	Description
200 OK	ConversationalAnalysisAuthoringProjectMetadata	如果已更新專案的元資料已經存在，則為 。
201 Created	ConversationalAnalysisAuthoringProjectMetadata	所建立專案的元數據。
Other Status Codes	ErrorResponse	錯誤回應。

安全性

Ocp-Apim-Subscription-Key

語言服務資源的訂用帳戶金鑰。

類型: apiKey
位於: header

範例

Successful Create Project

範例要求

HTTP

PATCH {Endpoint}/language/authoring/analyze-conversations/projects/myproject?api-version=2022-05-01


{
  "projectName": "myproject",
  "language": "en",
  "projectKind": "Conversation",
  "description": "This is a sample conversation project.",
  "multilingual": false
}

範例回覆

狀態碼:

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

狀態碼:

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

定義

名稱	Description
ConversationalAnalysisAuthoringCreateProjectOptions	表示用來建立或更新項目的選項。
ConversationalAnalysisAuthoringProjectMetadata	表示專案的元數據。
ConversationalAnalysisAuthoringProjectSettings	表示用來定義項目行為的設定。
Error	error 物件。
ErrorCode	人類可讀取的錯誤碼。
ErrorResponse	錯誤回應。
InnerErrorCode	人類可讀取的錯誤碼。
InnerErrorModel	物件，包含有關錯誤的更特定資訊。 根據Microsoft一個 API 指導方針 - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses。
ProjectKind	表示項目種類。

ConversationalAnalysisAuthoringCreateProjectOptions

Object

表示用來建立或更新項目的選項。

名稱	類型	Description
description	string	專案描述。
language	string	項目語言。 這是語言的 BCP-47 表示法。 例如，使用 「en」 代表英文、“en-gb” 代表英文 （UK）、“es” 代表西班牙文等。
multilingual	boolean	專案是否要用於多種語言。
projectKind	ProjectKind	表示項目種類。
projectName	string	新的項目名稱。
settings	ConversationalAnalysisAuthoringProjectSettings	項目設定。

ConversationalAnalysisAuthoringProjectMetadata

Object

表示專案的元數據。

名稱	類型	Description
createdDateTime	string (date-time)	表示專案建立日期時間。
description	string	專案描述。
language	string	項目語言。 這是語言的 BCP-47 表示法。 例如，使用 「en」 代表英文、“en-gb” 代表英文 （UK）、“es” 代表西班牙文等。
lastDeployedDateTime	string (date-time)	代表上次部署日期時間的專案。
lastModifiedDateTime	string (date-time)	表示專案建立日期時間。
lastTrainedDateTime	string (date-time)	代表上次定型日期時間的專案。
multilingual	boolean	專案是否要用於多種語言。
projectKind	ProjectKind	表示項目種類。
projectName	string	新的項目名稱。
settings	ConversationalAnalysisAuthoringProjectSettings	項目設定。

ConversationalAnalysisAuthoringProjectSettings

Object

表示用來定義項目行為的設定。

名稱	類型	Description
confidenceThreshold	number (float)	具有最高信賴度的意圖閾值，預測會自動變更為 「無」。

Error

Object

error 物件。

名稱	類型	Description
code	ErrorCode	其中一組伺服器定義的錯誤碼。
details	Error[]	導致此錯誤之特定錯誤的詳細數據陣列。
innererror	InnerErrorModel	物件，包含與目前對象有關錯誤更具體的資訊。
message	string	錯誤的人類可讀取表示法。
target	string	錯誤的目標。

ErrorCode

列舉型別

人類可讀取的錯誤碼。

值	Description
AzureCognitiveSearchIndexLimitReached
AzureCognitiveSearchIndexNotFound
AzureCognitiveSearchNotFound
AzureCognitiveSearchThrottling
Conflict
Forbidden
InternalServerError
InvalidArgument
InvalidRequest
NotFound
OperationNotFound
ProjectNotFound
QuotaExceeded
ServiceUnavailable
Timeout
TooManyRequests
Unauthorized
Warning

ErrorResponse

Object

錯誤回應。

名稱	類型	Description
error	Error	error 物件。

InnerErrorCode

列舉型別

人類可讀取的錯誤碼。

值	Description
AzureCognitiveSearchNotFound
AzureCognitiveSearchThrottling
EmptyRequest
ExtractionFailure
InvalidCountryHint
InvalidDocument
InvalidDocumentBatch
InvalidParameterValue
InvalidRequest
InvalidRequestBodyFormat
KnowledgeBaseNotFound
MissingInputDocuments
ModelVersionIncorrect
UnsupportedLanguageCode

InnerErrorModel

Object

物件，包含有關錯誤的更特定資訊。 根據Microsoft一個 API 指導方針 - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses。

名稱	類型	Description
code	InnerErrorCode	其中一組伺服器定義的錯誤碼。
details	object	錯誤詳細數據。
innererror	InnerErrorModel	物件，包含與目前對象有關錯誤更具體的資訊。
message	string	錯誤資訊。
target	string	錯誤目標。

ProjectKind

列舉型別

表示項目種類。

值	Description
Conversation	將自然語言建置至應用程式、Bot 和IoT裝置的專案。
Orchestration	在單一專案中，連接及協調對話、自定義問題解答和 LUIS 專案的專案。