> For the complete documentation index, see [llms.txt](https://help.aiaibot.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aiaibot.com/agenten/administration/agenten-details.md).

# Agenten Details

Um die Details eines Agenten zu bearbeiten, klicken Sie in der Liste auf den gewünschten Agenten. Danach öffnet sich die Detailansicht:

<figure><img src="/files/LjT9VugrdLuYbl9QYslp" alt=""><figcaption><p>Detailseite eines Agenten</p></figcaption></figure>

## Details

Auf der linken Seite finden Sie diverse Einstellungsmöglichkeiten für Ihren Agenten.

### Name und Beschreibung

Auf der linken Seite können Sie den Namen und die Beschreibung des Agenten anpassen. Die Beschreibung erscheint im Agenten-Workspace, wenn man eine neue Konversation mit dem Agenten starten möchte.

### Disclaimer

In diesem Eingabefeld legen Sie Ihren eigenen Disclaimer für den Agenten fest. Wenn das Feld leer bleibt, wird der Standard "*KI kann Fehler machen, überprüfe wichtige Informationen.*" verwendet.

### Konversationsstarter

Sie können bis zu sechs Prompts definieren, die dem Benutzer bei einer leeren Konversation oberhalb des Eingabefelds angezeigt werden. Mit einem Klick auf eine dieser Optionen wird die Konversation mit dem entsprechenden Satz gestartet.

<figure><img src="/files/uNXBkgnSSuhMiHRrQoRJ" alt="" width="542"><figcaption><p>Konversationsstarter im Agenten</p></figcaption></figure>

### Workflow

Mit einem Klick auf `Workflow öffnen` springen Sie direkt in den entsprechend Workflow, der hinter dem Agenten steht.

## Berechtigungen

Agenten müssen einzelnen Benutzern zugewiesen werden, damit diese sie verwenden können. Ein Agent ohne entsprechende Berechtigungen ist für keinen Benutzer zu sehen.

Berechtigungen können über zwei Ebenen vergeben werden: *Benutzer* und *Gruppen*.

### Benutzer

Um den Agenten für einen Benutzer freizuschalten, geben Sie die E-Mail-Adresse des Benutzer in das Eingabefeld ein und drücken dann die \<Enter>-Taste. Wird der Benutzer im System gefunden, erscheint der Name in der darunter liegenden Liste.

{% hint style="info" %}
Der Benutzer muss bereits im System existieren und Mitglied des Workspaces sein, in dem sich Ihr Projekt befindet.
{% endhint %}

Um einem Benutzer das Recht für einen Agenten wieder zu entziehen, klicken Sie in der Liste beim entsprechenden Benutzer auf das `X`.

<figure><img src="/files/Xwdya9fjxvGuxtf49z8h" alt="" width="337"><figcaption><p>Löschen einer Benutzerberechtigung</p></figcaption></figure>

### Gruppen

Neben der direkten Zuweisung von Agenten zu Benutzern kann ein Agent auch für eine ganze Benutzergruppe freigeschalten werden. Wählen Sie dazu die gewünschte Gruppe aus dem Dropdown-Feld. Die Gruppe wird danach in die darunter liegenden Liste übernommen.

Gruppen stehen nur in Projekten zur Verfügung, die über eine Single Sign-On Lösung an unserer Plattform angebunden sind. Die Gruppen werden nicht bei uns auf der Plattform verwaltet sondern in der Benutzer- und Gruppenverwaltung des Kunden (zum Beispiel Microsoft Entra ID). Die Namen der Gruppen werden beim Anmelden von Benutzer über Single Sign-On an uns übermittelt und automatisch im System erfasst.

{% hint style="info" %}
Um die Gruppen initial auf unsere Plattform zu übertragen, muss sich ein Benutzer via Single Sign-On anmelden.
{% endhint %}

Um einer Gruppe die Berechtigung für einen Agenten zu entziehen, klicken Sie in der Liste bei der entsprechenden Gruppe auf das `X`.

<figure><img src="/files/gzCIK3cypEODTRd5OeKK" alt="" width="325"><figcaption><p>Löschen einer Gruppenberechtigung</p></figcaption></figure>

### Öffentlich

Mit dem Schalter *Öffentlich* kann der Agent öffentlich zugänglich gemacht werden. Wenn dieser Schalter aktiviert ist, ist eine URL zu sehen mit der ein Zugriff auf den Agenten ohne vorige Anmeldung möglich ist.

<figure><img src="/files/k0WjE2MunTQIjAcR1VfE" alt="" width="326"><figcaption><p>Öffentlicher Agent</p></figcaption></figure>

Diese Variante wird ausdrücklich **nicht** empfohlen. Sie soll zu Projektbeginn helfen, Agenten dem Kunden zu Testzwecken zur Verfügung zu stellen. Im Produktivbetrieb werden öffentliche Agenten nicht unterstützt.

Konversationen, die über einen öffentlichen Agenten geführt werden, bleiben für maximal 24 Stunden sichtbar.

## Testen

Konversationen mit Agenten werden in unserem System verschlüsselt abgelegt. Dies erstreckt sich auch auf das [Workflow Protokoll](/robot/workflows/workflow-protokoll.md), sodass Benutzereingaben, Dateien und die Antworten des LLMs standardmässig nicht einsehbar sind.

Um jedoch die Entwicklung und das Testen von Agenten zu erleichtern, kann der **Debug-Modus** aktiviert werden. Dieser Modus ist spezifisch für den Benutzer aktiv, der ihn einschaltet, und bewirkt, dass die Ein- und Ausgabedaten im Workflow-Protokoll im Klartext gespeichert werden.

Dabei ist zu beachten, dass diese Daten währenddessen auch für alle anderen Personen sichtbar sind, die Zugriff auf das Protokoll haben.

Die eigentliche Konversation, die unabhängig vom Workflow Protokoll gespeichert wird, bleibt von diesen Einstellungen unberührt und wird weiterhin verschlüsselt im System hinterlegt.

{% hint style="info" %}
Das Aktivieren des Debug-Modus schreibt das Workflow Protokoll im Klartext - für alle Benutzer sichtbar.
{% endhint %}


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.aiaibot.com/agenten/administration/agenten-details.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
