# Agenten

## Was sind KI-Agenten?

**KI-Agenten** sind autonome, aufgabenorientierte Entitäten innerhalb von Blockbrain, die über Ihre verbundenen Systeme und unsere vordefinierten Tools hinweg denken, planen und handeln können.\
Anstatt nur einfache Verbindungen herzustellen, nutzen sie kontextuelles Verständnis und das Wissen Ihrer Organisation, um sinnvolle Aktionen auszuführen – etwa Informationen zu analysieren, Workflows zu koordinieren oder Kommunikation zu entwerfen – basierend auf Ihrer Absicht.

KI-Agenten handeln sicher in Ihrem Namen und nutzen autorisierte Integrationen, um Aufgaben in externen Tools auszuführen (z. B. E-Mails senden, Datensätze aktualisieren oder Termine planen), während vollständige Transparenz und Kontrolle erhalten bleiben.

Sie vereinen drei zentrale Fähigkeiten:

* **Verstehen** - Kontext, Ziele und verfügbare Daten interpretieren
* **Schlussfolgern** - Entscheiden, was getan werden muss und wie es zu tun ist
* **Handeln** - Aufgaben über Ihre verbundenen Systeme ausführen

## Was sind Tools und Connectors?

**Connectors** stellen die sichere Infrastruktur bereit, die Blockbrain mit externen Diensten und Datenquellen verbindet – und übernehmen Authentifizierung, Berechtigungen sowie die Kommunikation mit APIs.

**Tools** definieren spezifische Funktionen, die über diese Verbindungen verfügbar sind – zum Beispiel Dateien aufrufen, Aufgaben verwalten oder Nachrichten senden.

KI-Agenten nutzen diese **Tools und Connectors** um intelligent mit Ihren Systemen zu interagieren — und statische Integrationen in dynamische, kontextbewusste Aktionen zu verwandeln.

## Verwendung

### Bevor Sie beginnen

Stellen Sie sicher, dass Sie Folgendes haben:

* [x] Ein Blockbrain-Konto mit Zugriff auf KI-Agenten
* [x] Ein Konto im externen System, mit dem Sie sich verbinden möchten
* [x] Berechtigung zur Verbindung von Drittanbieteranwendungen (fragen Sie bei Unsicherheit Ihr IT-Team)

### So verbinden Sie einen KI-Agenten

Der **Agents** Bereich in der linken Seitenleiste bietet Ihnen schnellen Zugriff auf alle verfügbaren Agenten — alles an einem zentralen Ort.

Jeder Agent funktioniert als ein **agentischer Datenraum**: Sobald Sie einen Agenten auswählen, wird ein dedizierter Datenraum erstellt und nach diesem Agenten benannt (z. B. „Outlook Agent“, „SharePoint Agent“). Alle Chats mit diesem Agenten werden darunter organisiert. Sobald ein Agent einem Datenraum zugewiesen ist, kann er nicht zu einem anderen Agenten gewechselt werden.

Diese Funktion befindet sich unterhalb der Datenräume und Chats.

<figure><img src="/files/5e514a46cde079438abe71766a7d2b42b7e7e63c" alt=""><figcaption></figcaption></figure>

#### So funktioniert die Agentenliste

| Funktion              | Beschreibung                                                                                                                                                    |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Sichtbare Agenten** | Bis zu **6 Agenten** werden direkt in der Seitenleiste angezeigt. Wenn Sie mehr als 6 Agenten haben, erscheint unten in der Liste ein **"Mehr anzeigen"** Link. |
| **Sortierung**        | Die Liste wird automatisch so neu sortiert, dass der **zuletzt verwendete Agent** oben angezeigt wird.                                                          |

***

### Agenten-Startseite

Wenn Sie in der Seitenleiste (oder in der „Mehr anzeigen“-Ebene) auf einen Agenten klicken, wird die **Agenten-Startseite**. Dies ist Ihr zentraler Hub für die Interaktion mit dem ausgewählten Agenten und dessen Konfiguration.

#### Was Sie sehen werden

* **Chatverlauf**: Eine Liste aller bisherigen Chats mit diesem Agenten.
* **Nachrichtenfeld**: Ein Eingabefeld am unteren Rand der Seite, mit dem Sie sofort einen neuen Chat mit dem Agenten starten können.
* **Datenquellen** — Öffnet die Ansicht zur Wissensverwaltung, um die Datenquellen des Agenten festzulegen.

<figure><img src="/files/c4c73645bcb49ded279e58b28f6f7b63ea89c029" alt=""><figcaption></figcaption></figure>

#### Einen neuen Chat starten

1. Navigieren Sie zur **Agenten-Startseite** indem Sie auf den Namen des Agenten in der Seitenleiste klicken.
2. Geben Sie Ihre Nachricht in das **Nachrichtenfeld ein.**
3. Drücken Sie **Enter** oder klicken Sie auf die Senden-Schaltfläche.
4. Ein neuer Chat wird unter dem Datenraum des Agenten erstellt und Ihr Gespräch beginnt.

> **Hinweis:** Jeder neue Chat erscheint im Chatverlauf des Agenten auf der Startseite und ist auch in der Seitenleiste unter dem Eintrag des Agenten sichtbar.

### Einen Agenten konfigurieren (nur Admins und Builder)

**Admins und Builder** können Agenten direkt über die Agenten-Startseite konfigurieren.

#### Den Agenten-Prompt bearbeiten

