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.
# Bereitstellen Amazon Kendra
**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).
Wenn es an der Zeit ist, die Amazon Kendra Suche auf Ihrer Website bereitzustellen, stellen wir Quellcode zur Verfügung, den Sie mit React verwenden können, um Ihrer Anwendung einen Vorsprung zu verschaffen. Der Quellcode wird kostenlos unter einer modifizierten MIT-Lizenz bereitgestellt. Sie können ihn unverändert verwenden oder für Ihre eigenen Bedürfnisse ändern. Die mitgelieferte React-App ist ein Beispiel, das Ihnen den Einstieg erleichtern soll. Es ist keine produktionsreife App.
Informationen zum Bereitstellen einer Suchanwendung ohne Code und zum Generieren einer Endpunkt-URL zu Ihrer Suchseite mit Zugriffskontrolle finden Sie unter [Amazon Kendra Experience Builder](https://docs.aws.amazon.com/kendra/latest/dg/deploying-search-experience-no-code.html).
Der folgende Beispielcode fügt einer vorhandenen React-Webanwendung eine Amazon Kendra Suche hinzu:
+ [https://kendrasamples.s3.amazonaws.com/kendrasamples-react-app.zip](https://kendrasamples.s3.amazonaws.com/kendrasamples-react-app.zip) — Beispieldateien, mit denen Entwickler ein funktionales Sucherlebnis in ihre bestehende React-Webanwendung integrieren können.
Die Beispiele sind der Suchseite der Konsole nachempfunden. Amazon Kendra Sie haben dieselben Funktionen für die Suche und Anzeige von Suchergebnissen. Sie können das gesamte Beispiel verwenden oder nur eine der Funktionen für Ihren eigenen Gebrauch auswählen.
Um die drei Komponenten der Suchseite in der Amazon Kendra Konsole zu sehen, wählen Sie im rechten Menü das Codesymbol (****). Bewegen Sie den Mauszeiger über die einzelnen Abschnitte, um eine kurze Beschreibung der Komponente und die URL der Quelle der Komponente anzuzeigen.
**Topics**
+ [
## -Übersicht
](#example-overview)
+ [
## Voraussetzungen
](#example-prereqs)
+ [
## Das Beispiel einrichten
](#example-install)
+ [
## Haupt-Suchseite
](#main-component)
+ [
## Suchkomponente
](#search-component)
+ [
## Komponente „Ergebnisse“
](#results-component)
+ [
## Facetten-Komponente
](#facets-component)
+ [
## Komponente „Paginierung“
](#pagination-component)
+ [
# Aufbau eines Sucherlebnisses ohne Code
](deploying-search-experience-no-code.md)
## -Übersicht
Sie fügen den Beispielcode zu einer vorhandenen React-Webanwendung hinzu, um die Suche zu aktivieren. Der Beispielcode enthält eine Readme-Datei mit Schritten zum Einrichten einer neuen React-Entwicklungsumgebung. Die Beispieldaten im Codebeispiel können verwendet werden, um eine Suche zu demonstrieren. Die Suchdateien und Komponenten im Beispielcode sind wie folgt strukturiert:
+ Hauptsuchseite (`Search.tsx`) — Dies ist die Hauptseite, die alle Komponenten enthält. Hier integrieren Sie Ihre Anwendung in die Amazon Kendra API.
+ Suchleiste — Dies ist die Komponente, in der ein Benutzer einen Suchbegriff eingibt und die Suchfunktion aufruft.
+ Ergebnisse — Dies ist die Komponente, von der die Ergebnisse angezeigt werden. Amazon Kendra Sie besteht aus drei Komponenten: Antwortvorschläge, FAQ-Ergebnisse und empfohlene Dokumente.
+ Facetten — Dies ist die Komponente, die die Facetten in den Suchergebnissen anzeigt und es Ihnen ermöglicht, eine Facette auszuwählen, um die Suche einzugrenzen.
+ Paginierung — Dies ist die Komponente, die die Antwort paginiert. Amazon Kendra
## Voraussetzungen
Bevor Sie beginnen, muss Folgendes sichergestellt sein:
+ [Node.js und npm sind installiert.](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) Node.js Version 19 oder älter ist erforderlich.
+ Python 3 oder Python 2 [heruntergeladen und installiert](https://www.python.org/downloads/).
+ [SDK für Java](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/setup.html)oder [AWS SDK für JavaScript](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/welcome.html)um API-Aufrufe zu tätigen Amazon Kendra.
+ Eine bestehende React-Webanwendung. Der Beispielcode enthält eine Readme-Datei mit Schritten zum Einrichten einer neuen React-Entwicklungsumgebung, einschließlich der Verwendung der erforderlichen Frameworks/Bibliotheken. Sie können auch den Schnellstartanweisungen in der [React-Dokumentation zur Erstellung einer React-Web-App](https://create-react-app.dev/docs/getting-started) folgen.
+ Die erforderlichen Bibliotheken und Abhängigkeiten sind in Ihrer Entwicklungsumgebung konfiguriert. Der Beispielcode enthält eine Readme-Datei, in der die erforderlichen Bibliotheken und Paketabhängigkeiten aufgeführt sind. Beachten Sie, dass dies erforderlich `sass` ist, da `node-sass` es veraltet ist. Wenn Sie es zuvor installiert haben`node-sass`, deinstallieren Sie es und installieren Sie es. `sass`
## Das Beispiel einrichten
Ein vollständiges Verfahren zum Hinzufügen einer Amazon Kendra Suche zu einer React-Anwendung finden Sie in der Readme-Datei, die im Codebeispiel enthalten ist.
**Um mit der Verwendung kendrasamples-react-app von .zip zu beginnen**
1. Stellen Sie sicher, dass Sie den Vorgang abgeschlossen haben[Voraussetzungen](#example-prereqs), einschließlich des Herunterladens und der Installation von Node.js und npm.
1. Laden Sie kendrasamples-react-app .zip herunter und entpacken Sie es.
1. Öffne dein Terminal und gehe zu. `aws-kendra-example-react-app/src/services/` Öffnen Sie `local-dev-credentials.json` und geben Sie Ihre Anmeldeinformationen ein. Fügen Sie diese Datei keinem öffentlichen Repository hinzu.
1. Gehen Sie zu `aws-kendra-example-react-app` und installieren Sie die Abhängigkeiten in`package.json`. Führen Sie `npm install`.
1. Starten Sie eine Demoversion Ihrer App auf Ihrem lokalen Server. Führen Sie `npm start`. Sie können den lokalen Server beenden, indem Sie die Eingabe auf Ihrer Tastatur vornehmen`Cmd/Ctrl + C`.
1. Sie können den Port oder den Host (z. B. die IP-Adresse) ändern, indem Sie zu Host `package.json` und Port: gehen und dort aktualisieren`"start": "HOST=[host] PORT=[port] react-scripts start"`. Wenn Sie Windows verwenden:`"start": "set HOST=[host] && set PORT=[port] && react-scripts start"`.
1. Wenn Sie eine registrierte Website-Domain haben, können Sie diese `package.json` hinter Ihrem App-Namen angeben. Beispiel, `"homepage": "https://mywebsite.com"`. Sie müssen `npm install` erneut ausführen, um neue Abhängigkeiten zu aktualisieren, und dann ausführen`npm start`.
1. Führen Sie den Befehl aus, um die App zu erstellen`npm build`. Laden Sie den Inhalt des Build-Verzeichnisses auf Ihren Hosting-Anbieter hoch.
**Warnung**
Die React-App ist **nicht** produktionsbereit. Es ist ein Beispiel für die Bereitstellung einer App für die Amazon Kendra Suche.
## Haupt-Suchseite
Die Hauptsuchseite (`Search.tsx`) enthält alle Beispiel-Suchkomponenten. Sie umfasst die Suchleistenkomponente für die Ausgabe, die Ergebniskomponenten zur Anzeige der Antwort aus der [Abfrage-API](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html) und eine Seitennummerierungskomponente zum Durchblättern der Antwort.
## Suchkomponente
Die Suchkomponente bietet ein Textfeld zur Eingabe von Abfragetext. Die `onSearch` Funktion ist ein Hook, der die Hauptfunktion aufruft`Search.tsx`, um den Amazon Kendra [Abfrage-API-Aufruf](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html) durchzuführen.
## Komponente „Ergebnisse“
Die Ergebniskomponente zeigt die Antwort der `Query` API. Die Ergebnisse werden in drei separaten Bereichen angezeigt.
+ Vorgeschlagene Antworten — Dies sind die besten Ergebnisse, die von der API zurückgegeben wurden. `Query` Sie enthält bis zu drei Antwortvorschläge. In der Antwort haben sie den Ergebnistyp`ANSWER`.
+ Antworten auf häufig gestellte Fragen — Dies sind die Ergebnisse mit häufig gestellten Fragen, die in der Antwort zurückgegeben wurden. FAQs werden dem Index separat hinzugefügt. In der Antwort haben sie den Typ`QUESTION_ANSWER`. Weitere Informationen finden Sie unter [Fragen und Antworten](https://docs.aws.amazon.com/kendra/latest/dg/in-creating-faq.html).
+ Empfohlene Dokumente — Dies sind zusätzliche Dokumente, die in der Amazon Kendra Antwort zurückgegeben werden. In der Antwort von der `Query` API haben sie den Typ. `DOCUMENT`
Die Ergebniskomponenten teilen sich eine Reihe von Komponenten für Funktionen wie Hervorhebungen, Titel, Links und mehr. Die gemeinsam genutzten Komponenten müssen vorhanden sein, damit die Ergebniskomponenten funktionieren.
## Facetten-Komponente
Die Facetten-Komponente listet die Facetten auf, die in den Suchergebnissen verfügbar sind. Jede Facette klassifiziert die Antwort nach einer bestimmten Dimension, z. B. nach dem Autor. Sie können die Suche auf eine bestimmte Facette eingrenzen, indem Sie eine Facette aus der Liste auswählen.
Nachdem Sie eine Facette ausgewählt haben, wird die Komponente `Query` mit einem Attributfilter aufgerufen, der die Suche auf Dokumente beschränkt, die der Facette entsprechen.
## Komponente „Paginierung“
Mit der Paginierungskomponente können Sie die Suchergebnisse der `Query` API auf mehreren Seiten anzeigen. Sie ruft die `Query` API mit den `PageNumber` Parametern `PageSize` und auf, um eine bestimmte Ergebnisseite abzurufen.
# Aufbau eines Sucherlebnisses ohne Code
Sie können eine Amazon Kendra Suchanwendung erstellen und bereitstellen, ohne dass Frontend-Code erforderlich ist. Amazon Kendra Mit *Experience Builder* können Sie mit wenigen Klicks eine voll funktionsfähige Suchanwendung erstellen und bereitstellen, sodass Sie sofort mit der Suche beginnen können. Sie können Ihre Suchseite individuell gestalten und Ihre Suche optimieren, um das Erlebnis an die Bedürfnisse Ihrer Benutzer anzupassen. Amazon Kendra generiert eine eindeutige, vollständig gehostete Endpunkt-URL Ihrer Suchseite, um mit der Suche in Ihren Dokumenten zu beginnen und FAQs. Sie können schnell einen Machbarkeitsnachweis für Ihr Sucherlebnis erstellen und ihn mit anderen teilen.
Sie verwenden die im Builder verfügbare Vorlage für Sucherlebnisse, um Ihre Suche anzupassen. Sie können andere einladen, gemeinsam an der Gestaltung Ihres Sucherlebnisses zu arbeiten, oder die Suchergebnisse zu Optimierungszwecken auswerten. Sobald Ihr Sucherlebnis bereit ist, damit Ihre Benutzer mit der Suche beginnen können, geben Sie einfach die URL des sicheren Endpunkts weiter.
## So funktioniert der Experience Builder für die Suche
Der Gesamtprozess beim Aufbau eines Sucherlebnisses sieht wie folgt aus:
1. Sie erstellen Ihr Sucherlebnis, indem Sie ihm einen Namen und eine Beschreibung geben und Ihre Datenquellen auswählen, die Sie für Ihr Sucherlebnis verwenden möchten.
1. Sie konfigurieren Ihre Liste von Benutzern und Gruppen in AWS IAM Identity Center und weisen ihnen dann Zugriffsrechte für Ihr Sucherlebnis zu. Sie schließen sich selbst als Eigentümer des Erlebnisses ein. Weitere Informationen finden Sie unter [Bereitstellung des Zugriffs auf Ihre Suchseite](#access-search-experience).
1. Sie öffnen den Amazon Kendra Experience Builder, um Ihre Suchseite zu entwerfen und zu optimieren. Sie können Ihre Endpunkt-URL Ihres Sucherlebnisses mit anderen teilen, denen Sie eigene Zugriffsrechte zur Bearbeitung oder Zugriffsrechte zum Anzeigen von Suchanfragen zuweisen.
Sie rufen die [CreateExperience](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateExperience.html)API auf, um Ihr Sucherlebnis zu erstellen und zu konfigurieren. Wenn Sie die Konsole verwenden, wählen Sie Ihren Index und dann im Navigationsmenü **Erlebnisse** aus, um Ihr Erlebnis zu konfigurieren.
## Gestalte und optimiere dein Sucherlebnis
Nachdem Sie Ihr Sucherlebnis erstellt und konfiguriert haben, öffnen Sie das Sucherlebnis mithilfe einer Endpunkt-URL, um als Eigentümer mit Editor-Zugriffsrechten mit der Anpassung Ihrer Suche zu beginnen. Sie geben Ihre Suchanfrage in das Suchfeld ein und passen dann Ihre Suche mithilfe der Bearbeitungsoptionen im Seitenbereich an, um zu sehen, wie sie auf Ihre Seite zutreffen. Wenn Sie zur Veröffentlichung bereit sind, wählen Sie **Veröffentlichen** aus. Sie können auch zwischen **Zur Live-Ansicht wechseln, um** die neueste veröffentlichte Version Ihrer Suchseite anzuzeigen, und In den **Build-Modus wechseln, um** Ihre Suchseite zu bearbeiten oder anzupassen, wechseln.
Im Folgenden finden Sie Möglichkeiten, wie Sie Ihr Sucherlebnis anpassen können.
### Filter
Fügen Sie eine facettierte Suche hinzu oder filtern Sie nach Dokumentattributen. Dies schließt benutzerdefinierte Attribute ein. Sie können mithilfe Ihrer eigenen konfigurierten Metadatenfelder einen Filter hinzufügen. Verwenden Sie beispielsweise für die Facettensuche nach jeder Stadtkategorie ein `_category` benutzerdefiniertes Dokumentattribut, das alle Stadtkategorien enthält.
### Vorgeschlagene Antwort
Fügen Sie durch maschinelles Lernen generierte Antworten auf die Fragen Ihrer Benutzer hinzu. Zum Beispiel*: „Wie schwierig ist dieser Kurs?“* . Amazon Kendra kann aus allen Dokumenten, die sich auf den Schwierigkeitsgrad eines Kurses beziehen, den relevantesten Text abrufen und die relevanteste Antwort vorschlagen.
### Häufig gestellte Fragen
Fügen Sie ein FAQ-Dokument hinzu, um Antworten auf häufig gestellte Fragen zu geben. Zum Beispiel*: „Wie viele Stunden müssen Sie diesen Kurs abschließen?“* . Amazon Kendra kann das FAQ-Dokument mit der Antwort auf diese Frage verwenden und die richtige Antwort geben.
### Sortierung
Fügen Sie eine Sortierung der Suchergebnisse hinzu, sodass Ihre Benutzer die Ergebnisse nach Relevanz, Erstellungszeit, Uhrzeit der letzten Aktualisierung und anderen Sortierkriterien organisieren können.
### Dokumente
Konfigurieren Sie, wie Dokumente oder Suchergebnisse auf Ihrer Suchseite angezeigt werden. Sie können konfigurieren, wie viele Ergebnisse auf der Seite angezeigt werden, Seitennummerierung wie Seitenzahlen einbeziehen, eine Schaltfläche für Benutzerfeedback aktivieren und festlegen, wie Metadatenfelder von Dokumenten in Suchergebnissen angezeigt werden.
### Sprache
Wählen Sie eine Sprache aus, um die Suchergebnisse oder Dokumente in der ausgewählten Sprache zu filtern.
### Suchfeld
Konfigurieren Sie die Größe und den Platzhaltertext Ihres Suchfeldes und lassen Sie Abfragevorschläge zu.
### Optimierung der Relevanz
Fügen Sie den Metadatenfeldern von Dokumenten Boosting hinzu, um diesen Feldern mehr Gewicht zu verleihen, wenn Ihre Benutzer nach Dokumenten suchen. Sie können eine Gewichtung hinzufügen, die bei 1 beginnt und schrittweise auf 10 steigt. Sie können die Feldtypen Text, Datum und Zahl erhöhen. Um beispielsweise Feldern `_created_at` mehr Gewicht oder Wichtigkeit als anderen Feldern zu geben, geben Sie diesen Feldern je nach Wichtigkeit eine Gewichtung von 1 bis 10. `_last_updated_at` Sie können für jede Suchanwendung oder jedes Erlebnis unterschiedliche Konfigurationen zur Relevanzoptimierung anwenden.
## Bereitstellung des Zugriffs auf Ihre Suchseite
Der Zugriff auf Ihr Sucherlebnis erfolgt über das IAM Identity Center. Wenn Sie Ihr Sucherlebnis konfigurieren, gewähren Sie anderen Personen, die in Ihrem Identity Center-Verzeichnis aufgeführt sind, Zugriff auf Ihre Amazon Kendra Suchseite. Sie erhalten eine E-Mail, in der sie aufgefordert werden, sich mit ihren Anmeldeinformationen im IAM Identity Center anzumelden, um auf die Suchseite zuzugreifen. Sie müssen IAM Identity Center auf Organisations- oder Kontoinhaberebene in einrichten. AWS Organizations Weitere Informationen zur Einrichtung von IAM Identity Center finden Sie unter [Erste Schritte mit IAM](https://docs.aws.amazon.com/kendra/latest/dg/getting-started-aws-sso.html) Identity Center.
Sie aktivieren Benutzeridentitäten in IAM Identity Center mit Ihrer Sucherfahrung und weisen mithilfe der API oder der Konsole Zugriffsberechtigungen für *Zuschauer* oder *Besitzer* zu.
+ **Zuschauer**: Erlaubt es, Anfragen zu stellen, Antwortvorschläge zu erhalten, die für ihre Suche relevant sind, und ihr Feedback dazu beizutragen, Amazon Kendra damit die Suche weiter verbessert wird.
+ **Besitzer**: Erlaubt, das Design der Suchseite anzupassen, die Suche zu optimieren und die Suchanwendung als *Viewer* zu verwenden. Das Deaktivieren des Zugriffs auf Viewer in der Konsole wird derzeit nicht unterstützt.
Um anderen Personen Zugriff auf Ihr Sucherlebnis zuzuweisen, aktivieren Sie zunächst Benutzeridentitäten in IAM Identity Center mit Ihrem Amazon Kendra Erlebnis, indem Sie das Objekt verwenden. [ExperienceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ExperienceConfiguration.html) Sie geben den Feldnamen an, der die Kennungen Ihrer Benutzer enthält, z. B. den Benutzernamen oder die E-Mail-Adresse. Anschließend gewähren Sie Ihrer Benutzerliste mithilfe der [AssociateEntitiesToExperience](https://docs.aws.amazon.com/kendra/latest/APIReference/API_AssociateEntitiesToExperience.html)API Zugriff auf Ihr Sucherlebnis und definieren deren Berechtigungen als *Betrachter* oder *Eigentümer* mithilfe der [AssociatePersonasToEntities](https://docs.aws.amazon.com/kendra/latest/APIReference/API_AssociatePersonasToEntities.html)API. Sie geben jeden Benutzer oder jede Gruppe an, die das [EntityConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_EntityConfiguration.html)Objekt verwenden, und geben an, ob es sich bei diesem Benutzer oder dieser Gruppe um einen *Betrachter* oder *Eigentümer* handelt, der das [EntityPersonaConfiguraton](https://docs.aws.amazon.com/kendra/latest/APIReference/API_EntityPersonaConfiguration.html)Objekt verwendet.
Um anderen Personen mithilfe der Konsole Zugriff auf Ihr Sucherlebnis zu gewähren, müssen Sie zunächst ein Erlebnis erstellen und Ihre Identität sowie die Tatsache, dass Sie der Eigentümer sind, bestätigen. Anschließend können Sie andere Benutzer oder Gruppen als Zuschauer oder Eigentümer zuweisen. Wählen Sie in der Konsole Ihren Index und dann im Navigationsmenü **Erlebnisse** aus. Nachdem Sie Ihr Erlebnis erstellt haben, können Sie es aus der Liste auswählen. Gehen Sie zur **Zugriffsverwaltung**, um Benutzer oder Gruppen als Zuschauer oder Eigentümer zuzuweisen.
## Konfiguration eines Sucherlebnisses
Im Folgenden finden Sie ein Beispiel für die Konfiguration oder Erstellung eines Sucherlebnisses.
------
#### [ Console ]
**Um ein Amazon Kendra Sucherlebnis zu erstellen**
1. Wählen Sie im linken Navigationsbereich unter **Indizes** die Option **Erlebnisse** und dann **Erlebnis erstellen** aus.
1. Geben Sie auf der Seite „**Erlebnis konfigurieren**“ einen Namen und eine Beschreibung für Ihr Erlebnis ein, wählen Sie Ihre Inhaltsquellen und wählen Sie die IAM-Rolle für Ihr Erlebnis aus. Weitere Informationen zu IAM-Rollen finden Sie unter [IAM-Rollen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html) für Erlebnisse. Amazon Kendra
1. Wählen Sie auf der Seite **Bestätigen Sie Ihre Identität anhand eines Identity Center-Verzeichnisses** Ihre Benutzer-ID aus, z. B. Ihre E-Mail-Adresse. Wenn Sie kein Identity Center-Verzeichnis haben, geben Sie einfach Ihren vollständigen Namen und Ihre E-Mail-Adresse ein, um ein Identity Center-Verzeichnis zu erstellen. Dies schließt Sie als Benutzer des Erlebnisses mit ein und weist Ihnen automatisch Eigentümerzugriffsrechte zu.
1. Überprüfen Sie auf der Seite **Überprüfen, um Experience Builder zu öffnen**, Ihre Konfigurationsdetails und wählen Sie **Erlebnis erstellen aus und öffnen Sie Experience Builder**, um mit der Bearbeitung Ihrer Suchseite zu beginnen.
------
#### [ CLI ]
**Um ein Amazon Kendra Erlebnis zu erstellen**
```
aws kendra create-experience \
--name experience-name \
--description "experience description" \
--index-id index-id \
--role-arn arn:aws:iam::account-id:role/role-name \
--configuration '{"ExperienceConfiguration":[{"ContentSourceConfiguration":{"DataSourceIds":["data-source-1","data-source-2"]}, "UserIdentityConfiguration":"identity attribute name"}]}'
aws kendra describe-experience \
--endpoints experience-endpoint-URL(s)
```
------
#### [ Python ]
**Um ein Amazon Kendra Erlebnis zu schaffen**
```
import boto3
from botocore.exceptions import ClientError
import pprint
import time
kendra = boto3.client("kendra")
print("Create an experience.")
# Provide a name for the experience
name = "experience-name"
# Provide an optional description for the experience
description = "experience description"
# Provide the index ID for the experience
index_id = "index-id"
# Provide the IAM role ARN required for Amazon Kendra experiences
role_arn = "arn:aws:iam::${account-id}:role/${role-name}"
# Configure the experience
configuration = {"ExperienceConfiguration":
[{
"ContentSourceConfiguration":{"DataSourceIds":["data-source-1","data-source-2"]},
"UserIdentityConfiguration":"identity attribute name"
}]
}
try:
experience_response = kendra.create_experience(
Name = name,
Description = description,
IndexId = index_id,
RoleArn = role_arn,
Configuration = configuration
)
pprint.pprint(experience_response)
experience_endpoints = experience_response["Endpoints"]
print("Wait for Amazon Kendra to create the experience.")
while True:
# Get the details of the experience, such as the status
experience_description = kendra.describe_experience(
Endpoints = experience_endpoints
)
status = experience_description["Status"]
print(" Creating experience. Status: "+status)
time.sleep(60)
if status != "CREATING":
break
except ClientError as e:
print("%s" % e)
print("Program ends.")
```
------
#### [ Java ]
**Um ein zu erstellen Amazon Kendra**
```
package com.amazonaws.kendra;
import java.util.concurrent.TimeUnit;
import software.amazon.awssdk.services.kendra.KendraClient;
import software.amazon.awssdk.services.kendra.model.CreateExperienceRequest;
import software.amazon.awssdk.services.kendra.model.CreateExperienceResponse;
import software.amazon.awssdk.services.kendra.model.DescribeExperienceRequest;
import software.amazon.awssdk.services.kendra.model.DescribeExperienceResponse;
import software.amazon.awssdk.services.kendra.model.ExperienceStatus;
public class CreateExperienceExample {
public static void main(String[] args) throws InterruptedException {
System.out.println("Create an experience");
String experienceName = "experience-name";
String experienceDescription = "experience description";
String indexId = "index-id";
String experienceRoleArn = "arn:aws:iam::account-id:role/role-name";
KendraClient kendra = KendraClient.builder().build();
CreateExperienceRequest createExperienceRequest = CreateExperienceRequest
.builder()
.name(experienceName)
.description(experienceDescription)
.roleArn(experienceRoleArn)
.configuration(
ExperienceConfiguration
.builder()
.contentSourceConfiguration(
ContentSourceConfiguration(
.builder()
.dataSourceIds("data-source-1","data-source-2")
.build()
)
)
.userIdentityConfiguration(
UserIdentityConfiguration(
.builder()
.identityAttributeName("identity-attribute-name")
.build()
)
).build()
).build();
CreateExperienceResponse createExperienceResponse = kendra.createExperience(createExperienceRequest);
System.out.println(String.format("Experience response %s", createExperienceResponse));
String experienceEndpoints = createExperienceResponse.endpoints();
System.out.println(String.format("Wait for Kendra to create the experience.", experienceEndpoints));
while (true) {
DescribeExperienceRequest describeExperienceRequest = DescribeExperienceRequest.builder().endpoints(experienceEndpoints).build();
DescribeExperienceResponse describeEpxerienceResponse = kendra.describeExperience(describeExperienceRequest);
ExperienceStatus status = describeExperienceResponse.status();
TimeUnit.SECONDS.sleep(60);
if (status != ExperienceStatus.CREATING) {
break;
}
}
System.out.println("Experience creation is complete.");
}
}
```
------