View a markdown version of this page

Integration der Atlassian Confluence Cloud-Wissensdatenbank - Amazon Quick
Bevor Sie beginnenAuthentifizierungRichten Sie die Wissensdatenbank-Integration einUnterstützte InhaltstypenZugriffskontrollenWissensdatenbanken verwaltenFehlerbehebung

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.

Integration der Atlassian Confluence Cloud-Wissensdatenbank

Verwende die Atlassian Confluence Cloud-Knowledgebase-Integration, um Confluence-Inhalte zu indexieren, sodass Amazon Quick-Agenten danach suchen und Fragen dazu beantworten können.

Bevor Sie beginnen

Stelle sicher, dass du über Folgendes verfügst, bevor du die Integration einrichtest.

Authentifizierung

Bei Wissensdatenbank-Integrationen übernimmt Amazon Quick die Authentifizierung über einen Popup-Flow während der Einrichtung. Führen Sie folgende Schritte aus:

  1. Füllen Sie das angezeigte Confluence Cloud-Authentifizierungs-Popup aus.

  2. Gewähren Sie Amazon Quick Berechtigungen für den Zugriff auf Ihre Confluence-Inhalte.

  3. Überprüfen Sie den Authentifizierungsprozess und schließen Sie ihn ab.

Richten Sie die Wissensdatenbank-Integration ein

  1. Wählen Sie in der Amazon Quick-Konsole Integrationen aus.

  2. Wähle Atlassian Confluence Cloud und wähle die Schaltfläche Hinzufügen (plus „+“).

  3. Füllen Sie im Dialogfeld „Confluence-Wissensdatenbank erstellen“ unter Verbundenes Konto die folgenden Felder aus:

    • Name — Ein beschreibender Name für Ihre Datenzugriffsintegration.

    • Confluence-URL — Die URL deiner Atlassian-Site (z. B.). your-site.atlassian.net

  4. Wähle Anmelden und schließe den Confluence Cloud-Authentifizierungsablauf im Popup-Fenster ab.

  5. Füllen Sie unter Wissensdatenbank erstellen die folgenden Felder aus:

    • Name — Ein Name für Ihre Wissensdatenbank.

    • Beschreibung (optional) — Hinweise zur Nutzung der Wissensdatenbank.

  6. Fügen Sie unter Inhalt die URLs Confluence-Bereiche, Blogs oder Seiten ein, die Sie einbeziehen möchten. Wählen Sie nach jeder URL die Option Hinzufügen aus.

    Anmerkung

    URLs die der Struktur folgen, https://company.atlassian.net/wiki/spaces/space-key/overview werden als Seiten behandelt URLs.

  7. Wählen Sie Erstellen aus.

Unterstützte Inhaltstypen

  • Confluence-Seiten und Blogbeiträge

  • Inhalt von Leerzeichen

  • Seiten- und Blog-Anhänge

Zugriffskontrollen

Wichtig

Amazon Quick synchronisiert keine Zugriffskontrolllisten (ACLs) aus Datenquellen. Wenn Sie in Amazon Quick eine Wissensdatenbank erstellen, können standardmäßig nur Sie Erkenntnisse aus der Wissensdatenbank abrufen. Für gemeinsam genutzte Inhalte können Sie verschiedenen Benutzern und Gruppen Zugriff gewähren, indem Sie die Berechtigungen für die Wissensdatenbank aktualisieren.

Wissensdatenbanken verwalten

Bestehende Wissensdatenbanken bearbeiten

  1. Wählen Sie in der Amazon Quick-Konsole Knowledge Bases aus.

  2. Wählen Sie Ihre Confluence Cloud-Wissensdatenbank aus der Liste aus.

  3. Wählen Sie unter Aktionen das Dreipunktsymbol und anschließend Wissensdatenbank bearbeiten aus.

  4. Aktualisieren Sie Ihre Konfigurationseinstellungen nach Bedarf und wählen Sie Speichern.

Fehlerbehebung

Informationen zum Bearbeiten, Teilen oder Löschen Ihrer Integration finden Sie unterVerwaltung vorhandener Integrationen.

Allgemeine Informationen zur Fehlerbehebung in der Wissensdatenbank, einschließlich Synchronisierungsproblemen und fehlenden Dokumenten, finden Sie unterWissensdatenbanken zur Fehlerbehebung.

Blockierte OAuth App-Autorisierung

