> For the complete documentation index, see [llms.txt](https://docs.blockbrain.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blockbrain.ai/de/for-admins/agenten.md). # Agenten Installation von KI-Agenten - Dieser Leitfaden behandelt die Installation und Konfiguration von KI-Agenten für Microsoft-Dienste in Blockbrain ### Voraussetzungen #### Blockbrain {% hint style="info" %} **Agenten und Connectors** sind derzeit eine **Early-Access-Funktion** in Blockbrain.\ Die Aktivierung ist verfügbar **auf Anfrage** auf Anfrage. {% endhint %} * **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](/de/for-admins/agenten/atlassian-agent.md) * [Excel-Agent](/de/for-admins/agenten/excel-agent.md) * [MS Teams-Agent](/de/for-admins/agenten/ms-teams-agent.md) * [SharePoint-Agent](/de/for-admins/agenten/sharepoint-agent.md) * [Outlook-Agent](/de/for-admins/agenten/outlook-agent.md) * [MS Viva Engage-Agent](/de/for-admins/agenten/ms-viva-engage-agent.md) * [OneNote-Agent](/de/for-admins/agenten/onenote-agent.md) * [MS Planner-Agent](/de/for-admins/agenten/ms-planner-agent.md) * [GitHub-Agent](/de/for-admins/agenten/github-agent.md) * [Salesforce-Agent](/de/for-admins/agenten/salesforce-agent.md) * [Google-Agent](/de/for-admins/agenten/google-agent.md) 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) {% hint style="info" %} **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. {% endhint %} ### 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** {% hint style="info" %} 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](/de/for-admins/classic-microsoft-integrations.md#recommended-app-registration-per-azure-app) für die vollständige Abwägung. {% endhint %} ### 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 {% hint style="info" %} **Agenten und Connectors** sind derzeit eine **Early-Access-Funktion** in Blockbrain.\ Die Aktivierung ist verfügbar **auf Anfrage** auf Anfrage. {% endhint %} * **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](/de/for-admins/agenten/atlassian-agent.md) * [Excel-Agent](/de/for-admins/agenten/excel-agent.md) * [MS Teams-Agent](/de/for-admins/agenten/ms-teams-agent.md) * [SharePoint-Agent](/de/for-admins/agenten/sharepoint-agent.md) * [Outlook-Agent](/de/for-admins/agenten/outlook-agent.md) * [MS Viva Engage-Agent](/de/for-admins/agenten/ms-viva-engage-agent.md) * [OneNote-Agent](/de/for-admins/agenten/onenote-agent.md) * [MS Forms-Agent](/de/for-admins/agenten/ms-forms-agent.md) * [GitHub-Agent](/de/for-admins/agenten/github-agent.md) * [Salesforce-Agent](/de/for-admins/agenten/salesforce-agent.md) * [Google-Agent](/de/for-admins/agenten/google-agent.md) 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) {% hint style="info" %} **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. {% endhint %} ### 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** {% hint style="info" %} 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](/de/for-admins/classic-microsoft-integrations.md#recommended-app-registration-per-azure-app) für die vollständige Abwägung. {% endhint %} ### 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 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.blockbrain.ai/de/for-admins/agenten.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.