Runtime - Train

Service:

Cognitive Services - QnA Maker

API Version:

4.0

訓練呼叫以將建議新增至知識庫。

POST {RuntimeEndpoint}/qnamaker/knowledgebases/{kbId}/train

URI 參數

Name	In	Required	Type	Description
kbId	path	True	string	知識庫識別碼。
RuntimeEndpoint	path	True	string	QnA Maker App Service端點 (例如：HTTPs://{qnaservice-hostname}.azurewebsites.net) 。

要求標頭

Name	Required	Type	Description
Authorization	True	string

要求本文

Name	Type	Description
feedbackRecords	FeedbackRecordDTO[]	意見反應記錄的清單。

回應

Name	Type	Description
204 No Content		HTTP 204 無內容。
Other Status Codes	ErrorResponse	錯誤回應。

安全性

Authorization

Type: apiKey
In: header

範例

Successful query

Sample Request

HTTP

POST {RuntimeEndpoint}/qnamaker/knowledgebases/9d091697-fb8c-4ed5-9ac0-35bf8273bfff/train


{
  "feedbackRecords": [
    {
      "userId": "sd53lsY=",
      "userQuestion": "qna maker with luis",
      "qnaId": 4
    }
  ]
}

Sample Response

Status code:

204

定義

Error	error 物件。 根據 Microsoft One API 指導方針 - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses 。
ErrorCodeType	其中一組伺服器定義的錯誤碼。
ErrorResponse	錯誤回應。 根據 Microsoft One API 指導方針 - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses 。
FeedbackRecordDTO	主動式學習意見反應記錄。
FeedbackRecordsDTO	主動式學習意見反應記錄。
InnerErrorModel	物件，包含錯誤的詳細資訊。 根據 Microsoft One API 指導方針 - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses 。

Error

error 物件。 根據 Microsoft One API 指導方針 - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses 。

Name	Type	Description
code	ErrorCodeType	其中一組伺服器定義的錯誤碼。
details	Error[]	導致此錯誤之特定錯誤的詳細資料陣列。
innerError	InnerErrorModel	物件，包含比目前物件有關錯誤更具體的資訊。
message	string	人類可讀取的錯誤標記法。
target	string	錯誤的目標。

ErrorCodeType

其中一組伺服器定義的錯誤碼。

Name	Type	Description
BadArgument	string
EndpointKeysError	string
ExtractionFailure	string
Forbidden	string
KbNotFound	string
NotFound	string
OperationNotFound	string
QnaRuntimeError	string
QuotaExceeded	string
SKULimitExceeded	string
ServiceError	string
Unauthorized	string
Unspecified	string
ValidationFailure	string

ErrorResponse

錯誤回應。 根據 Microsoft One API 指導方針 - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses 。

Name	Type	Description
error	Error	error 物件。

FeedbackRecordDTO

主動式學習意見反應記錄。

Name	Type	Description
qnaId	integer	建議問題的 qnaId 會以意見反應的形式提供。
userId	string	使用者的唯一識別碼。
userQuestion	string	建議的問題會以意見反應的形式提供。

FeedbackRecordsDTO

主動式學習意見反應記錄。

Name	Type	Description
feedbackRecords	FeedbackRecordDTO[]	意見反應記錄的清單。

InnerErrorModel

物件，包含錯誤的詳細資訊。 根據 Microsoft One API 指導方針 - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses 。

Name	Type	Description
code	string	比包含的錯誤所提供更明確的錯誤碼。
innerError	InnerErrorModel	物件，包含比目前物件有關錯誤更具體的資訊。