Runtime - Train

Dienst:

Azure AI Services

API-Version:

4.0

Trainingsaufruf zum Hinzuzufügen von Vorschläge zur Wissensdatenbank.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
kbId	path	True	string	Knowledgebase-ID.
RuntimeEndpoint	path	True	string	QnA Maker App Service-Endpunkt (z. B. https://{qnaservice-hostname}.azurewebsites.net).

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
Authorization	True	string

Anforderungstext

Name	Typ	Beschreibung
feedbackRecords	FeedbackRecordDTO[]	Liste der Feedbackdatensätze.

Antworten

Name	Typ	Beschreibung
204 No Content		HTTP 204 Kein Inhalt.
Other Status Codes	ErrorResponse	Fehlerantwort.

Sicherheit

Authorization

Typ: apiKey
In: header

Beispiele

Successful query

Beispielanforderung

HTTP

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


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

Beispiel für eine Antwort

Statuscode:

204

Definitionen

Name	Beschreibung
Error	Das Fehlerobjekt. Gemäß den Microsoft One-API-Richtlinien – https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
ErrorCodeType	Eine serverdefinierte Gruppe von Fehlercodes.
ErrorResponse	Fehlerantwort. Gemäß den Microsoft One-API-Richtlinien – https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
FeedbackRecordDTO	Aktives Lernfeedback-Datensatz.
FeedbackRecordsDTO	Aktive Lernfeedbackdatensätze.
InnerErrorModel	Ein Objekt, das spezifischere Informationen zum Fehler enthält. Gemäß den Microsoft One-API-Richtlinien – https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Error

Objekt

Das Fehlerobjekt. Gemäß den Microsoft One-API-Richtlinien – https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Name	Typ	Beschreibung
code	ErrorCodeType	Eine serverdefinierte Gruppe von Fehlercodes.
details	Error[]	Ein Array von Details zu bestimmten Fehlern, die zu diesem gemeldeten Fehler geführt haben.
innerError	InnerErrorModel	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.

ErrorCodeType

Enumeration

Eine serverdefinierte Gruppe von Fehlercodes.

Wert	Beschreibung
BadArgument
EndpointKeysError
ExtractionFailure
Forbidden
KbNotFound
NotFound
OperationNotFound
QnaRuntimeError
QuotaExceeded
SKULimitExceeded
ServiceError
Unauthorized
Unspecified
ValidationFailure

ErrorResponse

Objekt

Fehlerantwort. Gemäß den Microsoft One-API-Richtlinien – https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Name	Typ	Beschreibung
error	Error	Das Fehlerobjekt.

FeedbackRecordDTO

Objekt

Aktives Lernfeedback-Datensatz.

Name	Typ	Beschreibung
qnaId	integer (int32)	Die qnaId, für die die vorgeschlagene Frage als Feedback bereitgestellt wird.
userId	string	Eindeutiger Bezeichner für den Benutzer.
userQuestion	string maxLength: 1000	Die vorgeschlagene Frage wird als Feedback bereitgestellt.

FeedbackRecordsDTO

Objekt

Aktive Lernfeedbackdatensätze.

Name	Typ	Beschreibung
feedbackRecords	FeedbackRecordDTO[]	Liste der Feedbackdatensätze.

InnerErrorModel

Objekt

Ein Objekt, das spezifischere Informationen zum Fehler enthält. Gemäß den Microsoft One-API-Richtlinien – https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Name	Typ	Beschreibung
code	string	Ein spezifischerer Fehlercode als vom enthaltenden Fehler bereitgestellt wurde.
innerError	InnerErrorModel	Ein Objekt, das spezifischere Informationen enthält als das aktuelle Objekt über den Fehler.