Knowledgebase - Update
Asynchroner Vorgang zum Ändern einer Wissensdatenbank.
PATCH {Endpoint}/qnamaker/v5.0-preview.2/knowledgebases/{kbId}
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
Endpoint
|
path | True |
string |
Unterstützte Cognitive Services-Endpunkte (z. B. https://< qnamaker-resource-name >.api.cognitiveservices.azure.com). |
kb
|
path | True |
string |
Wissensdatenbank-ID. |
Anforderungsheader
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Ocp-Apim-Subscription-Key | True |
string |
Anforderungstext
Name | Typ | Beschreibung |
---|---|---|
add |
Eine instance von CreateKbInputDTO für den Add-Vorgang |
|
defaultAnswerUsedForExtraction |
string |
Textzeichenfolge, die als Antwort in einer beliebigen Q-A verwendet werden soll, die keine extrahierte Antwort aus dem Dokument enthält, aber eine Hierarchie aufweist. Erforderlich, wenn das Feld EnableHierarchicalExtraction auf True festgelegt ist. |
delete |
Eine instance von DeleteKbContentsDTO für den Löschvorgang |
|
enableHierarchicalExtraction |
boolean |
Aktivieren Sie die hierarchische Extraktion von Q-A aus Dateien und URLs. Der bei der KB-Erstellung festgelegte Wert wird verwendet, wenn dieses Feld nicht vorhanden ist. |
update |
Eine instance von UpdateKbContentsDTO für Updatevorgang |
Antworten
Name | Typ | Beschreibung |
---|---|---|
202 Accepted |
Details des asynchronen Vorgangs. Headers Location: string |
|
Other Status Codes |
Fehlerantwort. |
Sicherheit
Ocp-Apim-Subscription-Key
Type:
apiKey
In:
header
Beispiele
Successful query
Sample Request
PATCH {Endpoint}/qnamaker/v5.0-preview.2/knowledgebases/9d091697-fb8c-4ed5-9ac0-35bf8273bfff
{
"add": {
"qnaList": [
{
"id": 0,
"answer": "You can change the default message if you use the QnAMakerDialog. See this for details: https://docs.botframework.com/en-us/azure-bot-service/templates/qnamaker/#navtitle",
"source": "Custom Editorial",
"questions": [
"How can I change the default message from QnA Maker?"
],
"metadata": []
}
],
"urls": [
"https://docs.microsoft.com/en-us/azure/cognitive-services/Emotion/FAQ"
],
"files": [
{
"fileName": "SurfaceManual.pdf",
"fileUri": "https://download.microsoft.com/download/2/9/B/29B20383-302C-4517-A006-B0186F04BE28/surface-pro-4-user-guide-EN.pdf"
}
]
},
"delete": {
"ids": [
13,
35
]
},
"update": {
"name": "QnA Maker FAQ Prompts Bot",
"qnaList": [
{
"id": 2,
"answer": "You can use our REST apis to create a KB. See here for details: https://docs.microsoft.com/en-us/rest/api/cognitiveservices/qnamaker/knowledgebase/create",
"source": "Custom Editorial",
"questions": {
"add": [],
"delete": []
},
"metadata": {
"add": [],
"delete": []
},
"context": {
"isContextOnly": false,
"promptsToAdd": [
{
"displayText": "Add Prompts",
"displayOrder": 0,
"qna": {
"id": 0,
"answer": "Click here to know more https://docs.microsoft.com/en-us/azure/cognitive-services/qnamaker/how-to/multiturn-conversation",
"source": "Editorial",
"questions": [
"How can I add prompts?"
],
"metadata": [],
"context": {
"isContextOnly": false,
"prompts": []
}
},
"qnaId": 0
},
{
"displayText": "Delete Prompts",
"displayOrder": 0,
"qna": {
"id": 0,
"answer": "Click here to know more https://docs.microsoft.com/en-us/azure/cognitive-services/qnamaker/how-to/multiturn-conversation",
"source": "Editorial",
"questions": [
"How can I delete delete prompts?"
],
"metadata": [],
"context": {
"isContextOnly": false,
"prompts": []
}
},
"qnaId": 0
},
{
"displayText": "Update Knowledgebase",
"displayOrder": 0,
"qna": null,
"qnaId": 3
}
],
"promptsToDelete": [
3
]
}
},
{
"id": 3,
"answer": "You can use our REST apis to update your KB. See here for details: https://docs.microsoft.com/en-us/rest/api/cognitiveservices/qnamaker/knowledgebase/update",
"source": "Custom Editorial",
"questions": {
"add": [],
"delete": []
},
"metadata": {
"delete": [
{
"name": "category",
"value": "api"
}
],
"add": [
{
"name": "category",
"value": "programmatic"
}
]
},
"context": {
"isContextOnly": false,
"promptsToAdd": [
{
"displayText": "Regenerate Endpoint keys",
"displayOrder": 1,
"qna": null,
"qnaId": 4
}
],
"promptsToDelete": [
4
]
}
}
]
}
}
Sample Response
{
"operationState": "NotStarted",
"createdTimestamp": "2018-03-19T07:38:46Z",
"lastActionTimestamp": "2018-03-19T07:39:29Z",
"userId": "86bb8390-56c0-42c2-9f81-3de161981191",
"operationId": "03a4f4ce-30a6-4ec6-b436-02bcdf6153e1"
}
Definitionen
Name | Beschreibung |
---|---|
Add |
Eine instance von CreateKbInputDTO für den Add-Vorgang |
Context |
Kontext, der Qna zugeordnet ist, um aktualisiert zu werden. |
Delete |
Eine instance von DeleteKbContentsDTO für den Löschvorgang |
Error |
Das Fehlerobjekt. Gemäß den Microsoft One-API-Richtlinien: https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses. |
Error |
Einer der vom Server definierten Fehlercodes. |
Error |
Fehlerantwort. Gemäß den Microsoft One-API-Richtlinien: https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses. |
FileDTO |
DTO, um Details der hochgeladenen Dateien zu speichern. |
Inner |
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. |
Metadata |
Liste der Metadaten, die der zu aktualisierenden Antwort zugeordnet sind |
MetadataDTO |
Name: Wertpaar von Metadaten. |
Operation |
Zeichnen Sie auf, um den Betrieb mit langer Ausführung nachzuverfolgen. |
Operation |
Vorgangsstatus. |
PromptDTO |
Fordern Sie eine Antwort an. |
Qna |
QnADTO: Entweder QnaId oder QnADTO muss in einem PromptDTO-Objekt vorhanden sein. |
QnADTO |
Q-A-Objekt. |
Questions |
Liste der Fragen, die der Antwort zugeordnet sind. |
Update |
Eine instance von UpdateKbContentsDTO für Updatevorgang |
Update |
Enthält eine Liste der zu aktualisierenden QnAs. |
Update |
PATCH-Textschema für Qna-Liste aktualisieren |
Add
Eine instance von CreateKbInputDTO für den Add-Vorgang
Name | Typ | Beschreibung |
---|---|---|
files |
FileDTO[] |
Liste der Dateien, die der Wissensdatenbank hinzugefügt werden sollen. |
qnaList |
QnADTO[] |
Liste der QNA, die dem Index hinzugefügt werden sollen. Ids werden vom Dienst generiert und sollten weggelassen werden. |
urls |
string[] |
Liste der URLs, die der Wissensdatenbank hinzugefügt werden sollen. |
Context
Kontext, der Qna zugeordnet ist, um aktualisiert zu werden.
Name | Typ | Beschreibung |
---|---|---|
isContextOnly |
boolean |
So markieren Sie, ob eine Eingabeaufforderung nur mit einer vorherigen Frage relevant ist oder nicht. true: Schließen Sie diese QnA nicht als Suchergebnis für Abfragen ohne Kontext false ein . Ignoriert den Kontext und schließt diese QnA in das Suchergebnis ein. |
promptsToAdd |
Liste der Eingabeaufforderungen, die dem qna hinzugefügt werden sollen. |
|
promptsToDelete |
integer[] |
Liste der zu löschenden Eingabeaufforderungen, die qna zugeordnet sind |
Delete
Eine instance von DeleteKbContentsDTO für den Löschvorgang
Name | Typ | Beschreibung |
---|---|---|
ids |
integer[] |
Liste der zu löschenden Qna-Ids |
sources |
string[] |
Liste der Quellen, die aus der Wissensdatenbank gelöscht werden sollen. |
Error
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 |
Einer der vom Server definierten Fehlercodes. |
|
details |
Error[] |
Ein Array von Details zu bestimmten Fehlern, die zu diesem gemeldeten Fehler geführt haben. |
innerError |
Ein Objekt, das spezifischere Informationen enthält als das aktuelle Objekt über den Fehler. |
|
message |
string |
Eine für Menschen lesbare Darstellung des Fehlers. |
target |
string |
Das Ziel des Fehlers. |
ErrorCodeType
Einer der vom Server definierten Fehlercodes.
Name | Typ | Beschreibung |
---|---|---|
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
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 |
Das Fehlerobjekt. |
FileDTO
DTO, um Details der hochgeladenen Dateien zu speichern.
Name | Typ | Beschreibung |
---|---|---|
fileName |
string |
Dateiname Unterstützte Dateitypen sind ".tsv", ".pdf", ".txt", ".docx", ".xlsx". |
fileUri |
string |
Öffentlicher URI der Datei. |
isUnstructured |
boolean |
Optionales Flag, um anzugeben, ob die angegebene Datei unstrukturiert ist. |
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.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Ein spezifischerer Fehlercode als vom enthaltenden Fehler bereitgestellt wurde. |
innerError |
Ein Objekt, das spezifischere Informationen enthält als das aktuelle Objekt über den Fehler. |
Metadata
Liste der Metadaten, die der zu aktualisierenden Antwort zugeordnet sind
Name | Typ | Beschreibung |
---|---|---|
add |
Liste der Metadaten, die der Antwort zugeordnet sind, die hinzugefügt werden soll |
|
delete |
Liste der Metadaten, die der zu löschenden Antwort zugeordnet sind |
MetadataDTO
Name: Wertpaar von Metadaten.
Name | Typ | Beschreibung |
---|---|---|
name |
string |
Metadatenname |
value |
string |
Metadatenwert |
Operation
Zeichnen Sie auf, um den Betrieb mit langer Ausführung nachzuverfolgen.
Name | Typ | Beschreibung |
---|---|---|
createdTimestamp |
string |
Zeitstempel beim Erstellen des Vorgangs. |
errorResponse |
Fehlerdetails bei Fehlern. |
|
lastActionTimestamp |
string |
Zeitstempel, bei dem der aktuelle Zustand eingegeben wurde. |
operationId |
string |
Vorgangs-ID. |
operationState |
Vorgangsstatus. |
|
resourceLocation |
string |
Relativer URI zum Zielressourcenspeicherort für abgeschlossene Ressourcen. |
userId |
string |
Benutzer-ID |
OperationStateType
Vorgangsstatus.
Name | Typ | Beschreibung |
---|---|---|
Failed |
string |
|
NotStarted |
string |
|
Running |
string |
|
Succeeded |
string |
PromptDTO
Fordern Sie eine Antwort an.
Name | Typ | Beschreibung |
---|---|---|
displayOrder |
integer |
Index der Eingabeaufforderung – wird für die Reihenfolge der Eingabeaufforderungen verwendet |
displayText |
string |
Text, der angezeigt wird, um eine Nachfrageaufforderung darzustellen |
qna |
QnADTO: Entweder QnaId oder QnADTO muss in einem PromptDTO-Objekt vorhanden sein. |
|
qnaId |
integer |
Qna-ID entspricht der Eingabeaufforderung: Wenn QnaId vorhanden ist, wird das QnADTO-Objekt ignoriert. |
Qna
QnADTO: Entweder QnaId oder QnADTO muss in einem PromptDTO-Objekt vorhanden sein.
Name | Typ | Beschreibung |
---|---|---|
answer |
string |
Antworttext |
context |
Kontext einer QnA |
|
id |
integer |
Eindeutige ID für die Q-A. |
lastUpdatedTimestamp |
string |
Zeitstempel, wann die QnA zuletzt aktualisiert wurde. |
metadata |
Liste der Metadaten, die der Antwort zugeordnet sind. |
|
questions |
string[] |
Liste der Fragen, die der Antwort zugeordnet sind. |
source |
string |
Quelle, aus der Q-A indiziert wurde. Zb. https://docs.microsoft.com/en-us/azure/cognitive-services/QnAMaker/FAQs |
QnADTO
Q-A-Objekt.
Name | Typ | Beschreibung |
---|---|---|
answer |
string |
Antworttext |
context |
Kontext einer QnA |
|
id |
integer |
Eindeutige ID für die Q-A. |
lastUpdatedTimestamp |
string |
Zeitstempel, wann die QnA zuletzt aktualisiert wurde. |
metadata |
Liste der Metadaten, die der Antwort zugeordnet sind. |
|
questions |
string[] |
Liste der Fragen, die der Antwort zugeordnet sind. |
source |
string |
Quelle, aus der Q-A indiziert wurde. Zb. https://docs.microsoft.com/en-us/azure/cognitive-services/QnAMaker/FAQs |
Questions
Liste der Fragen, die der Antwort zugeordnet sind.
Name | Typ | Beschreibung |
---|---|---|
add |
string[] |
Liste der hinzuzufügenden Fragen |
delete |
string[] |
Liste der zu löschenden Fragen. |
Update
Eine instance von UpdateKbContentsDTO für Updatevorgang
Name | Typ | Beschreibung |
---|---|---|
defaultAnswer |
string |
Standardantwort, die an den Benutzer gesendet wird, wenn keine gute Übereinstimmung in der KB gefunden wird. |
name |
string |
Anzeigename für die Wissensdatenbank. |
qnaList |
Liste der Q-A (UpdateQnaDTO), die der Wissensdatenbank hinzugefügt werden sollen. |
|
urls |
string[] |
Liste der vorhandenen URLs, die aktualisiert werden sollen. Der Inhalt wird erneut extrahiert und neu indiziert. |
UpdateKbOperationDTO
Enthält eine Liste der zu aktualisierenden QnAs.
Name | Typ | Beschreibung |
---|---|---|
add |
Eine instance von CreateKbInputDTO für den Add-Vorgang |
|
defaultAnswerUsedForExtraction |
string |
Textzeichenfolge, die als Antwort in einer beliebigen Q-A verwendet werden soll, die keine extrahierte Antwort aus dem Dokument enthält, aber eine Hierarchie aufweist. Erforderlich, wenn das Feld EnableHierarchicalExtraction auf True festgelegt ist. |
delete |
Eine instance von DeleteKbContentsDTO für den Löschvorgang |
|
enableHierarchicalExtraction |
boolean |
Aktivieren Sie die hierarchische Extraktion von Q-A aus Dateien und URLs. Der bei der KB-Erstellung festgelegte Wert wird verwendet, wenn dieses Feld nicht vorhanden ist. |
update |
Eine instance von UpdateKbContentsDTO für Updatevorgang |
UpdateQnaDTO
PATCH-Textschema für Qna-Liste aktualisieren
Name | Typ | Beschreibung |
---|---|---|
answer |
string |
Antworttext |
context |
Kontext, der Qna zugeordnet ist, um aktualisiert zu werden. |
|
id |
integer |
Eindeutige ID für die Q-A |
metadata |
Liste der Metadaten, die der zu aktualisierenden Antwort zugeordnet sind |
|
questions |
Liste der Fragen, die der Antwort zugeordnet sind. |
|
source |
string |
Quelle, aus der Q-A indiziert wurde. Zb. https://docs.microsoft.com/en-us/azure/cognitive-services/QnAMaker/FAQs |