# ChatBHT-Agenten

Der Agent kann eine Aufgabe in mehreren Schritten bearbeiten und dafür freigegebene Werkzeuge verwenden. Ergebnisse erscheinen als Antwort, nachvollziehbare Arbeitsschritte und gegebenenfalls Dateien im Arbeitsbereich des Chats.

## Agenten einschalten

Aktivieren Sie **Agent** direkt im Nachrichtenfeld. Über das danebenliegende Symbol **Agent-Werkzeuge** öffnen Sie die Einstellungen. Die Verfügbarkeit hängt von Ihrem Zugang und der Instanz ab.

```{include} ../_includes/ui-composer.md
```

Der Schalter gilt für den aktuellen Chat. Schreiben Sie ein konkretes Ziel, die benötigten Eingaben und das gewünschte Ergebnisformat in die Nachricht.

> Erstelle aus der angehängten Tabelle eine kurze Auswertung. Prüfe fehlende Werte, beschreibe die wichtigsten Ergebnisse und speichere einen Bericht als Markdown-Datei.

## Profil wählen

```{include} ../_includes/ui-agent.md
```

| Profil | Verhalten |
| --- | --- |
| **Ausführen** | Bearbeitet die Aufgabe im Arbeitsbereich. Freigegebene Werkzeuge können Dateien schreiben, Code ausführen und Ergebnisse erzeugen. |
| **Planen** | Erstellt einen Plan und liest vorhandene Dateien, ohne sie zu ändern. |
| **Architektur** | Untersucht Struktur und technische Entscheidungen, ohne Dateien zu ändern. |
| **Prüfen** | Prüft Ergebnisse, Risiken und offene Fragen, ohne Dateien zu ändern. |

Werkzeuge, die Dateien verändern oder Code ausführen, stehen nur im Profil **Ausführen** zur Verfügung. Das Profil und die Werkzeugfreigaben bestimmen gemeinsam, was der Agent tun darf.

## Skills und Werkzeuge

Öffnen Sie **Erweitert**, um die Auswahl zu sehen.

| Skill | Zweck |
| --- | --- |
| **Anforderungen** | Klärt Anforderungen und Annahmen. |
| **Planprüfung** | Prüft einen Plan auf Vollständigkeit und Risiken. |
| **Recherche** | Untersucht Quellen und belegt Schlussfolgerungen. |
| **Umsetzung** | Führt Arbeitsschritte mit anschließender Prüfung aus. |

Darunter schalten Sie einzelne Werkzeuge ein oder aus: Dateien auflisten, lesen und durchsuchen; Dateien schreiben und bearbeiten; Terminal und Python; Websuche, Webseiten lesen und Dateien herunterladen. Die Auswahl in der App ist maßgeblich. Ein Skill beschreibt eine Arbeitsweise und erteilt keine zusätzlichen Werkzeugrechte.

(dateien-fur-den-agenten)=
## Dateien für den Agenten

Bei **eingeschaltetem Agenten** öffnet die Büroklammer im Nachrichtenfeld die Dateiauswahl für Agenten-Anhänge. Diese Dateien gehören zur Aufgabe im aktuellen Chat und werden für den Agenten im Arbeitsbereich bereitgestellt. Es sind bis zu **acht Dateien pro Nachricht** mit jeweils höchstens **16 MiB** möglich.

Prüfen Sie vor dem Senden die Dateinamen über dem Eingabefeld. Das **X** entfernt einen Anhang aus der Auswahl für die nächste Nachricht. Beim Chatwechsel wird diese Auswahl nicht auf den anderen Chat übertragen.

Bei **ausgeschaltetem Agenten** öffnet dieselbe Büroklammer den [Projekt-Upload](../using-chatbht/upload-documents.md). Projektdateien dienen als wiederverwendbare Wissensquelle. Agenten-Anhänge dienen der direkten Bearbeitung einer Aufgabe. Ausgewählte Projekte können dem Agenten zusätzlich gefundenen Wissenskontext liefern.

## Fortschritt und Ergebnisse prüfen

Während der Ausführung sehen Sie die Arbeitsschritte und Werkzeugausgaben im Chat. Öffnen Sie Details, wenn Sie nachvollziehen möchten, welche Dateien gelesen oder verändert wurden. Mit **Stoppen** fordern Sie den Abbruch des laufenden Vorgangs an; bereits ausgeführte Änderungen werden dadurch nicht rückgängig gemacht.

Erzeugte Dateien erscheinen im Arbeitsbereich, teilweise als **Worktree** bezeichnet. Dort können Sie verfügbare Ergebnisse ansehen oder herunterladen. Prüfen Sie die fertigen Dateien und die Antwort, bevor Sie sie weiterverwenden.

```{include} ../_includes/ui-worktree.md
```

## Umgebung zurücksetzen

**Umgebung zurücksetzen** im Agentendialog setzt den Arbeitsbereich dieses Chats zurück und bricht laufende Agentenarbeit ab. Laden Sie benötigte Ergebnisse vorher herunter. Wenn Sie nur künftig ohne Werkzeuge chatten möchten, schalten Sie stattdessen **Agent** aus.

Einen abgeschlossenen Chatstand einschließlich der zugehörigen Arbeitsdateien können Sie über [GitLab-Nachweise](../using-chatbht/ai-quotes-with-git.md) versioniert sichern.