Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Risposte alle interrogazioni e tipi di risposta
Amazon Kendra supporta diverse risposte alle interrogazioni e tipi di risposta.
Risposte alle interrogazioni
Una chiamata all'API Query restituisce informazioni sui risultati di una ricerca. I risultati si trovano in una serie di QueryResultItemoggetti (ResultItems). Ciascuno QueryResultItem include un riepilogo del risultato. Sono inclusi gli attributi del documento associati al risultato della query.
Informazioni di riepilogo
Le informazioni di riepilogo variano a seconda del tipo di risultato. In ogni caso, include il testo del documento che corrisponde al termine di ricerca. Include anche informazioni di evidenziazione che è possibile utilizzare per evidenziare il testo di ricerca nell'output dell'applicazione. Ad esempio, se il termine di ricerca è qual è l'altezza dello Space Needle? , le informazioni di riepilogo includono la posizione del testo per le parole height e space needle. Per informazioni sui tipi di risposta, vedereRisposte alle interrogazioni e tipi di risposta.
Attributi del documento
Ogni risultato contiene gli attributi del documento che corrisponde a una query. Alcuni attributi sono predefiniti, ad esempio DocumentIdDocumentTitle, eDocumentUri. Altri sono attributi personalizzati definiti dall'utente. È possibile utilizzare gli attributi del documento per filtrare la risposta dall'QueryAPI. Ad esempio, potresti volere solo i documenti scritti da un autore specifico o da una versione specifica di un documento. Per ulteriori informazioni, consulta Filtraggio e ricerca sfaccettata. Gli attributi del documento vengono specificati quando si aggiungono documenti a un indice. Per ulteriori informazioni, consulta Campi o attributi personalizzati.
Di seguito è riportato un esempio di codice JSON per il risultato di una query. Annotate gli attributi del documento in DocumentAttributes andAdditionalAttributes.
{ "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}
Tipi di risposta
Amazon Kendra restituisce tre tipi di risposta alla query.
-
Risposta (include la risposta alla tabella)
-
Documento
-
Domande e risposte
Il tipo di risposta viene restituito nel campo di Type risposta dell'QueryResultItemoggetto.
Risposta
Amazon Kendra ha rilevato una o più risposte alle domande nella risposta. Un dato di fatto è la risposta a una domanda su chi, cosa, quando o dove, ad esempio Dov'è il centro di assistenza più vicino a me? Amazon Kendra restituisce il testo dell'indice che meglio corrisponde alla query. Il testo si trova nel AnswerText campo e contiene informazioni di evidenziazione per il termine di ricerca all'interno del testo della risposta. AnswerTextinclude l'estratto completo del documento con testo evidenziato, mentre DocumentExcerpt include l'estratto del documento troncato (290 caratteri) con testo evidenziato.
Amazon Kendra restituisce solo una risposta per documento, ossia la risposta con la massima confidenza. Per restituire più risposte da un documento, è necessario suddividere il documento in più documenti.
{ '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' }
Documento
Amazon Kendra restituisce i documenti classificati per quelli che corrispondono al termine di ricerca. La classifica si basa sulla fiducia che si Amazon Kendra ha nell'accuratezza del risultato della ricerca. Le informazioni sul documento corrispondente vengono restituite in QueryResultItem. Include il titolo del documento. L'estratto include le informazioni di evidenziazione per il testo di ricerca e la sezione del testo corrispondente nel documento. L'URI per la corrispondenza dei documenti si trova nell'attributo SourceURI document. L'esempio JSON seguente mostra il riepilogo del documento per un documento corrispondente.
{ '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' }
Domande e risposte
Una risposta a domanda e risposta viene restituita quando una domanda Amazon Kendra corrisponde a una delle domande frequenti nell'indice. La risposta include la domanda e la risposta corrispondenti nel QueryResultItemcampo. Include anche informazioni di evidenziazione per i termini di query rilevati nella stringa di query. Il codice JSON seguente mostra una domanda e una risposta. Nota che la risposta include il testo della domanda.
{ '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?' } }
Per informazioni sull'aggiunta del testo di domande e risposte a un indice, vedi Creazione di domande frequenti.
