Skip to main content

​
Überblick

Mit dem Confluence-Data-Center-Toolset können Agenten Bereiche und Seiten lesen, Inhalte suchen, Seiten anlegen oder aktualisieren und Kommentare schreiben. Für von Atlassian gehostete Instanzen verwenden Sie das Confluence-Cloud-Toolset. Für die Indexierung in der Novaplan-AI-Suche dient der getrennte Confluence-Data-Center-Konnektor. Der Agent handelt mit den Rechten der jeweils angemeldeten Confluence-Person. Legen Sie vor dem produktiven Einsatz fest, welche Agenten Seiten erstellen oder ändern und in welchen Bereichen sie eingesetzt werden dürfen.

​
Anmeldung vorbereiten

Das Data-Center-Toolset unterstützt Personal Access Token und Basic Authentication. OAuth-Anwendungen aus der Atlassian Developer Console sind für die Cloud-Variante bestimmt. Persönliche Tokens sind laut Quellanleitung ab Confluence 7.9 verfügbar. Für ein Token öffnen Sie in Confluence Settings → Personal Access Tokens → Create token, vergeben einen Namen und ein Ablaufdatum und kopieren den Wert sofort; er wird nur einmal angezeigt. Bei Basic Authentication geben Sie später Ihren Confluence-Benutzernamen und Ihr Passwort ein. Benutzernamen und E-Mail-Adressen können voneinander abweichen.

​
Gemeinsame Instanz anlegen

  1. Eine Administratorin oder ein Administrator öffnet Workspace Settings → Actions in Novaplan AI.
  2. Wählen Sie Confluence Data Center → + Setup.
  3. Wählen Sie Personal Access Token oder Basic Authentication und geben Sie Instance Name und Base URL ein, zum Beispiel https://confluence.example.com ohne abschließenden Schrägstrich.
  4. Speichern Sie mit Create.
Die Administration legt nur die gemeinsame Instanz fest; persönliche Zugangsdaten werden dabei nicht hinterlegt. Novaplan und Ihre Confluence-Administration müssen die Erreichbarkeit der Instanz sicherstellen.

​
Persönlich authentifizieren

  1. Öffnen Sie Your actions im Bereich Personal und wählen Sie die Confluence-Data-Center-Instanz.
  2. Tragen Sie Ihr eigenes Personal Access Token oder für Basic Authentication Username und Password ein.
  3. Wählen Sie Save credentials und prüfen Sie den Status Authenticated.
  4. Fügen Sie das Toolset im Agent Builder unter Tools hinzu und verbinden Sie es mit dem Agent Core.
Jede Person meldet sich selbst an. Dadurch kann ein Agent nur die Seiten sehen und ändern, für die dieses Confluence-Konto berechtigt ist; Änderungen werden der angemeldeten Identität zugeordnet.

​
Agenten verwenden

Nennen Sie beim Erstellen einer Seite den Bereichsschlüssel, den Titel, den Inhalt und gegebenenfalls die Elternseite. Ein persönlicher Bereichsschlüssel kann mit ~ beginnen. Bei Änderungen können Sie Titel, Inhalt oder Position gezielt angeben; nicht genannte Teile sollen unverändert bleiben. Die Volltextsuche findet Themen, die Titelsuche bestimmte Seiten. Für Antworten auf einen Kommentar geben Sie den betroffenen Thread an. Confluence Data Center verwendet für Seiteninhalte das Confluence Storage Format (XHTML). Klartext kann vom Toolset dafür aufbereitet werden. Prüfen Sie erzeugte Seiten und Kommentare vor einer schreibenden Aktion.

​
Häufige Fragen

​
Funktioniert eine OAuth-App aus der Atlassian Developer Console?

Nein. Das hier beschriebene Confluence-Data-Center-Toolset unterstützt Personal Access Token und Basic Authentication. Für eine von Atlassian gehostete Instanz verwenden Sie das Confluence-Cloud-Toolset.

​
Wann verwende ich ein Token und wann Basic Authentication?

Ein persönliches Token ist die bevorzugte Methode, wenn Ihre Instanz es unterstützt; die Quellanleitung nennt Confluence 7.9 oder neuer. Es lässt sich separat widerrufen. Für ältere Instanzen oder deaktivierte Token-Erstellung kann jede Person ihren Confluence-Benutzernamen und ihr Passwort verwenden. Die Administration trägt bei beiden Methoden nur Instanzname und Base URL für die gemeinsame Verbindung ein.

​
Warum muss jede Person eigene Zugangsdaten angeben?

Der Agent führt Confluence-Aktionen mit dem Konto der angemeldeten Person aus. Er kann nur Seiten lesen oder bearbeiten, für die dieses Konto berechtigt ist, und Confluence ordnet die Änderung dieser Identität zu. Die gemeinsame Instanz enthält keine persönlichen Zugangsdaten.

​
Was unterscheidet den Konnektor vom Toolset?

Der Confluence-Data-Center-Konnektor synchronisiert Seiten und Bereiche für die Suche in Novaplan AI. Das Toolset liest und bearbeitet Inhalte bei einer konkreten Agentenaktion direkt in Confluence. Nutzen Sie den Konnektor, um vorhandene Dokumentation zu finden, und das Toolset, um beispielsweise eine Seite anzulegen oder zu aktualisieren.

​
Beispiele für Agentenanfragen

  • Seite erstellen: „Erstelle im Bereich ENG eine Seite über den Freigabeprozess.“ Nennen Sie eine Elternseite, wenn die neue Seite darunter eingeordnet werden soll. Persönliche Bereichsschlüssel können wie ~jdoe aussehen.
  • Seite ändern: „Aktualisiere den Titel dieser Seite und verschiebe sie unter die Seite ‚Teamhandbuch‘.“ Nicht genannte Inhalte sollen unverändert bleiben; prüfen Sie die vorgeschlagene Änderung.
  • Suchen: „Finde Seiten über den Freigabeprozess.“ Der Agent kann Seitentitel oder den Volltext durchsuchen. Für einen bestimmten Bereich können Sie dessen Schlüssel nennen.
  • Kommentieren: „Antworte auf diesen Kommentar auf der Seite ‚Teamhandbuch‘.“ Geben Sie den betroffenen Kommentar oder Thread an, damit die Antwort am richtigen Ort erscheint.
Bei Anmelde- oder Berechtigungsproblemen hilft Novaplan Support.