Atlassian-Agent

Übersicht

• Jira-Issues und Confluence-Seiten über Blockbrain suchen und abrufen

• Jira-Aufgaben, -Vorgänge und -Projekte erstellen, aktualisieren und verwalten

• Inhalte aus Confluence-Bereichen und -Seiten für Berichte oder KI-Analysen extrahieren und zusammenfassen

• Auf Projekt-, Vorgangs- und Seitenmetadaten für eine verbesserte Workflow-Automatisierung zugreifen

• Prozesse und Berichte in Jira und Confluence mithilfe von Atlassian-Daten automatisieren

Voraussetzungen

• Schließe die allgemeinen Einrichtungsschritte von der Hauptseite der AI Agents

• Sicherstellen, dass Benutzer über aktive Atlassian-Cloud-Konten mit Zugriff auf Jira und/oder Confluence verfügen

• Eine geeignete Atlassian-Produktlizenz für Jira und Confluence verifizieren

Konfiguration der Atlassian-App-Registrierung

Erforderliche API-Berechtigungen

Fügen Sie Ihrer App-Registrierung die folgenden Atlassian-API-Berechtigungen (OAuth-2.0-Bereiche) hinzu:

Alternativ können Sie den .default -Bereich verwenden (nutzt alle in der App festgelegten Bereiche).

Umleitungs-URL

• Hinzufügen https://nango.theblockbrain.ai/oauth/callback als zulässige Umleitungs-URL zu Ihrer App-Registrierung

Schritte zur Berechtigungskonfiguration

1. Gehen Sie in Ihrer Atlassian-Entwicklerkonsole zu den OAuth-2.0-(3LO)-Konfigurationen Ihrer App

2. Klicken Sie auf „Bereiche hinzufügen“

3. Suchen Sie nach jedem erforderlichen Berechtigungsbereich und wählen Sie ihn aus (siehe Tabelle oben)

4. Klicken Sie auf „Hinzufügen“ um die ausgewählten Bereiche in Ihre App aufzunehmen

5. Speichere deine Änderungen

6. (Empfohlen) Lassen Sie einen Atlassian-Administrator die Zustimmung für alle erforderlichen Bereiche für den organisationsweiten Einsatz erteilen

Agentenkonfiguration in Blockbrain

1. Agenteneinstellungen aufrufen:

   • Navigieren Sie zu Ihrem Blockbrain-Admin-Panel

   • Gehen Sie zu Agents > Atlassian Agent

   • Klicken Sie auf „Konfigurieren“

2. Atlassian-OAuth-Anmeldedaten eingeben:

   • Client-ID: Geben Sie die Client-ID aus Ihrer Atlassian-OAuth-App ein

   • Client-Secret: Fügen Sie das von Ihnen generierte Client-Secret ein

   • Umleitungs-URL: Überprüfen https://nango.theblockbrain.ai/oauth/callback ist konfiguriert

3. Duale Integrations-Connectoren konfigurieren:

   • Der Atlassian Agent enthält zwei separate Connectoren:

     • Jira-Connector: Für Vorgangsverwaltung und Projektoperationen

     • Confluence-Connector: Für die Dokumentationssuche und den Inhaltsabruf

   • Konfigurieren Sie jeden Connector einzeln in der Verwaltungsoberfläche

   • Wichtig: Beide Connectoren müssen sichtbar und konfiguriert sein, damit die volle Funktionalität verfügbar ist

4. OAuth-Bereiche konfigurieren:

   • Erforderliche Bereiche für Jira und Confluence mit dem hinzufügen „Hinzufügen“ Schaltfläche hinzu, wie erwähnt hier

   • Jeder Bereich wird als entfernbares Tag angezeigt

   • Verwenden Sie das „X“ Schaltfläche, um falsche Bereiche zu entfernen

5. Zusätzliche Konfiguration (Optional):

   • Bei Bedarf benutzerdefinierte Schlüssel-Wert-Paare hinzufügen, um spezifische Anforderungen zu erfüllen

   • Alle organisationsspezifischen Einstellungen konfigurieren

6. Konfiguration speichern:

   • Klicken Sie auf „Speichern“ um die Einstellungen zu übernehmen

   • Warten Sie auf die Bestätigungsmeldung

   • Überprüfen Sie, ob beide Jira- und Confluence-Verbindungen aktiv sind

Alternative: Konfiguration der Admin-Zustimmung

