# Atlassian-Agent

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="image">Titelbild</th></tr></thead><tbody><tr><td><strong>Übersicht</strong></td><td><ul><li>Jira-Issues und Confluence-Seiten über Blockbrain suchen und abrufen</li><li>Jira-Aufgaben, -Vorgänge und -Projekte erstellen, aktualisieren und verwalten</li><li>Inhalte aus Confluence-Bereichen und -Seiten für Berichte oder KI-Analysen extrahieren und zusammenfassen</li><li>Auf Projekt-, Vorgangs- und Seitenmetadaten für eine verbesserte Workflow-Automatisierung zugreifen</li><li>Prozesse und Berichte in Jira und Confluence mithilfe von Atlassian-Daten automatisieren</li></ul></td><td><a href="/files/8e2d91078527b6e8c217ab72731c4498aed2fe68">/files/8e2d91078527b6e8c217ab72731c4498aed2fe68</a></td></tr><tr><td><strong>Voraussetzungen</strong></td><td><ul><li>Schließe die <a href="https://docs.en.theblockbrain.ai/for-users/agents">allgemeinen Einrichtungsschritte</a> von der Hauptseite der AI Agents</li><li>Sicherstellen, dass Benutzer über aktive Atlassian-Cloud-Konten mit Zugriff auf Jira und/oder Confluence verfügen</li><li>Eine geeignete Atlassian-Produktlizenz für Jira und Confluence verifizieren</li></ul></td><td><a href="/files/b5ff00db78231f60f0f1b0350c82cec5fdf80032">/files/b5ff00db78231f60f0f1b0350c82cec5fdf80032</a></td></tr></tbody></table>

### Konfiguration der Atlassian-App-Registrierung

#### Erforderliche API-Berechtigungen

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

<table><thead><tr><th width="352">Berechtigung</th><th width="171">Typ</th><th>Beschreibung</th></tr></thead><tbody><tr><td><code>offline_access</code></td><td>Delegiert</td><td>Auf Daten zugreifen und diesen Zugriff beibehalten, für die Sie der App Zugriff gewährt haben</td></tr><tr><td><code>read:confluence-space.summary</code></td><td>Delegiert</td><td>Zusammenfassungsinformationen zu Confluence-Bereichen anzeigen</td></tr><tr><td><code>read:confluence-props</code>     </td><td>Delegiert</td><td>Confluence-Inhaltseigenschaften anzeigen</td></tr><tr><td><code>read:confluence-content.all</code> </td><td>Delegiert</td><td>Alle Confluence-Inhalte anzeigen (Seiten, Blogs usw.)</td></tr><tr><td><code>read:confluence-content.summary</code></td><td>Delegiert</td><td>Zusammenfassungsinformationen zu Confluence-Inhalten anzeigen</td></tr><tr><td><code>read:confluence-content.permission</code></td><td>Delegiert</td><td>Berechtigungen für Confluence-Inhalte anzeigen</td></tr><tr><td><code>read:confluence-user</code></td><td>Delegiert</td><td>Confluence-Benutzer anzeigen</td></tr><tr><td><code>read:confluence-groups</code></td><td>Delegiert</td><td>Confluence-Gruppen anzeigen</td></tr><tr><td><code>readonly:content.attachment:confluence</code></td><td>Delegiert</td><td>Anhänge in Confluence-Inhalten anzeigen</td></tr><tr><td><code>search:confluence</code></td><td>Delegiert</td><td>Confluence-Inhalte durchsuchen</td></tr><tr><td><code>read:jira-work</code></td><td>Delegiert</td><td>Lesezugriff auf Jira-Issues, -Projekte, -Workflows und Arbeitselemente</td></tr><tr><td><code>read:jira-user</code></td><td>Delegiert</td><td>Jira-Benutzer und ihre Profile für Zuweisungsvorgänge anzeigen</td></tr><tr><td><code>read:project:jira</code></td><td>Delegiert</td><td>Lesezugriff auf Jira-Projektdetails, Konfigurationen und Metadaten</td></tr><tr><td><code>read:board-scope:jira-software</code></td><td>Delegiert</td><td>Jira-Software-Boards, Sprints und agile Projektdaten anzeigen</td></tr><tr><td><code>write:jira-work</code></td><td>Delegiert</td><td>Jira-Issues und Arbeitselemente erstellen, bearbeiten, aktualisieren und verwalten</td></tr></tbody></table>

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

{% hint style="info" %}
**Klärung des Geltungsbereichs**: Der Atlassian Agent verbindet sich mit zwei Produkten mit unterschiedlichen Berechtigungsanforderungen:

* **Jira**: Erfordert spezifische Lese- und Schreibbereiche, um umfassende Vorgangsoperationen zu ermöglichen (erstellen, bearbeiten, zuweisen, überführen, suchen). Konfigurieren Sie die oben in der Berechtigungstabelle aufgeführten granulären Jira-Bereiche für optimale Funktionalität.
* **Confluence**: Verwendet Nur-Lese-Zugriff für Suche und Inhaltsabruf. Konfigurieren Sie nur die oben aufgeführten Confluence-Lesebereiche (keine Schreibbereiche erforderlich).

**Empfehlung**: Konfigurieren Sie sowohl Jira- als auch Confluence-Bereiche wie in der Berechtigungstabelle aufgeführt, oder verwenden Sie den `.default` Bereich für umfassenden Zugriff auf beide Produkte.
{% endhint %}

#### 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

<div data-with-frame="true"><figure><img src="/files/97887602ff3ea2eab0ec7a08a73454d0833256d4" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/c5788a641f6d207fde9cd853f120f959cbd0c381" alt=""><figcaption></figcaption></figure></div>

<figure><img src="/files/5f9047fcadafdccfa15d7f59b911854027af52f4" alt=""><figcaption></figcaption></figure>

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](#required-api-permissions)
   * 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.en.theblockbrain.ai/de/fur-administratoren/agenten/atlassian-agent.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.