Confluence und Notion als Wissensquelle: Inhalte und Zugriffe

Definieren Sie zulässige Spaces, Seitenbäume oder Datenquellen. „Das gesamte Wiki“ enthält häufig Entwürfe, persönliche Notizen und historische Inhalte, die nicht als gleichwertige Antwortgrundlage dienen sollen. Ein kleiner Anfangsbestand erleichtert fachliche Prüfung und technische Fehlersuche.

Legen Sie fest, ob untergeordnete Seiten automatisch dazugehören. Eine Unterseite kann eine notwendige Ausnahme enthalten, aber auch einen vertraulichen Projektbereich. Die Struktur allein ersetzt keine Freigabeentscheidung. Notieren Sie außerdem, ob Kommentare, Anhänge und eingebettete externe Inhalte Teil des Auftrags sind.

Jede Sammlung benötigt eine fachlich verantwortliche Person. Sie entscheidet, welche Fassung verbindlich ist und wie widersprüchliche Inhalte bereinigt werden. Der technische Betreiber sollte nicht allein anhand erfolgreicher API-Antworten entscheiden, was als Unternehmenswissen gilt.

Die Confluence-Cloud-API stellt Seiten und deren Metadaten über definierte Endpunkte bereit. Die Dokumentation beschreibt Berechtigungsanforderungen für Seiten und zugehörige Bereiche sowie paginierte Listen. Der Import muss daher sowohl Zugriffsbedingungen als auch vollständige Seitennavigation berücksichtigen. Atlassian: Confluence Cloud Pages API.

Erfassen Sie neben dem Text eine stabile Seitenkennung, Version, Titel, Bereich und Originalverweis. Eine Umbenennung darf nicht automatisch eine zweite Wissensquelle erzeugen. Ein veränderter Titel kann dennoch die Suchbarkeit beeinflussen und muss im Index aktualisiert werden.

Prüfen Sie die verwendete Inhaltsdarstellung mit realen Beispielen. Tabellen, Makros, eingebettete Inhalte oder Anhänge können anders verarbeitet werden als einfacher Fließtext. Behaupten Sie nicht aus einem erfolgreichen Abruf der Hauptseite, dass jede eingebettete Information bereits vollständig im Antwortbestand vorhanden ist.

Bei Notion liefert der Abruf eines Seitenobjekts Eigenschaften; der eigentliche Seiteninhalt wird gesondert über Blöcke erschlossen. Die Dokumentation zum Abruf untergeordneter Blöcke beschreibt Pagination und gegebenenfalls rekursive Abrufe für verschachtelte Inhalte. Notion: Seite abrufen, Notion: Block Children.

Für die Integration bedeutet das: Eine vorhandene Seitenkennung und ein Titel belegen noch keinen vollständigen Inhaltsimport. Der Import muss erkennen, ob weitere Ergebnisse oder untergeordnete Blöcke existieren. Sonst kann gerade eine eingerückte Ausnahme oder eine längere Tabelle fehlen.

Notions dokumentierter Search-Endpunkt sucht nach Titeln in den mit der Verbindung geteilten Objekten. Er ist damit nicht einfach eine beliebige Volltextsuche über sämtliche Inhalte des Arbeitsbereichs. Notion: Search by Title. Planen Sie Erschließung und spätere RAG-Suche als unterschiedliche Aufgaben.

Eine API liefert größere Bestände häufig in mehreren Portionen. Wenn der Import nur die erste verarbeitet, wirkt die Verbindung trotzdem erfolgreich: Es sind ja Seiten vorhanden. Der Fehler zeigt sich erst bei Fragen zu späteren Einträgen.

Prüfen Sie deshalb einen Testbestand, der bewusst mehr Objekte als eine Antwortseite enthält. Vergleichen Sie erwartete und importierte Kennungen. Wiederholen Sie das für verschachtelte Blöcke oder Anhänge, sofern diese unterstützt werden sollen. Eine bloße Gesamtzahl hilft weniger als ein nachvollziehbarer Abgleich.

Bei einer Unterbrechung muss erkennbar bleiben, welcher Teil vollständig ist. Veröffentlichen Sie einen teilweise gelesenen Bestand nicht stillschweigend als aktuelle Gesamtsicht. Die Anwendung kann die betroffene Quelle vorübergehend ausschließen oder einen klar begrenzten Stand verwenden, sofern dies für den Auftrag vertretbar ist.

Eine Integration sieht nur Inhalte, die ihre technische Identität erreichen darf. Das ist eine notwendige Begrenzung, sagt aber nicht automatisch, welche späteren Chatnutzer dieselben Inhalte sehen dürfen. Ein zentraler Dienstzugang kann mehr lesen als eine einzelne Mitarbeiterin.

Berechtigungen aus Confluence und Notion können auf folgenden Wegen bis zur RAG-Antwort gelangen:

