你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Knowledgebase - Train

Service:

Cognitive Services - QnA Maker

API Version:

v5.0-preview.2

训练调用以 (QnAMaker 托管) 向知识库添加建议。

POST {Endpoint}/qnamaker/v5.0-preview.2/knowledgebases/{kbId}/train

URI 参数

名称	在	必需	类型	说明
Endpoint	path	True	string	支持的认知服务终结点 (例如，https://< qnamaker-resource-name >.api.cognitiveservices.azure.com) 。
kbId	path	True	string	知识库 ID。

请求头

名称	必需	类型	说明
Ocp-Apim-Subscription-Key	True	string

请求正文

名称	类型	说明
feedbackRecords	FeedbackRecordDTO[]	反馈记录列表。

响应

名称	类型	说明
204 No Content		HTTP 204 无内容。
Other Status Codes	ErrorResponse	错误响应。

安全性

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

示例

Successful query

Sample Request

HTTP

POST {Endpoint}/qnamaker/v5.0-preview.2/knowledgebases/9d091697-fb8c-4ed5-9ac0-35bf8273bfff/train


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

Sample Response

Status code:

204

定义

名称	说明
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

错误对象。 根据 Microsoft One API 指南 - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses。

名称	类型	说明
code	ErrorCodeType	服务器定义的一组错误代码中的一个。
details	Error[]	有关导致此项报告错误的特定错误的详细信息数组。
innerError	InnerErrorModel	一个 对象，该对象包含比当前对象更具体的错误信息。
message	string	错误的用户可读表示形式。
target	string	错误的目标。

ErrorCodeType

服务器定义的一组错误代码中的一个。

名称	类型	说明
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。

名称	类型	说明
error	Error	错误对象。

FeedbackRecordDTO

主动学习反馈记录。

名称	类型	说明
qnaId	integer	建议的问题作为反馈提供的 qnaId。
userId	string	用户的唯一标识符。
userQuestion	string	建议的问题作为反馈提供。

FeedbackRecordsDTO

主动学习反馈记录。

名称	类型	说明
feedbackRecords	FeedbackRecordDTO[]	反馈记录列表。

InnerErrorModel

包含有关错误的更具体信息的对象。 根据 Microsoft One API 指南 - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses。

名称	类型	说明
code	string	比包含的错误提供的错误代码更具体的代码。
innerError	InnerErrorModel	一个 对象，该对象包含比当前对象更具体的错误信息。