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.
Slack
Slack ist eine Kommunikations-App für Unternehmen, mit der Benutzer Nachrichten und Anhänge über verschiedene öffentliche und private Kanäle senden können. Du kannst Amazon Kendra damit deine öffentlichen und privaten Slack-Kanäle, Bot- und Archivierungsnachrichten, Dateien und Anhänge, Direkt- und Gruppennachrichten indizieren. Du kannst auch bestimmte Inhalte zum Filtern auswählen.
Anmerkung
Amazon Kendra unterstützt jetzt einen aktualisierten Slack-Connector.
Die Konsole wurde automatisch für dich aktualisiert. Alle neuen Konnektoren, die Sie in der Konsole erstellen, verwenden die aktualisierte Architektur. Wenn Sie die API verwenden, müssen Sie jetzt die TemplateConfigurationObjekt anstelle des SlackConfiguration
Objekts zur Konfiguration Ihres Connectors.
Konnektoren, die mit der älteren Konsolen- und API-Architektur konfiguriert wurden, funktionieren weiterhin wie konfiguriert. Sie können sie jedoch nicht bearbeiten oder aktualisieren. Wenn Sie Ihre Connectorkonfiguration bearbeiten oder aktualisieren möchten, müssen Sie einen neuen Connector erstellen.
Wir empfehlen, Ihren Connector-Workflow auf die aktualisierte Version zu migrieren. Die Support für Konnektoren, die mit der älteren Architektur konfiguriert wurden, soll bis Juni 2024 eingestellt werden.
Du kannst über Amazon Kendra die Amazon Kendra Konsole
Informationen zur Fehlerbehebung bei deinem Amazon Kendra Slack-Datenquellen-Connector findest du unter. Problembehandlung bei Datenquellen
Unterstützte Features
Amazon Kendra Der Datenquellen-Connector von Slack unterstützt die folgenden Funktionen:
-
Feldzuordnungen
-
Steuerung des Benutzerzugriffs
-
Einschluss-/Ausschlussfilter
-
Vollständige und inkrementelle Inhaltssynchronisierung
-
Virtual Private Cloud (VPC)
Voraussetzungen
Bevor du deine Slack-Datenquelle Amazon Kendra zum Indizieren verwenden kannst, nimm diese Änderungen in deinem Slack und deinen Accounts vor. AWS
Stelle in Slack sicher, dass du:
-
Du hast ein OAuth Slack-Bot-Benutzertoken oder ein Slack-Benutzertoken konfiguriert. OAuth Du kannst eines der beiden Tokens wählen, um eine Verbindung Amazon Kendra zu deiner Slack-Datenquelle herzustellen. Ein Token ist erforderlich, um es als deine Authentifizierungsdaten zu verwenden. Weitere Informationen findest du in der Slack-Dokumentation zu Zugriffstoken
. Anmerkung
Wenn du das Bot-Token als Teil deiner Slack-Zugangsdaten verwendest, kannst du Direktnachrichten und Gruppennachrichten nicht indizieren und du musst das Bot-Token zu dem Channel hinzufügen, den du indexieren möchtest.
Anmerkung
Wir empfehlen dir, deine Zugangsdaten und dein Geheimnis regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die Zugriffsebene bereit, die erforderlich ist. Wir raten davon ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
-
Du hast deine Slack-Workspace-Team-ID aus der URL deiner Slack-Workspace-Hauptseite notiert.
https://app.slack.com/client/T0123456789/...
WoT0123456789
ist zum Beispiel die Team-ID. -
Die folgenden Oauth-Bereiche/Berechtigungen wurden hinzugefügt:
Geltungsbereich des Benutzer-Tokens Geltungsbereich des Bot-Tokens -
Kanäle: Geschichte
-
Kanäle:lesen
-
Emoji: lesen
-
Dateien:lesen
-
Gruppen:Verlauf
-
Gruppen:lesen
-
Ich bin: Geschichte
-
Ich: lese
-
mpim: Geschichte
-
mpim:lesen
-
team:lesen
-
users.profil:lesen
-
Benutzer:lesen
-
Benutzer:read.email
-
Kanäle:Verlauf
-
Kanäle:verwalten
-
Kanäle:lesen
-
conversations.connect:verwalten
-
conversations.connect:lesen
-
Dateien:lesen
-
Gruppen:Verlauf
-
Gruppen:lesen
-
Ich bin: Geschichte
-
Ich: lese
-
mpim: Geschichte
-
mpim:lesen
-
Reaktionen:lesen
-
team:lesen
-
Benutzergruppen: lesen
-
users.profil:lesen
-
Benutzer:lesen
-
Benutzer:read.email
-
-
Aktiviert, dass jedes Dokument in Slack und in anderen Datenquellen, die du für denselben Index verwenden möchtest, einzigartig ist. Jede Datenquelle, die du für einen Index verwenden möchtest, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
Stellen Sie in Ihrem sicher AWS-Konto, dass Sie Folgendes haben:
-
Hat einen Amazon Kendra Index erstellt und bei Verwendung der API die Index-ID notiert.
-
Sie haben eine IAM Rolle für Ihre Datenquelle erstellt und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.
Anmerkung
Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.
-
Du hast deine Slack-Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls du die API verwendest, den ARN des Geheimnisses notiert.
Anmerkung
Wir empfehlen dir, deine Zugangsdaten und dein Geheimnis regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die Zugriffsebene bereit, die erforderlich ist. Wir raten davon ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
Wenn du noch keine IAM Rolle oder keinen Schlüssel hast, kannst du die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn du deine Slack-Datenquelle mit verbindest. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.
Anweisungen zur Verbindung
Um eine Verbindung Amazon Kendra zu deiner Slack-Datenquelle herzustellen, musst du die erforderlichen Details zu deiner Slack-Datenquelle angeben, damit du auf deine Daten zugreifen Amazon Kendra kannst. Falls du Slack noch nicht für Amazon Kendra konfiguriert hast, findest du weitere Informationen unter. Voraussetzungen
Um eine Verbindung zu Amazon Kendra Slack herzustellen
-
Melde dich bei der an AWS Management Console und öffne die Amazon Kendra Konsole
. -
Wählen Sie im linken Navigationsbereich Indizes und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.
Anmerkung
Sie können Ihre Einstellungen für die Benutzerzugriffskontrolle unter Indexeinstellungen konfigurieren oder bearbeiten.
-
Wählen Sie auf der Seite Erste Schritte die Option Datenquelle hinzufügen aus.
-
Wähle auf der Seite Datenquelle hinzufügen die Option Slack-Konnektor und dann Konnektor hinzufügen aus. Wenn du Version 2 verwendest (falls zutreffend), wähle den Slack-Connector mit dem Tag „V2.0".
-
Gib auf der Seite „Datenquellendetails angeben“ die folgenden Informationen ein:
-
Geben Sie im Feld Name und Beschreibung für Datenquellenname einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.
-
(Optional) Beschreibung — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
-
In Standardsprache — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.
-
Unter Tags für Neues Tag hinzufügen — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS
-
Wählen Sie Weiter.
-
-
Geben Sie auf der Seite Zugriff und Sicherheit definieren die folgenden Informationen ein:
-
Für Slack-Workspace-Team-ID — Die Team-ID deines Slack-Workspace. Du findest deine Team-ID in der URL der Hauptseite deines Slack-Workspace.
https://app.slack.com/client/T0123456789/...
WoT0123456789
ist zum Beispiel die Team-ID. -
Autorisierung — Aktivieren oder deaktivieren Sie die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter Benutzerkontextfilterung.
-
AWS Secrets Manager geheim — Wähle ein vorhandenes Geheimnis oder erstelle ein neues Secrets Manager Geheimnis, um deine Slack-Authentifizierungsdaten zu speichern. Wenn du dich dafür entscheidest, ein neues Geheimnis zu erstellen, öffnet sich ein AWS Secrets Manager geheimes Fenster.
-
Geben Sie die folgenden Informationen in das Fenster Create an AWS Secrets Manager Secret ein:
-
Geheimer Name — Ein Name für Ihr Geheimnis. Das Präfix 'AmazonKendra-Slack-' wird deinem geheimen Namen automatisch hinzugefügt.
-
Für Slack-Token — Gib die Werte für die Authentifizierungsdaten ein, die du für Slack konfiguriert hast.
-
-
Speichere dein Geheimnis und füge es hinzu.
-
-
Virtual Private Cloud (VPC) — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie Subnetze und VPC-Sicherheitsgruppen hinzufügen.
-
Identity Crawler — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die Benutzerkontextfilterung von Suchergebnissen zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn Identity Crawler ausgeschaltet ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die PutPrincipalMappingAPI verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
-
IAM Rolle — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
Anmerkung
IAM Rollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie Neue Rolle erstellen, um Fehler zu vermeiden.
-
Wählen Sie Weiter.
-
-
Geben Sie auf der Seite „Synchronisierungseinstellungen konfigurieren“ die folgenden Informationen ein:
-
Inhaltstyp auswählen — Wähle die Slack-Entitäten oder Inhaltstypen aus, die du crawlen möchtest. Du kannst aus allen Kanälen, öffentlichen Channels, privaten Channels, Gruppennachrichten und privaten Nachrichten wählen.
-
Startdatum für das Crawlen auswählen — Gib das Datum ein, an dem du mit dem Crawlen deiner Inhalte beginnen möchtest.
-
Für zusätzliche Konfigurationen: Wählen Sie aus, ob Bot-Nachrichten und archivierte Nachrichten eingeschlossen werden sollen, und verwenden Sie Muster mit regulären Ausdrücken, um bestimmte Inhalte ein- oder auszuschließen.
Anmerkung
Wenn du dich dafür entscheidest, sowohl Kanal IDs - als auch Kanalnamen einzubeziehen, priorisiert der Amazon Kendra Slack-Connector die Kanäle vor IDs den Kanalnamen.
Wenn du dich dafür entschieden hast, bestimmte private Nachrichten und Gruppennachrichten einzubeziehen, ignoriert der Amazon Kendra Slack-Connector alle privaten Nachrichten und Gruppennachrichten und crawlt nur die von dir angegebenen privaten Nachrichten und Gruppennachrichten.
-
Synchronisierungsmodus — Wähle aus, wie du deinen Index aktualisieren möchtest, wenn sich der Inhalt deiner Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.
-
Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
-
Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendra kann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
-
-
Wählen Sie im Zeitplan für die Synchronisierungsausführung unter Frequenz aus, wie oft der Inhalt Ihrer Datenquelle synchronisiert und der Index aktualisiert werden soll.
-
Wählen Sie Weiter.
-
-
Geben Sie auf der Seite Feldzuordnungen festlegen die folgenden Informationen ein:
-
Standard-Datenquellenfelder — Wählen Sie eines der Amazon Kendra generierten Standard-Datenquellenfelder aus, die Sie Ihrem Index zuordnen möchten.
-
Feld hinzufügen — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
-
Wählen Sie Weiter.
-
-
Überprüfen Sie auf der Seite Überprüfen und erstellen, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann Datenquelle hinzufügen aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite Datenquellen angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.
Weitere Informationen
Weitere Informationen zur Integration Amazon Kendra mit deiner Slack-Datenquelle findest du unter: