Suchen Sie mithilfe der intelligenten Suche mit dem Quip-Konnektor für Amazon Kendra nach Wissen in Quip-Dokumenten

Unternehmen nutzen kollaborative Dokumentenerstellungslösungen wie Salesforce Witzeln um kollaborative Echtzeitdokumente in Salesforce-Datensätze einzubetten. Quip ist die Produktivitätsplattform von Salesforce, die die Art und Weise, wie Unternehmen zusammenarbeiten, verändert und moderne Zusammenarbeit sicher und einfach auf jedem Gerät ermöglicht. Ein Quip-Repository erfasst unschätzbares Organisationswissen in Form von kollaborativen Dokumenten und Arbeitsabläufen. Das Auffinden dieser Organisationsdaten ist jedoch einfach und sicher zusammen mit anderen Dokumentenspeichern wie Box oder Amazon Simple Storage-Service (Amazon S3) kann eine Herausforderung sein. Darüber hinaus macht der Konversationscharakter kollaborativer Arbeitsabläufe den herkömmlichen schlüsselwortbasierten Suchansatz wirkungslos, da die Informationen an mehreren Stellen fragmentiert und verstreut sind.

Wir freuen uns, Ihnen mitteilen zu können, dass Sie das jetzt nutzen können Amazon Kendra Connector für Quip zum Durchsuchen von Nachrichten und Dokumenten in Ihrem Quip-Repository. In diesem Beitrag zeigen wir Ihnen, wie Sie mithilfe der intelligenten Suchfunktion von Amazon Kendra, die auf maschinellem Lernen basiert, die benötigten Informationen in Ihrem Quip-Repository finden.

Lösungsüberblick

Mit Amazon Kendra können Sie mehrere konfigurieren Datenquellen um einen zentralen Ort für die Suche in Ihrem Dokumenten-Repository bereitzustellen. Für unsere Lösung zeigen wir, wie Sie mithilfe des Amazon Kendra-Connectors für Quip ein Quip-Repository als Datenquelle eines Suchindex konfigurieren.

Der folgende Screenshot zeigt ein Beispiel eines Quip-Repositorys.

Der Arbeitsbereich in diesem Beispiel verfügt über einen privaten Ordner, der nicht freigegeben ist. Dieser Ordner verfügt über einen Unterordner, in dem Spesenbelege aufbewahrt werden. Ein weiterer Ordner namens example.com wird für andere freigegeben und für die Zusammenarbeit mit dem Team verwendet. Dieser Ordner verfügt über fünf Unterordner, die Dokumentation für die Entwicklung enthalten.

Um den Quip-Connector zu konfigurieren, notieren wir zunächst den Domänennamen, die Ordner-IDs und das Zugriffstoken des Quip-Repositorys. Dann erstellen wir einfach den Amazon Kendra-Index und fügen Quip als Datenquelle hinzu.

Voraussetzungen:

Um mit der Verwendung des Quip-Connectors für Amazon Kendra beginnen zu können, müssen Sie über ein Quip-Repository verfügen.

Sammeln Sie Informationen von Quip

Bevor wir die Quip-Datenquelle einrichten, benötigen wir einige Details zu Ihrem Repository. Lassen Sie uns diese im Voraus sammeln.

Domain Name

Finden Sie den Domainnamen heraus. Zum Beispiel für die Quip-URL https://example-com.quip.com/browse, der Domainname ist quip. Je nachdem, wie Single Sign-On (SSO) in Ihrer Organisation eingerichtet ist, kann der Domänenname variieren. Speichern Sie diesen Domainnamen zur späteren Verwendung.

Ordner-IDs

Ordnern in Quip ist eine eindeutige ID zugeordnet. Wir müssen den Quip-Connector so konfigurieren, dass er auf die richtigen Ordner zugreift, indem wir die richtigen Ordner-IDs angeben. Für diesen Beitrag indizieren wir den Ordner example.com.

Um die ID des Ordners zu finden, wählen Sie den Ordner aus. Die URL ändert sich und zeigt die Ordner-ID an.

Die Ordner-ID lautet in diesem Fall xj1vOyaCGB3u. Erstellen Sie eine Liste der zu scannenden Ordner-IDs. Wir verwenden diese IDs bei der Konfiguration des Connectors.

Zugangstoken

