Integrationen

Nur für Administratoren

Diese Einstellung ist nur für Benutzer mit der Rolle Administrator sichtbar.

Im Bereich Integrationen verwalten Sie die verfügbaren Integrationen, die Ihre Fähigkeiten nutzen können.

Integrationsübersicht

1. Navigieren Sie zu Admin-Einstellungen → Integrationen
2. Sie sehen eine Liste aller verfügbaren Integrationen

Integrationen verwalten

Integration installieren

Integrationen legen Sie nicht in den Admin-Einstellungen an, sondern installieren sie über den Ayunis Marketplace. Dort finden Sie alle verfügbaren Integrationen mit einer kurzen Beschreibung und installieren die passende mit einem Klick. Anschließend erscheint sie in dieser Übersicht, wo Sie die nötigen Angaben – etwa eine URL oder Zugangsdaten – hinterlegen.

Ist der Dienst, den Sie anbinden möchten, nicht im Marketplace enthalten, ist eine benutzerdefinierte Integration möglich. Wenden Sie sich dazu an help@ayunis.com.

Verbindung testen

Um zu prüfen, ob eine Integration korrekt funktioniert:

1. Finden Sie die Integration in der Liste
2. Klicken Sie auf Verbindung testen
3. Sie erhalten eine Rückmeldung, ob die Verbindung erfolgreich ist

Integration löschen

1. Finden Sie die Integration in der Liste
2. Klicken Sie auf Löschen
3. Bestätigen Sie die Aktion

Achtung

Wenn Sie eine Integration löschen, verlieren alle Fähigkeiten, die diese Integration nutzen, den Zugriff auf den entsprechenden Dienst.

Ratsinformationssysteme (RIS)

Die OParl-Integration ermöglicht es, Ihr Ratsinformationssystem (RIS) direkt mit Ayunis Core zu verbinden. Sitzungen, Tagesordnungen und Beschlüsse stehen damit automatisch als Wissensbasis für Ihre KI-Fähigkeiten zur Verfügung.

Voraussetzungen

Damit die Anbindung funktioniert, muss Ihr Ratsinformationssystem eine öffentlich erreichbare OParl-Schnittstelle bereitstellen. OParl ist ein offener Standard, der von den gängigen RIS-Anbietern (z. B. Session/AKDB, Allris, Sitzungsdienstleister u. a.) unterstützt wird.

Prüfen Sie vorab folgende Punkte:

• Die OParl-Schnittstelle ist in Ihrem RIS aktiviert.
• Die OParl-URL ist öffentlich über das Internet erreichbar.

Die OParl-URL Ihres Systems erhalten Sie in der Regel von Ihrem RIS-Anbieter oder Ihrer kommunalen IT. Sie hat typischerweise folgendes Format:

https://[ihre-ris-url]/oparl/v1.0/

Schritt-für-Schritt-Anleitung

1. OParl-URL ermitteln – Fragen Sie bei Ihrem RIS-Anbieter oder Ihrer IT-Abteilung nach der öffentlichen OParl-Endpunkt-URL Ihres Systems.
2. Schnittstelle prüfen – Rufen Sie die OParl-URL in einem Browser auf. Sie sollten ein strukturiertes JSON-Dokument sehen, das Informationen zu Ihrem System enthält. Ist die Seite nicht erreichbar, wenden Sie sich an Ihren RIS-Anbieter.
3. Integration installieren – Öffnen Sie den Ayunis Marketplace und installieren Sie die Integration „OParl-Ratsinformationssystem (RIS)”. Die Installation ist kostenlos und in wenigen Sekunden abgeschlossen.
4. OParl-URL hinterlegen – Tragen Sie nach der Installation die ermittelte OParl-URL in den Einstellungen der Integration ein.
5. Synchronisierung starten – Ayunis Core liest die Daten aus Ihrem RIS automatisch ein. Sitzungen, Tagesordnungspunkte und Beschlüsse stehen anschließend als Wissensquelle bereit.

Hinweise

• Die Daten werden automatisch synchronisiert – ein manueller Import ist nicht erforderlich.
• Es werden ausschließlich öffentlich zugängliche Daten über die OParl-Schnittstelle abgerufen.
• Sollte Ihr RIS keine öffentliche OParl-Schnittstelle anbieten, wenden Sie sich an Ihren Anbieter und fragen nach der Aktivierung.

Authentifizierungsmethoden

Manche Organisationen möchten ein eigenes Fachverfahren oder einen Dienst anbinden, für den es noch keine Integration im Marketplace gibt. Für solche benutzerdefinierten Integrationen bietet Ayunis Core zwei Authentifizierungsmethoden an:

Benutzerdefinierte Integration benötigt?

Benutzerdefinierte Integrationen können Sie nicht selbst anlegen. Wenn Sie eine solche Anbindung benötigen, wenden Sie sich an help@ayunis.com – wir richten sie gemeinsam mit Ihnen ein.

Benutzerdefinierte HTTP-Header

Die klassische Methode: Sie definieren HTTP-Header, die entweder von der Organisation oder von einzelnen Benutzern bereitgestellt werden (z.B. API-Schlüssel, Bearer-Tokens).

OAuth 2.1

Integrationen, die den OAuth-2.1-Standard unterstützen, können eine sichere Anmeldung über den Browser verwenden. Dabei wird jeder Benutzer automatisch zu einem Anmeldefenster des externen Dienstes weitergeleitet, um sich mit seinem eigenen Konto zu verbinden.

Bei der Einrichtung einer OAuth-Integration können Sie wählen:

• Automatische Client-Registrierung: Ayunis Core ermittelt die OAuth-Fähigkeiten des Servers automatisch.
• Statische Client-Zugangsdaten: Sie tragen eine vorab registrierte Client-ID und optional ein Client-Secret ein.

Hinweis

Wenn Sie statische Client-Zugangsdaten verwenden, müssen Sie die angezeigte Callback-URI beim Autorisierungsserver registrieren.

Benutzer-Autorisierung

Einige Integrationen erfordern, dass einzelne Benutzer ihre eigenen Zugangsdaten hinterlegen — entweder über einen persönlichen API-Schlüssel oder über eine OAuth-Anmeldung. In diesem Fall:

• Nach dem Hinzufügen der Integration sehen betroffene Benutzer eine Benachrichtigung in ihren persönlichen Einstellungen → Integrationen.
• Jeder Benutzer autorisiert die Integration selbst mit seinen eigenen Zugangsdaten — diese werden niemals mit anderen Benutzern geteilt.
• Bei OAuth-Integrationen klicken Benutzer auf Verbinden und werden zu einem sicheren Anmeldefenster des externen Dienstes weitergeleitet.
• Der Status jeder Integration wird als Aktion erforderlich, Verbunden oder Optional angezeigt.

Als Administrator müssen Sie keine individuellen Zugangsdaten sammeln. Fügen Sie einfach die Integration hinzu und informieren Sie Ihre Benutzer, dass sie diese in ihren persönlichen Einstellungen autorisieren müssen.

Tipp

Informieren Sie Ihre Benutzer nach dem Hinzufügen einer Integration, die eine Benutzer-Autorisierung erfordert, damit diese ihre Zugangsdaten zeitnah einrichten können.

Nächste Schritte

• Persönliche Integrationen-Einstellungen – So autorisieren Benutzer Integrationen
• Fähigkeiten: Integrationen – So nutzen Fähigkeiten die Integrationen
• Modelle verwalten – Sprachmodelle konfigurieren