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).

kbId
path True

string

Wissensdatenbank-ID.

Anforderungsheader

Name Erforderlich Typ Beschreibung
Ocp-Apim-Subscription-Key True

string

Anforderungstext

Name Typ Beschreibung
add

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

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

Update

Eine instance von UpdateKbContentsDTO für Updatevorgang

Antworten

Name Typ Beschreibung
202 Accepted

Operation

Details des asynchronen Vorgangs.

Headers

Location: string

Other Status Codes

ErrorResponse

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.

ErrorCodeType

Einer der vom Server definierten Fehlercodes.

ErrorResponse

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.

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.

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.

OperationStateType

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

UpdateKbOperationDTO

Enthält eine Liste der zu aktualisierenden QnAs.

UpdateQnaDTO

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

PromptDTO[]

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

ErrorCodeType

Einer der vom Server definierten 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 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

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

InnerErrorModel

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

MetadataDTO[]

Liste der Metadaten, die der Antwort zugeordnet sind, die hinzugefügt werden soll

delete

MetadataDTO[]

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

ErrorResponse

Fehlerdetails bei Fehlern.

lastActionTimestamp

string

Zeitstempel, bei dem der aktuelle Zustand eingegeben wurde.

operationId

string

Vorgangs-ID.

operationState

OperationStateType

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

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

Context

Kontext einer QnA

id

integer

Eindeutige ID für die Q-A.

lastUpdatedTimestamp

string

Zeitstempel, wann die QnA zuletzt aktualisiert wurde.

metadata

MetadataDTO[]

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

Context

Kontext einer QnA

id

integer

Eindeutige ID für die Q-A.

lastUpdatedTimestamp

string

Zeitstempel, wann die QnA zuletzt aktualisiert wurde.

metadata

MetadataDTO[]

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

UpdateQnaDTO[]

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

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

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

Update

Eine instance von UpdateKbContentsDTO für Updatevorgang

UpdateQnaDTO

PATCH-Textschema für Qna-Liste aktualisieren

Name Typ Beschreibung
answer

string

Antworttext

context

Context

Kontext, der Qna zugeordnet ist, um aktualisiert zu werden.

id

integer

Eindeutige ID für die Q-A

metadata

Metadata

Liste der Metadaten, die der zu aktualisierenden Antwort zugeordnet sind

questions

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