Melden Sie sich bei Quip an und öffnen Sie es https://{subdomain.domain}/dev/token in einem Webbrowser. Im folgenden Beispiel navigieren wir zu https://example-com.quip.com/dev/token. Dann wähle Holen Sie sich ein persönliches Zugriffstoken.

Kopieren Sie das Token, um es in einem späteren Schritt zu verwenden.

Wir haben jetzt die Informationen, die wir zum Konfigurieren der Datenquelle benötigen.

Erstellen Sie einen Amazon Kendra-Index

Um Ihren Amazon Kendra-Index einzurichten, führen Sie die folgenden Schritte aus:

1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon Kendra-Konsole.

Wenn Sie Amazon Kendra zum ersten Mal verwenden, sollte Ihnen der folgende Screenshot angezeigt werden.

2. Auswählen Erstellen Sie einen Index.
   
3. Aussichten für Indexname, eingeben my-quip-example-index.
4. Aussichten für BeschreibungGeben Sie eine optionale Beschreibung ein.
5. Aussichten für IAM-Rolle, verwenden Sie eine vorhandene Rolle oder erstellen Sie eine neue.
6. Auswählen Weiter.
   
7. Der ZugriffskontrolleinstellungenWählen Nein um alle indizierten Inhalte allen Benutzern zur Verfügung zu stellen.
8. Aussichten für Erweiterung der BenutzergruppeWählen Andere.
9. Auswählen Weiter.
   

Aussichten für Bereitstellung von EditionenJe nach Umfang des Inhalts und Häufigkeit des Zugriffs können Sie zwischen zwei Optionen wählen.

10. Wählen Sie für diesen Beitrag Entwickler-Ausgabe.
11. Auswählen Erstellen.
    

Die Rollenerstellung dauert etwa 30 Sekunden. Die Indexerstellung kann bis zu 30 Minuten dauern. Wenn Sie fertig sind, können Sie Ihren Index auf der Amazon Kendra-Konsole anzeigen.

Fügen Sie Quip als Datenquelle hinzu

Fügen wir nun Quip als Datenquelle zum Index hinzu.

1. Auf der Amazon Kendra-Konsole unter Datenmanagement Wählen Sie im Navigationsbereich Datenquellen.
2. Auswählen Stecker hinzufügen für Witzeln.
   
3. Aussichten für Name der Datenquelle, eingeben my-quip-data-source.
4. Aussichten für BeschreibungGeben Sie eine optionale Beschreibung ein.
5. Auswählen Weiter.
   
6. Geben Sie den Quip-Domänennamen ein, den Sie zuvor gespeichert haben.
7. Der Geheimnisse, wählen Erstellen Sie ein neues Secrets Manager-Geheimnis und fügen Sie es hinzu.
8. Aussichten für Geheimer Name, geben Sie den Namen Ihres Geheimnisses ein.
9. Aussichten für Quip-Token, geben Sie das zuvor gespeicherte Zugriffstoken ein.
10. Auswählen Geheimnis speichern und hinzufügen.
    
11. Der IAM-Rolle, wählen Sie eine Rolle oder erstellen Sie eine neue.
12. Auswählen Weiter.
    
13. Der SynchronisierungsbereichZ. Fügen Sie Ordner-IDs zum Crawlen hinzu, geben Sie die Ordner-IDs ein, die Sie zuvor gespeichert haben.
14. Der Ausführungszeitplan synchronisierenzum FrequenzWählen Bei Bedarf ausführen.
15. Auswählen Weiter.
    

Mit dem Quip-Connector können Sie zusätzliche Felder wie Autoren, Kategorien und Ordnernamen erfassen (und bei Bedarf sogar umbenennen).

16. Für diesen Beitrag konfigurieren wir keine Feldzuordnungen.
17. Auswählen Weiter.
    
18. Bestätigen Sie alle Optionen und fügen Sie die Datenquelle hinzu.

Ihre Datenquelle ist in wenigen Minuten fertig.

19. Wenn Ihre Datenquelle bereit ist, wählen Sie Jetzt synchronisieren.
    

Abhängig von der Größe der Daten im Quip-Repository kann dieser Vorgang einige Minuten bis einige Stunden dauern. Die Synchronisierung ist ein zweistufiger Prozess. Zunächst werden die Dokumente gecrawlt, um diejenigen zu ermitteln, die indexiert werden sollen. Anschließend werden die ausgewählten Dokumente indiziert. Zu den Faktoren, die sich auf die Synchronisierungsgeschwindigkeit auswirken, gehören der Repository-Durchsatz und die Drosselung, die Netzwerkbandbreite und die Größe der Dokumente.