• Abruf im Nutzerkontext: Die Anwendung ruft im Kontext der fragenden Person ab.
• Geprüfte Zugriffsmetadaten: Die Anwendung setzt eigene, geprüfte Zugriffsmetadaten durch.
• Für alle vorgesehenes Quellenpaket: eine mögliche begrenzte Startvariante, wenn die benötigten Rechteinformationen fehlen.

Entscheiden Sie zwischen den ersten beiden Wegen. Wenn ein Konnektor vollständige Rechteübernahme verspricht, lassen Sie die konkreten Fälle nachweisen: eingeschränkte Seite, verschachtelter Bereich, Gruppenwechsel, Gastzugang und späterer Entzug. Eine Vermischung vertraulicher und allgemeiner Inhalte mit der Hoffnung, der Prompt werde sie trennen, ist keine gleichwertige Lösung.

Ein gemeinsamer Index für Inhalte aus Confluence und Notion sollte die folgenden Felder führen:

Eine gemeinsame Darstellung erleichtert Suche über beide Systeme. Sie darf jedoch Unterschiede nicht verdecken. Beispielsweise ist ein Änderungszeitpunkt kein Ersatz für eine fachliche Freigabe, und ein importierter Block kann seine Bedeutung erst zusammen mit einer Seitenüberschrift erhalten.

Bewahren Sie daher die für die Aussage notwendigen Beziehungen. Eine Antwort sollte auf eine konkrete Seite oder Passage führen, nicht nur auf die Startseite eines Arbeitsbereichs. Prüfen Sie den Link mit der gleichen Nutzerrolle wie die Antwort.

Ein erfundenes Notion-Handbuch enthält eine allgemeine Rückgabefrist in einem normalen Absatz. Eine verschachtelte Untersektion beschreibt Ausnahmen für Sonderanfertigungen. In Confluence liegt zusätzlich eine ältere Anleitung ohne diese Ausnahme.

Ein oberflächlicher Import liest den Notion-Absatz, übersieht die untergeordneten Blöcke und findet außerdem die alte Confluence-Seite. Der Assistent könnte dann eine überzeugende, aber falsche allgemeine Zusage machen. Mehr Modellleistung repariert diese fehlende Quellenstruktur nicht zuverlässig.

Die Lösung beginnt beim Import und bei der fachlichen Rangfolge. Die Untersektion muss verfügbar sein; die alte Quelle erhält ihren historischen Status. Anschließend prüft eine konkrete Frage zur Sonderanfertigung, ob Ausnahme und gültige Fassung in der Antwort ankommen. Das ist ein vorgeschlagener Testfall, kein behauptetes Integrationsergebnis.

Viele Unternehmen kopieren Inhalte beim Wechsel eines Werkzeugs. Zwei nahezu gleiche Seiten können deshalb unterschiedliche Änderungsstände haben. Definieren Sie, welches System für den jeweiligen Prozess führend bleibt und wie die andere Fundstelle behandelt wird.

Eine automatische Ähnlichkeitserkennung kann Kandidaten für Dubletten liefern. Sie sollte nicht eigenständig entscheiden, welche Rechts- oder Prozessregel verbindlich ist. Unterschiedliche Standortvarianten können ähnlich aussehen und dennoch absichtlich verschieden sein.

Wenn beide Seiten weiter benötigt werden, hinterlegen Sie Geltungsbereich und Verweisbeziehung. Die Suche kann dann nach Aufgabe, Standort und Datum auswählen. Eine einzige ungekennzeichnete Zusammenfassung beider Fassungen würde die fachliche Unterscheidung erneut verlieren.

Ein laufender Konnektor muss Textänderungen, Verschiebungen, Archivierung, Löschung und entzogenen Zugriff behandeln. Welche Ereignisse direkt verfügbar sind, hängt von der Schnittstelle ab. Notion bietet dokumentierte Webhooks; deren Einbindung benötigt eigene Verarbeitung und Prüfung. Notion: Webhooks.

Behandeln Sie ein Ereignis als Anlass zur Synchronisation, nicht automatisch als vollständigen Ersatz des aktuellen Inhalts. Prüfen Sie, ob der benötigte Zustand erneut gelesen werden muss. Wiederholte Ereignisse dürfen keine doppelten Suchobjekte oder mehrfachen Veröffentlichungen erzeugen.

Ergänzen Sie einen regelmäßigen Abgleich des genehmigten Bestands. So lassen sich verpasste Ereignisse und nicht mehr erreichbare Objekte entdecken. Ein Fehlerstatus darf nicht unbegrenzt dazu führen, dass die zuletzt gelesene vertrauliche Fassung weiter ausgeliefert wird.

Eine nicht erreichbare Seite kann gelöscht, gesperrt oder wegen eines technischen Problems vorübergehend unzugänglich sein. Die Anwendung sollte diese Fälle anhand der dokumentierten Schnittstellenreaktionen und eigener Zustände unterscheiden. Ein pauschales Entfernen aller Inhalte nach einem kurzen API-Ausfall kann unnötige Wissenslücken erzeugen.

