Agenten

Installation von KI-Agenten - Diese Anleitung behandelt die Installation und Konfiguration von KI-Agenten für Microsoft-Dienste in Blockbrain

Voraussetzungen

Blockbrain

Agenten und Connectors sind derzeit eine Early-Access-Funktion in Blockbrain. Die Aktivierung ist verfügbar auf Anfrage auf Anfrage.

• Aktivierung der Agentenfunktion: Kontaktieren Sie Ihren Blockbrain Customer Success Manager um die KI-Agentenfunktion für Ihre Organisation zu aktivieren

• Blockbrain-Admin-Zugriff: Administrationsrechte in Ihrem Blockbrain-Workspace

Drittanbieter-Tool

• Zugriff: Berechtigungen zum Erstellen und Verwalten von OAuth-Apps

• Lizenzierung: Geeignete Lizenzen für die Dienste, die Sie integrieren möchten (z. B. MS365)

Verfügbare KI-Agenten

Blockbrain unterstützt die folgenden KI-Agenten mit Connectors

• Atlassian-Agent

• Excel-Agent

• MS Teams-Agent

• SharePoint-Agent

• Outlook-Agent

• MS Viva Engage-Agent

• OneNote-Agent

• MS Planner-Agent

• GitHub-Agent

• Salesforce-Agent

• Google-Agent

und

• Benutzerdefinierte Agenten

Allgemeiner Einrichtungsüberblick

Der Installationsprozess umfasst die folgenden Hauptschritte:

1. Aktivierung der Funktion: Stellen Sie sicher, dass die KI-Agenten von Ihrem Customer Success Manager aktiviert wurden

2. Erstellung der OAuth-App: Erstellen und konfigurieren Sie die OAuth-App im Drittanbieter-Tool

3. Konfiguration der Berechtigungen: Richten Sie die passenden Berechtigungen und Scopes im Tool ein

4. Agentenkonfiguration: Konfigurieren Sie den jeweiligen Agenten in Blockbrain mit Ihren Anmeldedaten und Scopes

5. Testen & Verifizieren: Überprüfen Sie, ob die Integration korrekt funktioniert

Erstellung der OAuth-App (Gemeinsame Schritte)

Schritt 1: Auth-App erstellen

1. Navigieren Sie zu Ihrem Entwickler- oder API-Portal der Plattform (z. B. Azure, Google Cloud Console, Slack API usw.).

2. Erstellen Sie eine neue Anwendung oder App-Registrierung.

3. Geben Sie einen aussagekräftigen Namen für Ihren KI-Agenten ein (z. B. „Blockbrain Connector“).

4. Legen Sie die Redirect-URL auf: https://nango.theblockbrain.ai/oauth/callback

5. Speichern oder registrieren Sie die App.

Schritt 2: Client Secret generieren

1. Suchen Sie in der Konfiguration Ihrer App den Bereich Client-Anmeldedaten oder Geheimnisse Bereich.

2. Erstellen Sie eine neues Client Secret oder API-Schlüssel.

3. Fügen Sie eine Beschreibung hinzu und wählen Sie eine passende Ablaufdauer (empfohlene Obergrenze: 24 Monate).

4. Kopieren Sie das generierte Secret und speichern Sie es sicher das generierte Secret — es wird nach Verlassen der Seite nicht erneut sichtbar sein.

Schritt 3: Konfigurationsdetails notieren

Notieren Sie die folgenden Informationen – Sie benötigen sie für die Blockbrain-Konfiguration:

• Client ID (Anwendungs-ID)

• Client Secret (aus Schritt 2)

• Mandanten-/Organisations-ID (falls zutreffend)

Tipp: Bewahren Sie diese sicher auf (z. B. in einem Secret Manager). Sie werden beim Verbinden Ihres Agenten oder Connectors innerhalb von Blockbrain benötigt.

Sicherheitsbewährte Verfahren

Prinzip der minimalen Rechtevergabe

Gewähren Sie nur die minimal erforderlichen Berechtigungen für Ihre spezifische Integration oder Ihren Workflow. Vermeiden Sie übermäßige Berechtigungen, um Datensicherheit und Compliance zu gewährleisten.

Secret-Verwaltung

