Integrationen

Integrations Configuration

Was sind Integrationen?

Integrationen verbinden nara mit externen Tools und Services, die dein Unternehmen bereits nutzt. Sobald eine Verbindung steht, können Agents direkt mit diesen Systemen arbeiten — Wissensbasen durchsuchen, Tickets erstellen, Daten synchronisieren und mehr — ohne die nara-Plattform zu verlassen.

Jede Integration stellt eine sichere Verbindung zu einem Drittanbieter her und macht anbieterspezifische Tools für deine Agents verfügbar.

Verfügbare Anbieter

nara unterstützt Integrationen mit folgenden Anbietern:

Anbieter	Bereich	Beschreibung
Jira	Ticketing	Jira-Issues und -Projekte erstellen, durchsuchen und verwalten
Confluence	Knowledge Base	Confluence-Seiten und -Spaces durchsuchen und abrufen
Azure DevOps	Ticketing	Work Items, Boards und Sprints in Azure DevOps verwalten

Hinweis

Die Liste der unterstützten Anbieter wird laufend erweitert. Wende dich an deinen Account Manager für Informationen zu kommenden Integrationen.

Integrations-Domains

Integrationen sind nach ihrem funktionalen Bereich gruppiert:

Ticketing-Systeme

Verbinde dich mit externen Ticketing-Plattformen, um Issues zu erstellen, zu suchen und zu verwalten. Agents können Tickets in deinem externen System erstellen — parallel zu naras eingebautem Ticket-Management.

Knowledge-Base-Systeme

Verbinde dich mit Wissensquellen, damit Agents Artikel durchsuchen, Dokumentation abrufen und externe Inhalte in Support-Gesprächen referenzieren können.

Authentifizierungsarten

Verschiedene Anbieter unterstützen verschiedene Authentifizierungsmethoden. Wähle die Methode, die zu den Anforderungen deines Anbieters und den Sicherheitsrichtlinien deines Unternehmens passt.

API Token

Die API-Token-Authentifizierung nutzt einen Schlüssel oder Token, den du in den Einstellungen des externen Anbieters erzeugst. Diese Methode ist unkompliziert und eignet sich für Anbieter, die Personal Access Tokens oder API Keys unterstützen.

Erforderliche Zugangsdaten:

• API Token — der vom Anbieter erzeugte Token oder Schlüssel.
• Base URL — der API-Endpunkt des Anbieters (z. B. https://your-domain.atlassian.net).
• Benutzername oder E-Mail — wird von manchen Anbietern zusätzlich zum Token benötigt.

Tipp

Verwende in Produktivumgebungen einen Service-Account statt eines persönlichen Kontos für API Tokens. So vermeidest du Ausfälle, wenn ein Teammitglied das Unternehmen verlässt.

OAuth 2.0

Die OAuth-2.0-Authentifizierung nutzt den Authorization Code Flow mit einer Callback-URL. Diese Methode ist sicherer für den Produktiveinsatz und vermeidet die Speicherung langlebiger Tokens.

So funktioniert der OAuth-Flow:

1. nara leitet dich zur Autorisierungsseite des Anbieters weiter.

2. Du meldest dich beim Anbieter an und erteilst nara die angefragten Berechtigungen.

3. Der Anbieter leitet zurück zu naras Callback-URL mit einem Authorization Code.

4. nara tauscht den Code gegen Access- und Refresh-Tokens ein.

5. Tokens werden sicher gespeichert und automatisch erneuert, wenn sie ablaufen.

OAuth-Verbindungen setzen voraus, dass der Admin deines Anbieters nara als autorisierte Anwendung registriert hat.

Integration verbinden

1. Anbieter auswählen — navigiere zu Settings > Integrations und wähle den Anbieter, den du verbinden möchtest (z. B. Jira, Confluence, Azure DevOps).

2. Authentifizierungsmethode wählen — wähle entweder API Token oder OAuth 2.0, je nachdem was der Anbieter unterstützt und was du bevorzugst.

3. Zugangsdaten eingeben — gib die erforderlichen Zugangsdaten für die gewählte Methode ein. Für API Token: Token und Base URL. Für OAuth: starte den Autorisierungs-Flow.

4. Verbindung testen — nara prüft die Zugangsdaten mit einer Testanfrage an die API des Anbieters. Falls der Test fehlschlägt, überprüfe deine Zugangsdaten und versuche es erneut.

5. Aktivieren — sobald der Verbindungstest erfolgreich war, aktiviere die Integration. Sie steht jetzt Agents und Tools zur Verfügung.

Aktive Verbindungen verwalten

Nach dem Verbinden einer Integration kannst du sie auf der Seite Settings > Integrations verwalten:

• Status anzeigen — sieh, ob jede Integration ACTIVE, DISABLED oder im ERROR-Zustand ist.
• Zugangsdaten erneuern — bei OAuth-Verbindungen kannst du bei Bedarf manuell eine Token-Erneuerung auslösen.
• Konfiguration aktualisieren — Base URL, Zugangsdaten oder andere Einstellungen ändern.
• Verbundene Tools anzeigen — sieh, welche Tools diese Integration nutzen.

Verbindungsstatus

Status	Beschreibung
ACTIVE	Die Integration ist verbunden und funktioniert. Tools können diese Verbindung nutzen, um mit dem Anbieter zu interagieren.
DISABLED	Die Integration wurde manuell deaktiviert. Tools verwenden diese Verbindung nicht, bis sie wieder aktiviert wird.
ERROR	Die Verbindung hat ein Problem (z. B. abgelaufene Zugangsdaten, Anbieter-API nicht erreichbar). Überprüfe die Konfiguration und behebe das Problem.

Integration trennen

Um eine Integration zu trennen:

1. Navigiere zu Settings > Integrations.

2. Finde die Integration, die du trennen möchtest.

3. Klicke auf Disconnect und bestätige.

4. Die Verbindung wird entfernt und alle Tools, die darauf angewiesen waren, haben keinen Zugriff mehr auf den Anbieter.

Achtung

Das Trennen einer Integration widerruft den Zugriff sofort. Agents können Tools, die diese Verbindung benötigen, nicht mehr verwenden. Stelle sicher, dass keine kritischen Workflows von der Integration abhängen, bevor du sie trennst.

Tool-Integrationen

Verbundene Integrationen aktivieren anbieterspezifische Tools, die Agents in Gesprächen aufrufen können. Beispiele:

Tool	Anbieter	Beschreibung
searchProviderArticles	Confluence	Artikel in verbundenen Knowledge Bases durchsuchen
getProviderArticle	Confluence	Einen bestimmten Artikel per ID abrufen
searchProviderTickets	Jira / Azure DevOps	Tickets oder Work Items im verbundenen System suchen
createProviderTicket	Jira / Azure DevOps	Ein neues Ticket oder Work Item im externen System erstellen

Diese Tools erscheinen automatisch in der Tool Registry, sobald die entsprechende Integration aktiv ist. Weise sie Agents über die Agent-Konfigurationsseite zu.

Nächste Schritte

Tool-Verwaltung Tools verwalten und zuweisen, die Integration-Verbindungen nutzen.

Agents verwalten Integration-basierte Tools deinen Agents zuweisen.

Organisation Organisationseinstellungen und Mitglieder verwalten.