Question Answering Projects - Import

Referenz

Dienst:: Cognitive Services - Language

API-Version:: 2023-04-01

Importieren sie Projektressourcen.

POST {Endpoint}/language/authoring/query-knowledgebases/projects/{projectName}/:import?api-version=2023-04-01

Mit optionalen Parametern:

POST {Endpoint}/language/authoring/query-knowledgebases/projects/{projectName}/:import?api-version=2023-04-01&format={format}&assetKind={assetKind}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
Endpoint	path	True	string	Unterstützter Cognitive Services-Endpunkt (z. B. https://.api.cognitiveservices.azure.com).
projectName	path	True	string	Der Name des zu verwendenden Projekts.
api-version	query	True	string	Client-API-Version.
assetKind	query		string	Art der Ressource des Projekts.
format	query		format	Import- oder Exportformat der Wissensdatenbank.

Anforderungstext

Name	Typ	Beschreibung
assets	Assets	Alle Ressourcen für dieses Projekt.
fileUri	string	Datei-URI zum Importieren von Daten.
metadata	CreateProjectOptions	Parameter, die zum Erstellen des Projekts erforderlich sind.

Antworten

Name	Typ	Beschreibung
202 Accepted		Ein erfolgreicher Aufruf enthält einen Operation-Location-Header, mit dem der Auftragsstatus überprüft wird. Header Operation-Location: string
Other Status Codes	ErrorResponse	Fehlerantwort.

Name

Typ

Beschreibung

202 Accepted

Ein erfolgreicher Aufruf enthält einen Operation-Location-Header, mit dem der Auftragsstatus überprüft wird.

Header

Operation-Location: string

Other Status Codes

ErrorResponse

Fehlerantwort.

Sicherheit

AADToken

Dies sind die Azure Active Directory OAuth2-Flows . In Kombination mit der rollenbasierten Zugriffssteuerung in Azure kann sie verwendet werden, um den Zugriff auf Azure Maps REST-APIs zu steuern. Rollenbasierte Zugriffssteuerungen in Azure werden verwendet, um den Zugriff auf ein oder mehrere Azure Maps Ressourcenkonto oder Unterressourcen festzulegen. Jedem Benutzer, jeder Gruppe oder einem Dienstprinzipal kann zugriff über eine integrierte Rolle oder eine benutzerdefinierte Rolle gewährt werden, die aus einer oder mehreren Berechtigungen für Azure Maps REST-APIs besteht.

Zur Implementierung von Szenarien wird empfohlen, Authentifizierungskonzepte anzuzeigen. Zusammenfassend bietet diese Sicherheitsdefinition eine Lösung zum Modellieren von Anwendungen über Objekte, die die Zugriffssteuerung für bestimmte APIs und Bereiche ermöglichen.

Hinweise

Diese Sicherheitsdefinition erfordert die Verwendung des x-ms-client-id Headers, um anzugeben, auf welche Azure Maps Ressource die Anwendung Zugriff anfordert. Dies kann über die Kartenverwaltungs-API abgerufen werden.

ist Authorization URL spezifisch für die öffentliche Azure-Cloud instance. Sovereign Clouds verfügen über eindeutige Autorisierungs-URLs und Azure Active Directory-Konfigurationen. * Die rollenbasierte Zugriffssteuerung von Azure wird über die Azure-Verwaltungsebene über Azure-Portal, PowerShell, CLI, Azure SDKs oder REST-APIs konfiguriert. * Die Verwendung des Azure Maps Web SDK ermöglicht die konfigurationsbasierte Einrichtung einer Anwendung für mehrere Anwendungsfälle.

Derzeit unterstützt Azure Active Directory v1.0 oder v2.0 Arbeit, Schule und Gäste, aber keine persönlichen Konten.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
https://cognitiveservices.azure.com/.default	https://cognitiveservices.azure.com/.default

Ocp-Apim-Subscription-Key

Ein Abonnementschlüssel für eine Sprachdienstressource.

Typ: apiKey
In: header

Beispiele

Successful query

Beispielanforderung

HTTP

POST {Endpoint}/language/authoring/query-knowledgebases/projects/proj1/:import?api-version=2023-04-01

{
  "assets": {
    "synonyms": [
      {
        "alterations": [
          "wa",
          "washington",
          "washington state"
        ]
      },
      {
        "alterations": [
          "U.S",
          "usa",
          "united states of america"
        ]
      }
    ],
    "qnas": [
      {
        "lastUpdatedDateTime": "2021-05-01T17:21:14Z",
        "id": 1,
        "answer": "ans1",
        "source": "source1",
        "questions": [
          "question 1.1",
          "question 1.2"
        ],
        "metadata": {
          "k1": "v1",
          "k2": "v2"
        },
        "dialog": {
          "isContextOnly": false,
          "prompts": [
            {
              "displayOrder": 1,
              "qnaId": 2,
              "displayText": "prompt 1.1"
            }
          ]
        }
      },
      {
        "lastUpdatedDateTime": "2021-05-01T17:21:14Z",
        "id": 2,
        "answer": "ans2",
        "source": "source2",
        "questions": [
          "question 2.1",
          "question 2.2"
        ]
      }
    ]
  }
}

Beispiel für eine Antwort

Statuscode:: 202

Operation-Location: https:///language/authoring/query-knowledgebases/projects/proj1/import/jobs/job1?api-version=2023-04-01

Definitionen

Name	Beschreibung
Assets	Alle Ressourcen für dieses Projekt.
CreateProjectOptions	Parameter, die zum Erstellen des Projekts erforderlich sind.
Error	Das Fehlerobjekt.
ErrorCode	Lesbarer Fehlercode.
ErrorResponse	Fehlerantwort.
format	Import- oder Exportformat der Wissensdatenbank.
ImportJobOptions	Projektressourcen, die importiert werden müssen.
ImportQnaRecord	QnA-Eintrag importieren.
InnerErrorCode	Lesbarer Fehlercode.
InnerErrorModel	Ein Objekt, das spezifischere Informationen zum Fehler enthält. Gemäß den Richtlinien der Microsoft One-API: https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
ProjectSettings	Konfigurierbare Einstellungen des Projekts.
QnaDialog	Dem QnA-Eintrag zugeordnetes Dialogfeld.
QnaPrompt	Aufforderung zur Eingabe einer Antwort.
QnaRecord	QnA-Eintrag.
SuggestedQuestion	Frage, die vom Feature "Aktives Lernen" vorgeschlagen wird.
SuggestedQuestionsCluster	Details des Active Learning-Clusters für vorgeschlagene Fragen.
WordAlterations	Sammlung von Wortänderungen.

Assets

Alle Ressourcen für dieses Projekt.

Name	Typ	Beschreibung
qnas	ImportQnaRecord[]	Liste der zu importierenden QnA-Einträge.
synonyms	WordAlterations[]	Sammlung von Synonymen.

CreateProjectOptions

Parameter, die zum Erstellen des Projekts erforderlich sind.

Name	Typ	Beschreibung
description	string	Beschreibung des Projekts.
language	string	Sprache der Textdatensätze. Dies ist die BCP-47-Darstellung einer Sprache. Verwenden Sie z. B. "en" für Englisch; "es" für Spanisch usw. Wenn nicht festgelegt, verwenden Sie "en" für Englisch als Standard.
multilingualResource	boolean	Legen Sie diesen Wert auf true fest, um das Erstellen von Wissensdatenbanken in verschiedenen Sprachen für dieselbe Ressource zu ermöglichen.
settings	ProjectSettings	Konfigurierbare Einstellungen des Projekts.

Error

Das Fehlerobjekt.

Name	Typ	Beschreibung
code	ErrorCode	Einer von einem serverdefiniertem Satz 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.

ErrorCode

Lesbarer Fehlercode.

Name	Typ	Beschreibung
AzureCognitiveSearchIndexLimitReached	string
AzureCognitiveSearchIndexNotFound	string
AzureCognitiveSearchNotFound	string
AzureCognitiveSearchThrottling	string
Conflict	string
Forbidden	string
InternalServerError	string
InvalidArgument	string
InvalidRequest	string
NotFound	string
OperationNotFound	string
ProjectNotFound	string
QuotaExceeded	string
ServiceUnavailable	string
Timeout	string
TooManyRequests	string
Unauthorized	string
Warning	string

ErrorResponse

Fehlerantwort.

Name	Typ	Beschreibung
error	Error	Das Fehlerobjekt.

format

Import- oder Exportformat der Wissensdatenbank.

Name	Typ	Beschreibung
excel	string	Exportieren oder importieren Sie Wissensdatenbank Replikat, einschließlich aller Ressourcen und Metadaten im Tsv-Format.
json	string	Exportieren oder Importieren von QnA-Ressourcen im JSON-Format.
tsv	string	Exportieren oder importieren Sie Wissensdatenbank Replikat, einschließlich aller Ressourcen und Metadaten im Excel-Format.

ImportJobOptions

Projektressourcen, die importiert werden müssen.

Name	Typ	Beschreibung
assets	Assets	Alle Ressourcen für dieses Projekt.
fileUri	string	Datei-URI zum Importieren von Daten.
metadata	CreateProjectOptions	Parameter, die zum Erstellen des Projekts erforderlich sind.

ImportQnaRecord

QnA-Eintrag importieren.

Name	Typ	Beschreibung
activeLearningSuggestions	SuggestedQuestionsCluster[]	Liste der Vorschläge für aktives Lernen für die QnA.
answer	string	Antworttext.
dialog	QnaDialog	Kontext einer QnA.
id	integer	Eindeutige ID für die QnA.
lastUpdatedDateTime	string	Datum/Uhrzeit der letzten Aktualisierung der QnA.
metadata	object	Metadaten, die der Antwort zugeordnet sind, nützlich zum Kategorisieren oder Filtern von Fragenantworten.
questions	string[]	Liste der Fragen, die der Antwort zugeordnet sind.
source	string	Quelle, aus der QnA indiziert wurde, z. B. https://docs.microsoft.com/en-us/azure/cognitive-services/QnAMaker/FAQs .
sourceDisplayName	string	Anzeigename der Quelle.

InnerErrorCode

Lesbarer Fehlercode.

Name	Typ	Beschreibung
AzureCognitiveSearchNotFound	string
AzureCognitiveSearchThrottling	string
EmptyRequest	string
ExtractionFailure	string
InvalidCountryHint	string
InvalidDocument	string
InvalidDocumentBatch	string
InvalidParameterValue	string
InvalidRequest	string
InvalidRequestBodyFormat	string
KnowledgeBaseNotFound	string
MissingInputDocuments	string
ModelVersionIncorrect	string
UnsupportedLanguageCode	string

InnerErrorModel

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

Name	Typ	Beschreibung
code	InnerErrorCode	Einer von einem serverdefiniertem Satz von Fehlercodes.
details	object	Fehlerdetails.
innererror	InnerErrorModel	Ein -Objekt, das spezifischere Informationen enthält als das aktuelle Objekt über den Fehler.
message	string	Fehlermeldung.
target	string	Fehlerziel.

ProjectSettings

Konfigurierbare Einstellungen des Projekts.

Name	Typ	Beschreibung
defaultAnswer	string	Standardantwort, wenn keine gute Übereinstimmung im Wissensdatenbank gefunden wird.

QnaDialog

Dem QnA-Eintrag zugeordnetes Dialogfeld.

Name	Typ	Beschreibung
isContextOnly	boolean	Um zu markieren, ob eine Eingabeaufforderung nur mit einer vorherigen Frage relevant ist oder nicht. Wenn true, schließen Sie diese QnA nicht als Antwort für Abfragen ohne Kontext ein. andernfalls ignoriert den Kontext und schließt diese QnA in Antworten ein.
prompts	QnaPrompt[]	Liste der Eingabeaufforderungen, die der Antwort zugeordnet sind.

QnaPrompt

Aufforderung zur Eingabe einer Antwort.

Name	Typ	Beschreibung
displayOrder	integer	Index der Eingabeaufforderung. Es wird für die Reihenfolge der Eingabeaufforderungen verwendet.
displayText	string	Text, der angezeigt wird, um eine Nachfrageaufforderung darzustellen.
qna	QnaRecord	QnA-Eintrag. Entweder QnAId oder QnA-Eintrag muss in einer Eingabeaufforderung vorhanden sein.
qnaId	integer	ID der QnA,die der Eingabeaufforderung entspricht.

QnaRecord

QnA-Eintrag.

Name	Typ	Beschreibung
activeLearningSuggestions	SuggestedQuestionsCluster[]	Liste der Vorschläge für aktives Lernen für die QnA.
answer	string	Antworttext.
dialog	QnaDialog	Kontext einer QnA.
id	integer	Eindeutige ID für die QnA.
metadata	object	Metadaten, die der Antwort zugeordnet sind, nützlich zum Kategorisieren oder Filtern von Fragenantworten.
questions	string[]	Liste der Fragen, die der Antwort zugeordnet sind.
source	string	Quelle, aus der QnA indiziert wurde, z. B. https://docs.microsoft.com/en-us/azure/cognitive-services/QnAMaker/FAQs .

SuggestedQuestion

Frage, die vom Feature "Aktives Lernen" vorgeschlagen wird.

Name	Typ	Beschreibung
autoSuggestedCount	integer	Gibt an, wie oft die Frage automatisch vom Active Learning-Algorithmus vorgeschlagen wurde.
question	string	Frage, die vom Feature "Aktives Lernen" vorgeschlagen wird.
userSuggestedCount	integer	Gibt an, wie oft die Frage explizit vom Benutzer vorgeschlagen wurde.

SuggestedQuestionsCluster

Details des Active Learning-Clusters für vorgeschlagene Fragen.

Name	Typ	Beschreibung
clusterHead	string	Frage, die vom Clusteringalgorithmus für Active Learning als Leiter des Clusterclusters "Vorgeschlagene Fragen" ausgewählt wurde.
suggestedQuestions	SuggestedQuestion[]	Liste aller vorgeschlagenen Fragen für die QnA.

WordAlterations

Sammlung von Wortänderungen.

Name	Typ	Beschreibung
alterations	string[]	Sammlung von Wortänderungen.

Freigeben über

Question Answering Projects - Import

URI-Parameter

Anforderungstext

Antworten

Sicherheit

AADToken

Hinweise

Bereiche

Ocp-Apim-Subscription-Key

Beispiele

Successful query

Beispielanforderung

Beispiel für eine Antwort

Definitionen

Assets

CreateProjectOptions

Error

ErrorCode

ErrorResponse

format

ImportJobOptions

ImportQnaRecord

InnerErrorCode

InnerErrorModel

ProjectSettings

QnaDialog

QnaPrompt

QnaRecord

SuggestedQuestion

SuggestedQuestionsCluster

WordAlterations

Zusätzliche Ressourcen