Der **Agent Editor** ermöglicht es Ihnen, den Prompt anzupassen, der definiert, wie sich der Agent verhält und antwortet. Sie können den Editor öffnen, indem Sie auf den Link ***"Bearbeiten"*** klicken, der sich oben auf jeder Chatseite des Agenten befindet.

<figure><img src="/files/41a9069bf65fece1bfb119e6b4c21bb49a3a175e" alt=""><figcaption></figcaption></figure>

\
2\. Schreiben oder ändern Sie den Prompt des Agenten im Editor. Der Inhaltsbereich wird direkt über der Schaltflächenleiste angezeigt.

<figure><img src="/files/ee2b505bc9e6d70e20e00a9b42677a8937c8c2f4" alt=""><figcaption></figcaption></figure>

3. Wenn Sie fertig sind:

* Klicken Sie auf **"Änderungen speichern"** um Ihre Aktualisierungen anzuwenden.
* Klicken Sie auf **"Abbrechen"** um Ihre Änderungen zu verwerfen und den Editor zu schließen.

4. Sobald Sie Ihren Agenten gespeichert haben, erscheint er im Abschnitt „Meine benutzerdefinierten Agenten“, der sich unter dem Abschnitt „Verfügbare Agenten“ befindet

<figure><img src="/files/7b02e471719d97657327c25fe3a37fad87b4db1a" alt=""><figcaption></figcaption></figure>

#### Tipps & Hinweise

* Sobald Ihr Agent verbunden ist, wird der Selektor oben auf der Seite nicht mehr gelb markiert sein. Jetzt kann er **sicher in Ihrem Namen innerhalb der Berechtigungen handeln** , die Sie gewährt haben:
  * **Auf Ihre verbundenen Daten zugreifen und sie erkunden** - zum Beispiel Dokumente, Nachrichten oder Datensätze aus Ihren verknüpften Systemen.
  * **Fragen stellen** zu Ihren Inhalten – zum Beispiel relevante Informationen, Zusammenfassungen oder Erkenntnisse aus Ihren Dateien und Kommunikationen abrufen.
  * **Aktionen anfordern** - etwa eine Nachricht senden, eine Aufgabe erstellen, einen Termin planen oder Informationen in Ihren verbundenen Apps aktualisieren.
* **Agenten sind Datenräume:** Jeder Agent funktioniert als agentischer Datenraum. Sobald Sie einen Agenten einem Datenraum zuweisen, kann dies nicht mehr geändert werden. Alle Chats werden unter dem Datenraum des Agenten organisiert.
* **Dynamische Sortierung hält Ihren Workflow schnell:** Die Seitenleiste platziert Ihren zuletzt verwendeten Agenten immer oben, sodass Ihre aktiven Agenten stets leicht erreichbar sind.
* **Kopieren statt neu erstellen:** Nutzen Sie die Kopierfunktion, um schnell Agenten-Varianten mit unterschiedlichen LLMs oder Prompts zu erstellen, ohne von vorne beginnen zu müssen.
* **Rollenbeschränkungen gelten:** Nur Admins und Builder können Prompts bearbeiten, Tools verwalten, Datenquellen konfigurieren oder Agenten kopieren. Alle Benutzer können mit Agenten chatten.

#### Datenquellen verwalten

1. Klicken Sie auf der Agenten-Startseite auf **"Datenquellen"**.
2. Der **Die Ansicht „Wissensverwaltung“** öffnet sich in einer Vollansichts-Ebene.
3. Fügen Sie Datenquellen hinzu, entfernen oder verwalten Sie sie, auf die der Agent Zugriff hat. Dies ist dieselbe Oberfläche, die für LLM-Chats, Datenräume und den Bot Creator verwendet wird.

#### Was passiert nach der Verbindung?

Sobald Ihr Agent verbunden ist:

* **Sofortiger Zugriff:** Blockbrain kann sofort mit Ihren autorisierten Diensten und Datenquellen interagieren.
* **Unter Berücksichtigung Ihrer Berechtigungen:** Der Agent greift nur auf die Informationen zu, die Ihr Konto normalerweise ansehen oder ändern darf - *nicht mehr*.
* **Von Grund auf sicher:** Die Authentifizierung erfolgt über sichere und verschlüsselte Tokens. Ihr Benutzername und Ihr Passwort werden niemals gespeichert.
* **Dauerhafte Verfügbarkeit:** Die Verbindung bleibt aktiv und ermöglicht es dem Agenten, Sie auch in zukünftigen Sitzungen nahtlos zu unterstützen, ohne dass wiederholte Anmeldungen erforderlich sind.

#### Fehlerbehebung

**KI-Agenten nicht in der Modellliste sichtbar?**

* Kontaktieren Sie Ihren Administrator – möglicherweise müssen KI-Agenten für Ihre Organisation zusammen mit dem Customer Success Manager von Blockbrain aktiviert werden

**Microsoft-Anmeldung funktioniert nicht?**

* Überprüfen Sie Ihre Internetverbindung
* Versuchen Sie, den Cache Ihres Browsers zu leeren
* Kontaktieren Sie Ihren IT-Support, wenn Sie Berechtigungsfehler erhalten

**Agent wird als „Nicht verbunden“ angezeigt?**

* Klicken Sie erneut auf „Konfigurieren“ und wiederholen Sie den Verbindungsprozess
* Stellen Sie sicher, dass Sie die externe Anmeldung erfolgreich abgeschlossen haben


---

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