Zum Hauptinhalt springen
connic

Confluence

Von connic
Automatischer Sync

Nutze Confluence-Spaces als Wissensquelle für Agenten

Confluence verbindenSprich mit Sales
Publisher
Von connic
Synchronisiert
Seiten, PDF-Anhänge, Seiten-Labels
Einrichtung
Retrieval → Sources
Dokumentation
Retrieval-Docs

So funktioniert die Confluence Source

In Confluence liegen Engineering-Wikis, Architekturentscheidungen und interne Handbücher. Die Confluence-Quelle synchronisiert vollständige Spaces mit dem connic-Retrieval, damit Support- und Operations-Agenten eine Wiki-Seite heranziehen können, statt eine Antwort zu improvisieren.

Die Verbindung verwendet die Site URL und ein API Token. Spaces und optionale Labels grenzen den Umfang ein. connic wandelt jede Seite in Text um, teilt ihn in Abschnitte und erstellt Embeddings. Die Inhalte werden nach dem festgelegten Zeitplan aktualisiert. PDF-Anhänge können über dieselbe Extraktions-Pipeline verarbeitet werden wie direkte Datei-Uploads.

Das wird synchronisiert

Seiten
Veröffentlichte Seiteninhalte pro Space werden in Text umgewandelt und von Formatierungsartefakten bereinigt.
PDF-Anhänge
PDF-Anhänge werden optional über dieselbe Dokumentextraktions-Pipeline verarbeitet wie direkte Uploads.
Seiten-Labels
Labels dienen als Filter, damit nur ausgewählte Seiten in das Retrieval gelangen.
ConfluenceActiveWiki
Configuration
Content scope
Include archived pagesNo
Include PDF attachmentsNo
Sync behavior
Target namespacesources.confluence
Sync intervalDaily
When content is deleted at the sourceRemove it from the retrieval
Recent syncsSync now
  • Completed13 Oct, 09:00
    4 new · 11 updated · 1 removed
  • CompletedManual12 Oct, 21:00
    0 new · 2 updated · 0 removed
  • Completed12 Oct, 09:00
    0 new · 6 updated · 0 removed

Confluence Source einrichten

Füge die Source unter Retrieval → Sources im Environment hinzu, in dem deine Agenten laufen. Jedes Environment hat eigene Sources.

  1. Erstelle unter id.atlassian.com/manage-profile/security/api-tokens ein Atlassian API Token und kopiere es. Es wird nur einmal angezeigt.

  2. Atlassian Tokens laufen inzwischen ab – spätestens nach einem Jahr. Plane daher die Rotation vor dem Ablauf ein.

  3. Gib die URL der Confluence Cloud Site einschließlich des Pfads /wiki ein, z. B. https://example.atlassian.net/wiki.

  4. Gib die E-Mail-Adresse des Atlassian Accounts ein, zu dem das Token gehört, und füge anschließend das Token unten ein.

  5. Die Synchronisierung liest nur Inhalte, die dieser Account sehen kann. Gewähre ihm daher Zugriff auf die zu übernehmenden Spaces.

Konfiguration im Detail

Alle Einstellungen zum Verbinden von Confluence mit einem Projekt.

Verbindung

Site-URL*
Die Confluence Cloud Site.
Account-E-Mail*
E-Mail-Adresse des Atlassian Accounts, zu dem das API Token gehört.
API Token*
Die Synchronisierung verwendet ein Atlassian API Token und liest nur Inhalte, auf die der zugehörige Account zugreifen kann.

Inhaltsumfang

Space Keys
Durch Kommas getrennte Space Keys, z. B. ENG, OPS. Lass das Feld leer, um jeden Space zu synchronisieren, den der Account lesen kann.
Label-Filter
Synchronisiere nur Seiten, die eines dieser Labels tragen. Lass das Feld leer, um alle Seiten im festgelegten Umfang zu synchronisieren.
Archivierte Seiten einbeziehen
Synchronisiere auch Seiten, die in Confluence archiviert wurden.
PDF-Anhänge einbeziehen
Verarbeite PDF-Anhänge über die Dokumentextraktions-Pipeline.

Synchronisierungsverhalten

Wo synchronisierte Inhalte abgelegt werden und wie häufig sie aktualisiert werden.

Ziel-Namespace
Der Retrieval-Namespace legt fest, unter welchem Namen die synchronisierten Einträge abgelegt werden. Verwende Punkte für Verschachtelungen, z. B. sources.confluence.
Synchronisierungsintervall
Wie häufig die Quelle auf Änderungen geprüft wird. Bei jedem Lauf werden nur geänderte Inhalte erneut verarbeitet.
Wenn Inhalte an der Quelle gelöscht werden
In Confluence gelöschte oder aus dem festgelegten Umfang entfernte Seiten können bei der nächsten Synchronisierung aus dem Retrieval entfernt oder in der zuletzt synchronisierten Version beibehalten werden.

Aus einem Agenten durchsuchen

Agenten durchsuchen synchronisierte Inhalte mit dem Tool retrieval_query. Ein kleines Tool, das den Namespace festlegt, beschränkt einen Agenten auf diese Source.

tools/knowledge.py
from connic.tools import retrieval_query


async def search_confluence(question: str) -> dict:
    return await retrieval_query(
        question, namespace="sources.confluence"
    )
agents/support-agent.yaml
version: "1.0"

name: support-agent
type: llm
model: connic/gemini-3.7-flash
system_prompt: |
  Answer only from what search_confluence returns.
tools:
  - knowledge.search_confluence

Confluence Retrieval Source FAQ

Unterstützt wird Confluence Cloud. Die Verbindung verwendet die Site-URL, die Account-E-Mail und ein Atlassian API Token. Die Synchronisierung liest genau die Inhalte, auf die dieser Account zugreifen kann.

Ja. Die Synchronisierung lässt sich auf bestimmte Space Keys begrenzen und mit einem Label-Filter weiter eingrenzen, sodass nur Seiten mit diesem Label übernommen werden.

Ja, wenn die Option aktiviert ist. PDF-Anhänge durchlaufen dieselbe Extraktions-Pipeline, die connic für direkte Datei-Uploads verwendet. Dadurch werden auch gescannte Dokumente gelesen.

Genau die Berechtigungen des Accounts, zu dem das API Token gehört. connic liest nur Inhalte, die dieser Account lesen kann, und schreibt niemals Daten nach Confluence zurück.

Weitere Retrieval Sources

Zum Marketplace