# Agenten

### Voraussetzungen

#### Blockbrain

{% hint style="info" %}
**Agenten und Connectoren** 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-Administratorzugriff**: Administrative Berechtigungen in Ihrem Blockbrain-Arbeitsbereich

#### Drittanbietertool

* **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 Connectoren

* **Research Agent**
* **Knowledge Management Agent**
* [SharePoint-Agent](/de/fur-administratoren/agenten/sharepoint-agent.md)
* [Outlook-Agent](/de/fur-administratoren/agenten/outlook-agent.md)
* **Excel Agent**
* **SAP Agent**
* **Atlassian Agent**
* **Google Agent**

und

* **Benutzerdefinierte Agenten**

### Allgemeiner Einrichtungsüberblick

Der Installationsprozess umfasst diese Hauptschritte:

1. **Funktion aktivieren**: Stellen Sie sicher, dass die KI-Agenten von Ihrem Customer Success Manager aktiviert wurden
2. **OAuth-App-Erstellung**: OAuth-App in einem Drittanbietertool erstellen und konfigurieren
3. **Berechtigungskonfiguration**: Richten Sie im Tool die passenden Berechtigungen und Scopes ein
4. **Agentenkonfiguration**: Konfigurieren Sie den jeweiligen Agenten in Blockbrain mit Ihren Anmeldedaten und Scopes
5. **Test & Verifizierung**: Validieren Sie, dass die Integration korrekt funktioniert

### OAuth-App-Erstellung (gemeinsame Schritte)

#### Schritt 1: Auth-App erstellen

1. Navigieren Sie zum Entwickler- oder API-Portal Ihrer 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. Setzen Sie die **Umleitungs-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 die **Client-Zugangsdaten** oder **Geheimnisse** Abschnitt.
2. Erstellen Sie eine **neues Client-Secret** oder **API-Schlüssel**.
3. Fügen Sie eine Beschreibung hinzu und wählen Sie einen geeigneten Ablaufzeitraum (empfohlenes Maximum: 24 Monate).
4. **Kopieren und speichern Sie sicher** das generierte Secret — es wird nach dem 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:** Speichern Sie diese sicher (z. B. in einem Secret Manager). Sie werden benötigt, wenn Sie Ihren Agenten oder Connector in Blockbrain verbinden.

### Nächste Schritte

Wählen Sie den konkreten Agenten aus, den Sie konfigurieren möchten:

* [SharePoint-Agent](/de/fur-administratoren/agenten/sharepoint-agent.md) - Für die Integration von SharePoint und Dateiverwaltung
* [Outlook-Agent](/de/fur-administratoren/agenten/outlook-agent.md) - Für die Integration von E-Mail-, Kalender- und Aufgabenverwaltung

### Best Practices für die Sicherheit

#### **Prinzip der geringsten Rechte**

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.

#### **Verwaltung von Geheimnissen**

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

#### **Admin- oder organisationsweite Zustimmung**

Erwägen Sie in Unternehmensumgebungen, App-Berechtigungen auf Administratorebene vorab zu genehmigen, um das Onboarding der Benutzer 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.

### Support

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

* **Funktion aktivieren**: Kontaktieren Sie Ihren Blockbrain Customer Success Manager
* **Technische Konfiguration**: Wenden Sie sich an Ihren Blockbrain Technical Project Manager
* **Probleme mit Drittanbieter-Plattformen**: Konsultieren Sie die Dokumentation oder Ihren Administrator


---

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