

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
<a name="query-responses-types"></a>

**Anmerkung**  
Die Funktionsunterstützung variiert je nach Indextyp und verwendeter Such-API. Informationen darüber, ob diese Funktion für den von Ihnen verwendeten Indextyp und die Such-API unterstützt wird, finden Sie unter [Indextypen](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index-types.html).

Amazon Kendra unterstützt verschiedene Abfrageantworten und Antworttypen.

## Antworten abfragen
<a name="query-responses"></a>

Ein Aufruf der [Query](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html) API gibt Informationen über die Ergebnisse einer Suche zurück. Die Ergebnisse befinden sich in einem Array von [QueryResultItem](https://docs.aws.amazon.com/kendra/latest/APIReference/API_QueryResultItem.html)Objekten (`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 unter[Antworten und Antworttypen abfragen](#query-responses-types).

**Dokumentattribute**  
Jedes Ergebnis enthält Dokumentattribute für das Dokument, das einer Abfrage entspricht. Einige der Attribute sind vordefiniert, z. B. `DocumentId``DocumentTitle`, und`DocumentUri`. 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](filtering.md). Sie geben Dokumentattribute an, wenn Sie Dokumente zu einem Index hinzufügen. Weitere Informationen finden Sie unter [Benutzerdefinierte Felder oder Attribute](https://docs.aws.amazon.com/kendra/latest/dg/custom-attributes.html).

Im Folgenden finden Sie einen JSON-Beispielcode für ein Abfrageergebnis. Notieren Sie sich die Dokumentattribute in `DocumentAttributes` und`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}}
}
```

## Arten von Antworten
<a name="response-types"></a>

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 [QueryResultItem](https://docs.aws.amazon.com/kendra/latest/APIReference/API_QueryResultItem.html)Objekts zurückgegeben.

### Antwort
<a name="query-answer"></a>

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, z. B. „*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. `AnswerText`enthä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
<a name="query-document"></a>

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](https://docs.aws.amazon.com/kendra/latest/APIReference/API_QueryResultItem.html). 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
<a name="query-question-answer"></a>

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 [QueryResultItem](https://docs.aws.amazon.com/kendra/latest/APIReference/API_QueryResultItem.html)Feld. 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](https://docs.aws.amazon.com/kendra/latest/dg/in-creating-faq.html).