Speichern Sie alle Client-Secrets, API-Schlüssel und Tokens sicher (z. B. in einem Secret Manager). Implementieren Sie regelmäßige Richtlinien zur Secret-Rotation und widerrufen Sie nicht verwendete Anmeldedaten umgehend.

Admin- oder organisationsweite Zustimmung

Für Unternehmensumgebungen sollten Sie Berechtigungen für Apps auf Admin-Ebene vorab genehmigen, um das Onboarding der Nutzer zu vereinfachen und einzelne Zustimmungsaufforderungen zu reduzieren.

Überwachung und Auditierung

Überprüfen Sie regelmäßig die gewährten Berechtigungen, Zugriffsprotokolle und die App-Nutzung im Entwickler- oder Identitätsverwaltungsportal Ihres Anbieters (z. B. Azure AD, Google Cloud Console, Slack App Dashboard). Widerrufen Sie den Zugriff für ungenutzte oder inaktive Apps umgehend.

Empfohlene Strategie für die App-Registrierung

Wir empfehlen, eine dedizierte Azure-App-Registrierung für diesen Agenten statt eine zentrale erneut zu verwenden.

Eine dedizierte App-Registrierung beschränkt die Berechtigungen auf das, was der SharePoint-Agent benötigt, macht die Rotation und den Widerruf von Secrets nur für diese Funktion sicher und hält die Audit-Logs in Entra ID sauber pro Agent getrennt.

Wenn Sie lieber eine einzige gemeinsam genutzte App-Registrierung für alle Blockbrain-Agenten verwenden, wird dies ebenfalls unterstützt, allerdings trägt dann jeder Agent die Gesamtheit aller konfigurierten Scopes.

Siehe Empfehlungen zur App-Registrierung für die vollständige Abwägung.

Support

Für Unterstützung bei der Einrichtung von KI-Agenten:

• Aktivierung der Funktion: Kontaktieren Sie Ihren Blockbrain Customer Success Manager

• Technische Konfiguration: Wenden Sie sich an Ihren Blockbrain Technical Project Manager

• Probleme mit der Drittanbieter-Plattform: Konsultieren Sie die Dokumentation oder Ihren Administrator

Voraussetzungen

Blockbrain

Agenten und Connectors sind derzeit eine Early-Access-Funktion in Blockbrain. Die Aktivierung ist verfügbar auf Anfrage auf Anfrage.

• Aktivierung der Agentenfunktion: Kontaktieren Sie Ihren Blockbrain Customer Success Manager um die KI-Agentenfunktion für Ihre Organisation zu aktivieren

• Blockbrain-Admin-Zugriff: Administrationsrechte in Ihrem Blockbrain-Workspace

Drittanbieter-Tool

• Zugriff: Berechtigungen zum Erstellen und Verwalten von OAuth-Apps

• Lizenzierung: Geeignete Lizenzen für die Dienste, die Sie integrieren möchten (z. B. MS365)

Verfügbare KI-Agenten

Blockbrain unterstützt die folgenden KI-Agenten mit Connectors

• Atlassian-Agent

• Excel-Agent

• MS Teams-Agent

• SharePoint-Agent

• Outlook-Agent

• MS Viva Engage-Agent

• OneNote-Agent

• MS Forms-Agent

• GitHub-Agent

• Salesforce-Agent

• Google-Agent

und

• Benutzerdefinierte Agenten

Allgemeiner Einrichtungsüberblick

Der Installationsprozess umfasst die folgenden Hauptschritte:

1. Aktivierung der Funktion: Stellen Sie sicher, dass die KI-Agenten von Ihrem Customer Success Manager aktiviert wurden

2. Erstellung der OAuth-App: Erstellen und konfigurieren Sie die OAuth-App im Drittanbieter-Tool

3. Konfiguration der Berechtigungen: Richten Sie die passenden Berechtigungen und Scopes im Tool ein

4. Agentenkonfiguration: Konfigurieren Sie den jeweiligen Agenten in Blockbrain mit Ihren Anmeldedaten und Scopes

5. Testen & Verifizieren: Überprüfen Sie, ob die Integration korrekt funktioniert

Erstellung der OAuth-App (Gemeinsame Schritte)

