Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Antworten und Antworttypen abfragen
Amazon Kendra unterstützt verschiedene Abfrageantworten und Antworttypen.
Antworten abfragen
Ein Aufruf der Query API gibt Informationen über die Ergebnisse einer Suche zurück. Die Ergebnisse befinden sich in einem Array von QueryResultItemObjekten (ResultItems). Jedes QueryResultItem enthält eine Zusammenfassung des Ergebnisses. Mit dem Abfrageergebnis verknüpfte Dokumentattribute sind enthalten.
Zusammenfassende Informationen
Die zusammenfassenden Informationen variieren je nach Art des Ergebnisses. In jedem Fall enthält es Dokumenttext, der dem Suchbegriff entspricht. Es enthält auch Hervorhebungsinformationen, mit denen Sie den Suchtext in der Ausgabe Ihrer Anwendung hervorheben können. Wenn der Suchbegriff beispielsweise wie hoch ist die Space Needle? , die zusammenfassenden Informationen beinhalten die Textposition für die Wörter Höhe und Space Needle. Informationen zu Antworttypen finden Sie unterAntworten und Antworttypen abfragen.
Attribute des Dokuments
Jedes Ergebnis enthält Dokumentattribute für das Dokument, das einer Abfrage entspricht. Einige der Attribute sind vordefiniert, z. B. DocumentIdDocumentTitle, undDocumentUri. Andere sind benutzerdefinierte Attribute, die Sie definieren. Sie können Dokumentattribute verwenden, um die Antwort von der Query API zu filtern. Beispielsweise möchten Sie möglicherweise nur die Dokumente verwenden, die von einem bestimmten Autor oder einer bestimmten Version eines Dokuments verfasst wurden. Weitere Informationen finden Sie unter Filterung und Facettensuche. Sie geben Dokumentattribute an, wenn Sie Dokumente zu einem Index hinzufügen. Weitere Informationen finden Sie unter Benutzerdefinierte Felder oder Attribute.
Im Folgenden finden Sie einen JSON-Beispielcode für ein Abfrageergebnis. Notieren Sie sich die Dokumentattribute in DocumentAttributes undAdditionalAttributes.
{ "QueryId": "query-id", "ResultItems": [ { "Id": "result-id", "Type": "ANSWER", "AdditionalAttributes": [ { "Key": "AnswerText", "ValueType": "TEXT_WITH_HIGHLIGHTS_VALUE", "Value": { "TextWithHighlightsValue": { "Text": "text", "Highlights": [ { "BeginOffset": 55, "EndOffset": 90, "TopAnswer": false } ] } } } ], "DocumentId": "document-id", "DocumentTitle": { "Text": "title" }, "DocumentExcerpt": { "Text": "text", "Highlights": [ { "BeginOffset": 0, "EndOffset": 300, "TopAnswer": false } ] }, "DocumentURI": "uri", "DocumentAttributes": [], "ScoreAttributes": "score", "FeedbackToken": "token" }, { "Id": "result-id", "Type": "ANSWER", "Format": "TABLE", "DocumentId": "document-id", "DocumentTitle": { "Text": "title" }, "TableExcerpt": { "Rows": [{ "Cells": [{ "Header": true, "Highlighted": false, "TopAnswer": false, "Value": "value" }, { "Header": true, "Highlighted": false, "TopAnswer": false, "Value": "value" }, { "Header": true, "Highlighted": false, "TopAnswer": false, "Value": "value" }, { "Header": true, "Highlighted": false, "TopAnswer": false, "Value": "value" }] }, { "Cells": [{ "Header": false, "Highlighted": false, "TopAnswer": false, "Value": "value" }, { "Header": false, "Highlighted": false, "TopAnswer": false, "Value": "value" }, { "Header": false, "Highlighted": true, "TopAnswer": true, "Value": "value" }, { "Header": false, "Highlighted": false, "TopAnswer": false, "Value": "value" ]} }], "TotalNumberofRows":number}, "DocumentURI": "uri", "ScoreAttributes": "score", "FeedbackToken": "token" }, { "Id": "result-id", "Type": "DOCUMENT", "AdditionalAttributes": [], "DocumentId": "document-id", "DocumentTitle": { "Text": "title", "Highlights": [] }, "DocumentExcerpt": { "Text": "text", "Highlights": [ { "BeginOffset": 74, "EndOffset": 77, "TopAnswer": false } ] }, "DocumentURI": "uri", "DocumentAttributes": [ { "Key": "_source_uri", "Value": { "StringValue": "uri" } } ], "ScoreAttributes": "score", "FeedbackToken": "token", } ], "FacetResults": [], "TotalNumberOfResults":number}
Arten von Antworten
Amazon Kendra gibt drei Arten von Abfrageantworten zurück.
-
Antwort (beinhaltet Tabellenantwort)
-
Dokument
-
Frage und Antwort
Der Typ der Antwort wird im Type Antwortfeld des QueryResultItemObjekts zurückgegeben.
Antwort
Amazon Kendra hat eine oder mehrere Antworten auf Fragen in der Antwort erkannt. Ein Faktoid ist die Antwort auf eine „Wer“, „Was“, „Wann“ oder „Wo“ -Frage wie „Wo ist das nächstgelegene Servicecenter?“ Amazon Kendra gibt Text im Index zurück, der der Abfrage am besten entspricht. Der Text befindet sich im AnswerText Feld und enthält hervorgehobene Informationen für den Suchbegriff im Antworttext. AnswerTextenthält den vollständigen Dokumentauszug mit hervorgehobenem Text und DocumentExcerpt den gekürzten (290 Zeichen) Dokumentauszug mit hervorgehobenem Text.
Amazon Kendra gibt nur eine Antwort pro Dokument zurück, und das ist die Antwort mit der höchsten Zuverlässigkeit. Um mehrere Antworten aus einem Dokument zurückzugeben, müssen Sie das Dokument in mehrere Dokumente aufteilen.
{ 'AnswerText': { 'TextWithHighlights': [ { 'BeginOffset': 271, 'EndOffset': 279, 'TopAnswer': False }, { 'BeginOffset': 481, 'EndOffset': 489, 'TopAnswer': False }, { 'BeginOffset': 547, 'EndOffset': 555, 'TopAnswer': False }, { 'BeginOffset': 764, 'EndOffset': 772, 'TopAnswer': False } ], 'Text': 'Asynchronousoperationscan\n''alsoprocess\n''documentsthatareinPDF''format.UsingPDFformatfilesallowsyoutoprocess''multi-page\n''documents.\n''Forinformationabouthow''AmazonTextractrepresents\n''documentsasBlockobjects, ''seeDocumentsandBlockObjects.\n''\n''\n''\n''Forinformationaboutdocument''limits, seeLimitsinAmazonTextract.\n''\n''\n''\n''TheAmazonTextractsynchronous''operationscanprocessdocumentsstoredinanAmazon\n''S3Bucketoryoucanpass''base64encodedimagebytes.\n''Formoreinformation, see''CallingAmazonTextractSynchronousOperations.''Asynchronousoperationsrequireinputdocuments\n''tobesuppliedinanAmazon''S3Bucket.' }, 'DocumentExcerpt': { 'Highlights': [ { 'BeginOffset': 0, 'EndOffset': 300, 'TopAnswer': False } ], 'Text': 'Asynchronousoperationscan\n''alsoprocess\n''documentsthatareinPDF''format.UsingPDFformatfilesallowsyoutoprocess''multi-page\n''documents.\n''ForinformationabouthowAmazon''Textractrepresents\n''' }, 'Type': 'ANSWER' }
Dokument
Amazon Kendra gibt Dokumente mit Rangfolge für diejenigen zurück, die dem Suchbegriff entsprechen. Die Rangfolge basiert auf dem Vertrauen, Amazon Kendra das Sie in die Richtigkeit des Suchergebnisses haben. Informationen über das passende Dokument werden in der zurückgegeben QueryResultItem. Es enthält den Titel des Dokuments. Der Auszug enthält hervorgehobene Informationen für den Suchtext und den Abschnitt mit dem passenden Text im Dokument. Der URI für übereinstimmende Dokumente befindet sich im SourceURI Dokumentattribut. Das folgende JSON-Beispiel zeigt die Dokumentzusammenfassung für ein passendes Dokument.
{ 'DocumentTitle': { 'Highlights': [ { 'BeginOffset': 7, 'EndOffset': 15, 'TopAnswer': False }, { 'BeginOffset': 97, 'EndOffset': 105, 'TopAnswer': False } ], 'Text': 'AmazonTextractAPIPermissions: Actions, \n''Permissions, andResourcesReference-''AmazonTextract' }, 'DocumentExcerpt': { 'Highlights': [ { 'BeginOffset': 68, 'EndOffset': 76, 'TopAnswer': False }, { 'BeginOffset': 121, 'EndOffset': 129, 'TopAnswer': False } ], 'Text': '...LoggingandMonitoring\tMonitoring\n''\tCloudWatchMetricsforAmazonTextract\n''\tLoggingAmazonTextractAPICallswithAWSCloudTrail\n''\tAPIReference\tActions\tAnalyzeDocument\n''\tDetectDocumentText\n''\tGetDocumentAnalysis...' }, 'Type': 'DOCUMENT' }
Frage und Antwort
Eine Antwort mit Frage und Antwort wird zurückgegeben, wenn eine Frage mit einer der häufig gestellten Fragen in Ihrem Index Amazon Kendra übereinstimmt. Die Antwort enthält die passende Frage und Antwort in dem QueryResultItemFeld. Sie enthält auch Informationen zur Hervorhebung von Abfragebegriffen, die in der Abfragezeichenfolge erkannt wurden. Die folgende JSON-Datei zeigt eine Frage und eine Antwort. Beachten Sie, dass die Antwort den Fragetext enthält.
{ 'AnswerText': { 'TextWithHighlights': [ ], 'Text': '605feet' }, 'DocumentExcerpt': { 'Highlights': [ { 'BeginOffset': 0, 'EndOffset': 8, 'TopAnswer': False } ], 'Text': '605feet' }, 'Type': 'QUESTION_ANSWER', 'QuestionText': { 'Highlights': [ { 'BeginOffset': 12, 'EndOffset': 18, 'TopAnswer': False }, { 'BeginOffset': 26, 'EndOffset': 31, 'TopAnswer': False }, { 'BeginOffset': 32, 'EndOffset': 38, 'TopAnswer': False } ], 'Text': 'whatistheheightoftheSpaceNeedle?' } }
Informationen zum Hinzufügen von Frage- und Antworttext zu einem Index finden Sie unter Häufig gestellte Fragen erstellen.