Symptome:

  • Fehlermeldung: „Dein Site-Administrator muss diese App für die Website instance-name .atlassian.net autorisieren, bevor die App auf dein Konto zugreifen kann.“

  • Wenn du im Zustimmungsdialog auf „Akzeptieren“ klickst, hat das keine Auswirkung.

Ursache:

Dein Atlassian-Site-Administrator hat vom Nutzer installierte Apps blockiert. OAuth Wenn diese Einstellung aktiviert ist, kann nur ein Site- oder Organisationsadministrator neue Apps von Drittanbietern autorisieren.

Schritte zur Lösung:

Verwenden Sie eine der folgenden Optionen, um dieses Problem zu beheben.

  • Option 1 (empfohlen): Der Administrator autorisiert die App direkt

    1. Ein Atlassian-Site-Administrator navigiert zu Amazon Quick und startet eine neue Wissensdatenbankeinrichtung mit Confluence Cloud.

    2. Da der Administrator über Berechtigungen auf Site-Ebene verfügt, erscheint ein übersichtlicher Zustimmungsbildschirm ohne den Fehler.

    3. Der Administrator wählt Accept, um die App zu installieren.

    Nachdem der Administrator die App autorisiert hat, können alle anderen Benutzer auf der Site problemlos eine Verbindung herstellen.

  • Option 2: Vom Nutzer installierte Apps vorübergehend zulassen — Ein Administrator geht zu Appsadmin.atlassian.com, Atlassian Apps und wählt dann den Link für Drittanbieter- und Marketplace-Apps aus. Suche unter Einstellungen nach Vom Nutzer installierte Apps und aktiviere die Option, Benutzer-Apps zuzulassen. Nachdem der Benutzer Amazon Quick autorisiert hat, schalten Sie die Einstellung zurück, um Benutzer-Apps zu blockieren.

Wichtig

Die Administratorautorisierung gilt pro Atlassian-Site, nicht pro Organisation. Wenn dein Unternehmen über mehrere Websites verfügt (z. B. team-a.atlassian.net undteam-b.atlassian.net), ist für jede Site eine separate Autorisierung erforderlich.

Anmerkung

Von Benutzern installierte Apps werden zwar entsperrt (Option 2), aber jeder Benutzer auf der Website kann jede App autorisieren. OAuth Aktivieren Sie den Block sofort wieder, nachdem der Benutzer eine Verbindung hergestellt hat.

Das Authentifizierungs-Popup schlägt fehl

Symptome:

  • Das Authentifizierungs-Popup wird nicht angezeigt oder wird sofort geschlossen.

  • Das Popup wird angezeigt, der Ablauf kann jedoch nicht abgeschlossen werden. OAuth

Schritte zur Lösung:

  1. Stellen Sie sicher, dass Ihr Browser Popups aus der Amazon Quick Console-Domain zulässt.

  2. Stellen Sie sicher, dass Ihre Confluence Cloud-Instanz von Ihrem Netzwerk aus zugänglich ist.

  3. Versuchen Sie, einen anderen Browser zu verwenden oder Ihren Browser-Cache zu leeren.

Fehlender Inhalt in der Wissensdatenbank

Symptome:

  • Die Wissensdatenbank-Synchronisierung ist abgeschlossen, aber der erwartete Inhalt ist nicht indexiert.

  • Die Suchergebnisse enthalten keine Inhalte aus bestimmten Bereichen oder Seiten.

  • Nur ein Dokument wird für einen gesamten Bereich indexiert.

Schritte zur Lösung:

  1. Stellen Sie sicher, dass der Confluence Cloud-Benutzer, der sich authentifiziert hat, Zugriff auf die Bereiche und Seiten hat, die Sie bei der Einrichtung ausgewählt haben.

  2. Vergewissern Sie sich, dass die ausgewählten Inhaltstypen unterstützt werden (Seiten, Blogbeiträge und Anhänge).

  3. Überprüfen Sie die Inhaltsauswahl in Ihrer Wissensdatenbank-Konfiguration, um sicherzustellen, dass die richtigen Bereiche und Seiten enthalten sind.

  4. Suchen Sie in Confluence URLs nach dem /overview Suffix. URLs die mit enden, /wiki/spaces/space-key/overview werden als URL für eine einzelne Seite behandelt, nicht als ganzes Leerzeichen. Wenn Sie den gesamten Bereich indizieren möchten, verwenden Sie die Space-URL ohne /overview (z. B.https://company.atlassian.net/wiki/spaces/space-key).