Für eine vereinfachte Bereichsverwaltung mit vorab genehmigter Admin-Zustimmung:

1. Lassen Sie in der Atlassian Developer Console einen Administrator die Zustimmung für alle erforderlichen Berechtigungsbereiche erteilen

2. Verwenden Sie in der Blockbrain-Konfiguration den .default Bereich anstelle einzelner Bereiche

3. Dadurch entfällt für Benutzer die Notwendigkeit, einzelnen Berechtigungen zuzustimmen

Testen des Atlassian Agent

Überprüfungsschritte

1. Verbindungstest:

   • Verwenden Sie den integrierten Verbindungstest in Blockbrain

   • Erfolgreiche Authentifizierung mit der Atlassian-API überprüfen

2. Benutzertest:

   • Lassen Sie einen Testbenutzer sein Atlassian-Konto verbinden

   • Versuchen Sie, auf ein bekanntes Jira-Issue oder eine Confluence-Seite zuzugreifen

   • Überprüfen Sie den Abruf von Vorgängen/Seiten und die Suchfunktionalität

3. Berechtigungsvalidierung:

   • Prüfen Sie, ob der Agent auf die entsprechenden Jira-Projekte und Confluence-Bereiche zugreifen kann

   • Bestätigen Sie, dass die Lese-/Schreibberechtigungen korrekt funktionieren

Häufige Atlassian-Integrationsanwendungsfälle

• Issuesuche: Jira-Issues projektübergreifend finden

• Inhaltsextraktion: Confluence-Seiten für die KI-Analyse aufrufen und zusammenfassen

• Projektnavigation: Jira-Projektstrukturen und Confluence-Bereiche durchsuchen

• Metadatenabruf: Issue-Eigenschaften, Seitenmetadaten und Kommentare abrufen

Fehlerbehebung

Authentifizierungsprobleme

Problem: „Zugriff verweigert“ oder Authentifizierungsfehler

• Lösung: Verifizieren Sie, dass die Administratorzustimmung für alle erforderlichen Atlassian-API-Berechtigungsbereiche erteilt wurde

• Prüfen Sie: Sicherstellen, dass die Umleitungs-URL genau https://nango.theblockbrain.ai/oauth/callback

Berechtigungsfehler

Problem: „Unzureichende Berechtigungen“ beim Zugriff auf Jira oder Confluence

• Lösung: Bestätigen Sie, dass die App-Registrierung über alle erforderlichen Jira- und Confluence-API-Bereiche verfügt

• Prüfen Sie: Überprüfen Sie, ob der Benutzer Zugriff auf die relevanten Projekte und Bereiche in Ihrer Atlassian-Organisation hat

Probleme bei der Bereichskonfiguration

Problem: Bereiche werden nicht korrekt gespeichert

• Lösung: Fügen Sie jeden Bereich einzeln mit der Schaltfläche „Hinzufügen“ hinzu

• Prüfen Sie: Entfernen Sie doppelte oder falsche Bereiche mit der Schaltfläche „X“

Sicherheitsaspekte

• Datenzugriff: Der Agent übernimmt die Atlassian-Berechtigungen des Benutzers

• Projekt-/Bereichsumfang: Der Zugriff ist auf Projekte und Bereiche beschränkt, auf die der authentifizierte Benutzer zugreifen kann

• Datenschutz: Daten werden gemäß den Datenverarbeitungsrichtlinien von Blockbrain verarbeitet

• Prüfprotokoll: Der Atlassian-Zugriff wird sowohl in den Atlassian-Cloud- als auch in den Blockbrain-Audit-Logs protokolliert

Nächste Schritte

Nach erfolgreicher Konfiguration des Atlassian Agent:

• Benutzerschulung: Schulen Sie Benutzer in den Integrationsfunktionen von Jira und Confluence

• Berechtigungsprüfung: Überprüfen Sie regelmäßig den Benutzerzugriff, um angemessene Atlassian-Berechtigungen sicherzustellen

• Integrationsüberwachung: Überwachen Sie beide Connectoren auf fortlaufende Funktionalität

• Funktionseinführung: Ermutigen Sie Teams, plattformübergreifende Funktionen zu nutzen (Jira-Confluence-Verknüpfung)

• Support-Dokumentation: Teilen Sie Endbenutzern gängige Anwendungsfälle und Anleitungen zur Fehlerbehebung mit