Umgekehrt darf ein unbekannter Zustand keine unbegrenzte Freigabe bedeuten. Vereinbaren Sie für sensible Inhalte eine konservative Sperrregel und für unkritische Inhalte gegebenenfalls einen gekennzeichneten älteren Stand. Fachliche Bedeutung und zulässige Verzögerung bestimmen die Reaktion.

Zeigen Sie Betreibern Quelle, betroffenen Bereich und letzten erfolgreichen vollständigen Abruf. „Synchronisation fehlgeschlagen“ ohne Objektbezug ist für gezielte Korrektur wenig hilfreich. Ein Wiederanlauf sollte den fehlenden Teil nachvollziehbar aufholen können.

Umfang festlegen. Eine Seite kann auf einen Anhang zeigen, ohne dessen Inhalt mitzuliefern. Ein Verweis in ein anderes System kann eine andere Identität oder zusätzliche Quellenfreigabe benötigen. Legen Sie fest, ob der Assistent diesem Verweis folgt, ihn lediglich nennt oder den Inhalt ausdrücklich als außerhalb des Prüfbereichs behandelt.

Verknüpfte Ziele. Der Zugriff auf die übergeordnete Seite erlaubt nicht automatisch den Abruf jedes verknüpften Ziels. Ein kontrollierter Import kann zulässige Quellen benennen und nicht unterstützte Objekte als sichtbare Lücke erfassen. Das ist aussagekräftiger als ein stilles Weglassen bei gleichzeitig gemeldetem vollständigem Import.

Je Anhangstyp. Vergleichen Sie für jeden unterstützten Anhangstyp die extrahierte Darstellung mit dem Original. Eine Testfrage sollte ausschließlich aus diesem Anhang beantwortbar sein. So bezieht sich die behauptete Unterstützung auf tatsächliches Verhalten und nicht nur auf eine Liste akzeptierter Dateiendungen. Wiederholen Sie diesen Test, wenn das Extraktionsverfahren oder die verwendete Schnittstellenversion geändert wird. Auch gleich benannte Anhänge können unterschiedliche Revisionen besitzen und benötigen einen nachvollziehbaren Versionsbezug.

Bestandsliste für den Wiederanlauf. Führen Sie für den Wiederanlauf eine Liste der erwarteten Quellobjekte und ihrer zuletzt verarbeiteten Versionen. Damit können Betreiber einen bewusst ausgeschlossenen Anhang von einem unterscheiden, der bei einem fehlgeschlagenen Lauf verloren ging. Gleichen Sie die Liste ab, bevor Sie den Bestand als vollständig melden, insbesondere nach einem Wechsel der Extraktionssoftware oder der API-Version.

Testbestand. Der Testbestand sollte lange Seiten, verschachtelte Abschnitte, Tabellen, Anhänge, eingeschränkte Inhalte und umbenannte Objekte enthalten. Prüfen Sie eine Frage, deren Antwort ausschließlich im letzten Teil eines paginierten Abrufs liegt. Dadurch wird Vollständigkeit sichtbar.

Änderung und Entzug. Ändern Sie anschließend einen wichtigen Satz und entziehen Sie einer Testperson den Zugriff. Kontrollieren Sie nicht nur neue Suchtreffer, sondern gespeicherte Zusammenfassungen, Quellenlinks und bestehende Gespräche. Die erlaubte Aktualisierungszeit wird gemessen statt aus einer Produktbeschreibung übernommen.

Dokumentierter Umfang. Dokumentieren Sie schließlich die unterstützten und ausgeschlossenen Objektarten. Ein ehrlicher begrenzter Konnektor ist leichter betreibbar als die unklare Behauptung „das gesamte Wiki ist angebunden“. Die Wissensdatenbank-Anleitung ergänzt die fachliche Pflege; der Leitfaden zur Aktualisierung beschreibt den laufenden Lebenszyklus.

Versionsnachweis. Halten Sie die API-Version und die Konnektor-Konfiguration zusammen mit den Tests fest. Die Fähigkeiten der Plattformen entwickeln sich weiter, und eine künftige Funktionsankündigung belegt nicht das Verhalten einer älteren Integration. Prüfen Sie repräsentative Fälle erneut, wenn Sie die Verbindung aktualisieren oder ihren Quellenumfang erweitern.

Diese Leitfäden von modernagents behandeln angrenzende Entscheidungen rund um KI-Wissensassistenten:

• KI-Wissensassistent: internes Wissen auffindbar machen
• KI-Wissensdatenbank aufbauen: Quellen zuerst ordnen
• RAG mit SharePoint: Berechtigungen bis zur Antwort erhalten
• RAG-Wissen aktuell halten: Versionen, Löschung und Widersprüche

Für eine konkrete Ablaufprüfung reichen zunächst eine Prozessbeschreibung, die beteiligten Systeme und typische Ausnahmen. Mit modernagents besprechen.