Schritt 1: Auth-App erstellen

1. Navigieren Sie zu Ihrem Entwickler- oder API-Portal der Plattform (z. B. Azure, Google Cloud Console, Slack API usw.).

2. Erstellen Sie eine neue Anwendung oder App-Registrierung.

3. Geben Sie einen aussagekräftigen Namen für Ihren KI-Agenten ein (z. B. „Blockbrain Connector“).

4. Legen Sie die Redirect-URL auf: https://nango.theblockbrain.ai/oauth/callback

5. Speichern oder registrieren Sie die App.

Schritt 2: Client Secret generieren

1. Suchen Sie in der Konfiguration Ihrer App den Bereich Client-Anmeldedaten oder Geheimnisse Bereich.

2. Erstellen Sie eine neues Client Secret oder API-Schlüssel.

3. Fügen Sie eine Beschreibung hinzu und wählen Sie eine passende Ablaufdauer (empfohlene Obergrenze: 24 Monate).

4. Kopieren Sie das generierte Secret und speichern Sie es sicher das generierte Secret — es wird nach Verlassen der Seite nicht erneut sichtbar sein.

Schritt 3: Konfigurationsdetails notieren

Notieren Sie die folgenden Informationen – Sie benötigen sie für die Blockbrain-Konfiguration:

• Client ID (Anwendungs-ID)

• Client Secret (aus Schritt 2)

• Mandanten-/Organisations-ID (falls zutreffend)

Tipp: Bewahren Sie diese sicher auf (z. B. in einem Secret Manager). Sie werden beim Verbinden Ihres Agenten oder Connectors innerhalb von Blockbrain benötigt.

Sicherheitsbewährte Verfahren

Prinzip der minimalen Rechtevergabe

Gewähren Sie nur die minimal erforderlichen Berechtigungen für Ihre spezifische Integration oder Ihren Workflow. Vermeiden Sie übermäßige Berechtigungen, um Datensicherheit und Compliance zu gewährleisten.

Secret-Verwaltung

Speichern Sie alle Client-Secrets, API-Schlüssel und Tokens sicher (z. B. in einem Secret Manager). Implementieren Sie regelmäßige Richtlinien zur Secret-Rotation und widerrufen Sie nicht verwendete Anmeldedaten umgehend.

Admin- oder organisationsweite Zustimmung

Für Unternehmensumgebungen sollten Sie Berechtigungen für Apps auf Admin-Ebene vorab genehmigen, um das Onboarding der Nutzer zu vereinfachen und einzelne Zustimmungsaufforderungen zu reduzieren.

Überwachung und Auditierung

Überprüfen Sie regelmäßig die gewährten Berechtigungen, Zugriffsprotokolle und die App-Nutzung im Entwickler- oder Identitätsverwaltungsportal Ihres Anbieters (z. B. Azure AD, Google Cloud Console, Slack App Dashboard). Widerrufen Sie den Zugriff für ungenutzte oder inaktive Apps umgehend.

Empfohlene Strategie für die App-Registrierung

Wir empfehlen, eine dedizierte Azure-App-Registrierung für diesen Agenten statt eine zentrale erneut zu verwenden.

Eine dedizierte App-Registrierung beschränkt die Berechtigungen auf das, was der SharePoint-Agent benötigt, macht die Rotation und den Widerruf von Secrets nur für diese Funktion sicher und hält die Audit-Logs in Entra ID sauber pro Agent getrennt.

Wenn Sie lieber eine einzige gemeinsam genutzte App-Registrierung für alle Blockbrain-Agenten verwenden, wird dies ebenfalls unterstützt, allerdings trägt dann jeder Agent die Gesamtheit aller konfigurierten Scopes.

Siehe Empfehlungen zur App-Registrierung für die vollständige Abwägung.

Support

Für Unterstützung bei der Einrichtung von KI-Agenten:

• Aktivierung der Funktion: Kontaktieren Sie Ihren Blockbrain Customer Success Manager

• Technische Konfiguration: Wenden Sie sich an Ihren Blockbrain Technical Project Manager

• Probleme mit der Drittanbieter-Plattform: Konsultieren Sie die Dokumentation oder Ihren Administrator