Amazon Kendra 不再開放給新客戶。對於類似 的功能 Amazon Kendra，探索 Amazon Bedrock 知識庫。進一步了解。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
查詢回應和回應類型
注意
功能支援會因索引類型和正在使用的搜尋 API 而有所不同。若要查看您正在使用的索引類型和搜尋 API 是否支援此功能，請參閱索引類型。
Amazon Kendra 支援不同的查詢回應和回應類型。
查詢回應
對查詢 API 的呼叫會傳回有關搜尋結果的資訊。結果位於 QueryResultItem 物件 () 的陣列中ResultItems。每個 都QueryResultItem包含結果的摘要。包含與查詢結果相關聯的文件屬性。
摘要資訊
摘要資訊會根據結果類型而有所不同。在每個案例中，都包含符合搜尋詞彙的文件文字。它還包含反白資訊，您可以用來反白應用程式輸出中的搜尋文字。例如，如果搜尋詞是 Space Needle 的高度？，則摘要資訊包含文字高度和空格針的文字位置。如需回應類型的資訊，請參閱 查詢回應和回應類型。
文件屬性
每個結果都包含符合查詢之文件的文件屬性。某些屬性是預先定義的，例如 DocumentId、 DocumentTitle和 DocumentUri。其他則是您定義的自訂屬性。您可以使用文件屬性來篩選來自 Query API 的回應。例如，您可能只想要特定作者撰寫的文件或特定版本的文件。如需詳細資訊，請參閱篩選和面向搜尋。將文件新增至索引時，您可以指定文件屬性。如需詳細資訊，請參閱自訂欄位或屬性。
以下是查詢結果的範例 JSON 程式碼。請注意 DocumentAttributes和 中的文件屬性AdditionalAttributes。
{ "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}
回應類型
Amazon Kendra 傳回三種類型的查詢回應。
-
答案 （包括資料表答案）
-
文件
-
問題和解答
回應的類型會在 QueryResultItem 物件的Type回應欄位中傳回。
答案
Amazon Kendra 在回應中偵測到一或多個問題答案。事實是回應誰、什麼、何時或哪裡的問題，例如我最接近的服務中心在哪裡？ Amazon Kendra 會傳回索引中最符合查詢的文字。文字在 AnswerText 欄位中，並包含回應文字中搜尋詞彙的反白資訊。 AnswerText包含具有反白文字的完整文件摘錄，而 DocumentExcerpt 包含具有反白文字的截斷 (290 個字元） 文件摘錄。
Amazon Kendra 每個文件只會傳回一個答案，而這是可信度最高的答案。若要從文件傳回多個答案，您必須將文件分割成多個文件。
{ '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' }
文件
Amazon Kendra 會針對符合搜尋詞彙的文件傳回排名文件。排名是根據對搜尋結果 Amazon Kendra 準確性的可信度。相符文件的相關資訊會在 QueryResultItem 中傳回。它包含文件的標題。摘錄包含搜尋文字的反白資訊，以及文件中相符文字的區段。相符文件的 URI 位於SourceURI文件屬性中。下列範例 JSON 顯示相符文件的文件摘要。
{ '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' }
問題和解答
當 Amazon Kendra 符合您索引中其中一個常見問題的問題時，會傳回問題和答案回應。回應包含 QueryResultItem 欄位中的相符問題和答案。它還包含查詢字串中偵測到的查詢詞彙反白資訊。下列 JSON 顯示問題和答案回應。請注意，回應包含問題文字。
{ '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?' } }
如需將問題和答案文字新增至索引的詳細資訊，請參閱建立常見問答集。