Der Synchronisierungsstatus wird als erfolgreich angezeigt, wenn die Synchronisierung abgeschlossen ist. Ihr Quip-Repository ist jetzt verbunden.

Führen Sie eine Suche in Amazon Kendra durch

Testen wir den Connector, indem wir ein paar Suchvorgänge durchführen.

1. Auf der Amazon Kendra-Konsole unter Datenmanagement Wählen Sie im Navigationsbereich Suche nach indizierten Inhalten.
   
2. Geben Sie Ihren Suchbegriff in das Suchfeld ein. Für diesen Beitrag suchen wir nach EC2 on Linux.

Der folgende Screenshot zeigt unsere Ergebnisse.

Einschränkungen

Es gibt einige bekannte Einschränkungen für die Datenquellenaufnahme. Einige Einschränkungen sind auf die Notwendigkeit eines Administratorzugriffs für den Zugriff auf einige Inhalte zurückzuführen, andere auf spezifische Implementierungsdetails. Sie sind wie folgt:

• Es werden nur vollständige Crawls unterstützt. Wenn Sie möchten, dass der Connector Änderungsprotokoll-Crawls unterstützt, ist Administrator-API-Zugriff erforderlich und Sie müssen die Admin-API auf der Quip-Website aktivieren.
• Nur freigegebene Ordner werden gecrawlt. Selbst wenn wir das persönliche Zugriffstoken eines Admin-Benutzers verwenden, können wir keine Daten in den privaten Ordnern anderer Benutzer crawlen.
• Die Lösung unterstützt nicht die Angabe von Dateitypen für den Ein- und Ausschluss, da Quip nicht die Dateityperweiterung, sondern nur den Dateinamen speichert.
• Für Echtzeitereignisse sind ein Abonnement und ein Admin-API-Zugriff erforderlich.

Zusammenfassung

Der Amazon Kendra-Connector für Quip ermöglicht es Unternehmen, die in Quip-Dokumenten gespeicherten unschätzbaren Informationen mithilfe der intelligenten Suche von Amazon Kendra ihren Benutzern sicher zur Verfügung zu stellen. Der Connector bietet außerdem Facetten für Quip-Repository-Attribute wie Autoren, Dateityp, Quell-URI, Erstellungsdatum, übergeordnete Dateien und Kategorie, sodass Benutzer die Suchergebnisse basierend auf dem, was sie suchen, interaktiv verfeinern können.

Weitere Informationen dazu, wie Sie mithilfe der benutzerdefinierten Dokumentanreicherung Daten und Metadaten erstellen, ändern und löschen können, während Inhalte aus dem Quip-Repository aufgenommen werden, finden Sie unter Anpassen von Dokumentmetadaten während des Aufnahmeprozesses und Reichern Sie Ihre Inhalte und Metadaten an, um Ihr Sucherlebnis mit benutzerdefinierter Dokumentanreicherung in Amazon Kendra zu verbessern.

---

Über die Autoren

Ashish Lagwankar ist Senior Enterprise Solutions Architect bei AWS. Seine Kerninteressen umfassen KI/ML, serverlose und Container-Technologien. Ashish lebt in der Gegend von Boston, MA, und liest gerne, ist im Freien und verbringt gerne Zeit mit seiner Familie.

Vikas Schaha ist Enterprise Solutions Architect bei Amazon Web Services. Er ist ein Technologie-Enthusiast, dem es Spaß macht, Kunden dabei zu helfen, innovative Lösungen für komplexe geschäftliche Herausforderungen zu finden. Seine Interessengebiete sind ML, IoT, Robotik und Speicher. In seiner Freizeit baut Vikas gerne Roboter, wandert und reist.

• Coinsmart. Europas beste Bitcoin- und Krypto-Börse.
• Platoblockkette. Web3-Metaverse-Intelligenz. Wissen verstärkt. DEN FREIEN ZUGANG.
• CryptoHawk. Altcoin-Radar. Kostenlose Testphase.
• Quelle: https://aws.amazon.com/blogs/machine-learning/search-for-knowledge-in-quip-documents-with-intelligent-search-using-the-quip-connector-for-amazon-kendra/