> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agenten-Konfiguration

> Es gibt verschiedene Tools, die du verwenden kannst, um den Agenten zu konfigurieren und ihn an deinen spezifischen Anwendungsfall anzupassen.

<Tip>
  Für weitere Details kannst du unseren ausführlichen [Agenten-Erstellungsguide](/de/using-langdock/guides/agents/agent-creation) lesen, wie man einen Agenten erstellt.
</Tip>

Statt die Optionen unten manuell zu setzen, kannst du deinen Agenten im [Agent Builder Chat](/de/using-langdock/agents/agent-builder) beschreiben und ihn die Konfiguration übernehmen lassen. Beide Wege arbeiten an derselben Konfiguration, du kannst also jederzeit zwischen ihnen wechseln.

Du hast die folgenden Konfigurationsoptionen, um deinen Agenten anzupassen:

### Icon, Name und Beschreibung

Kurze beschreibende Informationen, um den Agenten zu identifizieren und anderen Nutzern zu erklären, wie er funktioniert. Workspace-Admins können zusätzlich einen [Ersteller-Anzeigenamen](/de/using-langdock/agents/advanced-features#ersteller-anzeigename) festlegen, der statt des einzelnen Erstellers angezeigt wird, zum Beispiel einen Teamnamen.

### Eingabetyp

Agenten unterstützen verschiedene Eingabetypen, die bestimmen, wie sie Informationen empfangen und verarbeiten.

#### Prompt (Standard)

Das Chat-Eingabefeld, das du bereits aus dem normalen Chat kennst. Damit kannst du jede beliebige Nachricht an den Agenten senden und eine Antwort erhalten.

Du kannst Beispiel-Prompts festlegen, bei denen es sich um gespeicherte Prompts handelt, auf die Nutzer klicken können, anstatt die erste Nachricht zu schreiben. Diese helfen den Nutzern und reduzieren den Aufwand, der für den Einstieg erforderlich ist.

#### Formular

Formulare ermöglichen es dir, Informationen auf strukturierte Weise zu sammeln, ähnlich wie bei einem Umfragetool. Dies hilft, Nutzer zu führen, um zu sehen, wie viel Kontext notwendig ist, um eine qualitative Antwort zu erhalten, und sie in einem standardisierten Format zu sammeln, das vom Modell leichter verarbeitet werden kann.

### Anweisungen

Beschreibe, was du mit diesem Agenten erreichen möchtest, und definiere Anweisungen. Beschreibe so viele relevante Details und Hintergrundinformationen wie möglich. Dies ermöglicht dem Agenten, besser und näher an deinen Erwartungen zu antworten. Lies den [Agenten-Guide](/de/using-langdock/guides/agents/agent-creation) und unseren [Prompting-Guide](/de/using-langdock/guides/prompt-engineering/basics/prompt-elements) für weitere Details.

### Wissen

Füge Wissen und Dateien zu deinem Agenten hinzu. Du kannst entweder Dateien von deinem Computer hochladen oder Dateien aus den [Integrationen](/de/using-langdock/guides/integrations/using-integrations) zum Agenten hinzufügen.

#### Quellenzugriff einschränken

Standardmäßig können Nutzer auf Quellenverweise in Antworten klicken, um die Originaldokumente zu öffnen und anzusehen. Wenn du sensible Quellinhalte schützen möchtest, während der Agent sie trotzdem referenzieren kann, kannst du die Quellenzugriffsbeschränkung aktivieren.

Wenn aktiviert, sehen Nutzer Quellenverweise in den Antworten, können sie aber nicht anklicken, um sie zu öffnen. Das ist nützlich, wenn:

* Der Agent Zugriff auf vertrauliche Dokumente benötigt, um präzise Antworten zu geben
* Nutzer Informationen aus Quellen erhalten sollen, ohne direkten Zugriff auf die zugrundeliegenden Dateien zu haben
* Du die Dokumentenverteilung kontrollieren möchtest, aber trotzdem das Wissen nutzen willst

<Info>
  Diese Einstellung muss zuerst auf Workspace-Ebene von einem Admin aktiviert werden, bevor sie in der Agenten-Konfiguration verfügbar ist. Wenn du diese Option nicht siehst, kontaktiere deinen Workspace-Admin.
</Info>

### Aktionen

Aktionen erweitern die Möglichkeiten deines Agenten. Klicke auf **Aktion hinzufügen**, um Folgendes hinzuzufügen:

#### Fähigkeiten

Integrierte Funktionen aus dem Chat:

* **Websuche** - durchsuche das Internet nach aktuellen Informationen
* **Bildgenerierung** - erstelle Bilder aus Textbeschreibungen

Agenten können automatisch Dateien erstellen, Dateiinhalte bearbeiten und Tabellendaten analysieren, sofern dies in den Workspace-Einstellungen aktiviert ist.

#### Integrations-Aktionen

Verbinde deinen Agenten mit externen Tools und Diensten. Dein Agent kann dann Aktionen ausführen wie:

* E-Mail-Entwürfe erstellen
* CRM-Einträge aktualisieren
* Support-Tickets erstellen
* Nachrichten in Slack posten
* Und vieles mehr - siehe unsere [Integrationsguides](/de/using-langdock/guides/integrations/using-integrations)

#### Ordner

Füge [Ordner](/de/using-langdock/library/folders) hinzu, wenn dein Agent Dateien aus einem Ordner als Kontext nutzen soll. Angefügte Ordner geben dem Agenten Kontext, aber der Agent kann den Ordner nicht bearbeiten und keine Dateien darin speichern.

#### Datei-Vorlagen

Füge [Datei-Vorlagen](/de/using-langdock/library/file-templates) hinzu, damit dein Agent Dokumente und Präsentationen in einem einheitlichen Format und Stil erstellt.

#### Workflows

Füge [Workflows](/de/using-langdock/workflows/introduction) hinzu, damit dein Agent mehrstufige Automatisierungen während einer Unterhaltung auslösen kann. Details findest du unter [Workflows über Agenten nutzen](/de/using-langdock/chat/tools/workflows#workflows-über-agenten-nutzen).

#### Andere Agenten

Füge andere Agenten hinzu, um Delegation zu ermöglichen. Dein Agent kann spezialisierte Agenten aufrufen, um bestimmte Teilaufgaben zu erledigen, was dir ermöglicht, komplexe Multi-Agenten-Workflows zu erstellen.

<Warning>
  Deep Research ist nur in regulären Chats verfügbar, nicht bei der Verwendung von Agenten. Um [Deep Research](/de/using-langdock/chat/tools/deep-research) zu nutzen, wechsle zu einer regulären Chat-Sitzung.
</Warning>

### Modell

Wähle das Modell, das dieser Agent verwenden wird. Weitere Informationen zur Auswahl des richtigen Modells findest du in unserem [Modell-Guide](/de/using-langdock/models-and-limits/models).

### Kreativität

Steuert den Temperature-Parameter des Modells, der beeinflusst, wie deterministisch oder kreativ die Antworten sind. Der Regler reicht von 0 (deterministisch) bis 1 (kreativ):

* **Niedrige Werte (0-0,3)**: Fokussiertere, konsistentere und vorhersagbarere Antworten. Am besten für faktische Aufgaben, Programmierung oder wenn du zuverlässige Ausgaben benötigst.
* **Mittlere Werte (0,4-0,7)**: Ausgewogene Kreativität und Konsistenz. Gut für allgemeine Anwendungsfälle. Standard ist 0,7.
* **Höhere Werte (0,8-1,0)**: Vielfältigere und kreativere Antworten. Besser für Brainstorming, kreatives Schreiben oder wenn du unterschiedliche Ausgaben möchtest.

### Wenn Limits erreicht sind

Lege fest, was passiert, wenn ein [Nutzer-](/de/admin/manage-usage/byok/usage-limits#limits-pro-nutzer), [Workspace-](/de/admin/manage-usage/byok/usage-limits#workspace-ausgabenlimit) oder [Agenten-Limit](/de/admin/manage-agents/agent-limits) erreicht ist. **Modell wechseln** (Standard) lässt den Agenten mit dem Fallback-Modell antworten; bei **Nutzung blockieren** kann der Agent nicht genutzt werden, bis das Limit zurückgesetzt wird.

### Planen

Über den Button **Planen** in der oberen Leiste erstellst du eine [geplante Aufgabe](/de/using-langdock/chat/scheduled) mit vorausgewähltem Agenten, zum Beispiel ein tägliches Briefing, das über diesen Agenten läuft.

### Teilen

In der oberen rechten Ecke findest du Optionen zum Teilen und zur Verwendung des Agenten. Du kannst ihn mit jedem im Workspace teilen oder Bearbeitungs- und Nutzungsberechtigungen mit bestimmten Gruppen oder Einzelpersonen teilen. Wenn der Agent [Subagenten](/de/using-langdock/agents/subagents) angehängt hat, prüft Langdock, ob die Personen, mit denen du ihn teilst, auch auf diese Subagenten zugreifen können, und bietet dir an, [fehlenden Zugriff zu erteilen](/de/using-langdock/agents/subagents#berechtigungen-und-zugriff).

### Veröffentlichen

Änderungen an der Agenten-Konfiguration werden als **Entwurf** gespeichert und wirken sich erst nach der Veröffentlichung auf Nutzer aus. Klicke oben rechts auf **Veröffentlichen**, um den aktuellen Entwurf zur aktiven Version zu machen. Die Agent API-Endpoints verwenden immer die aktive Version eines Agenten.

Beim Veröffentlichen einer neuen Version kannst du eine optionale Update-Nachricht hinzufügen, die beschreibt, was sich geändert hat. Nutzer sehen dann einen Hinweis **Neue Version**, wenn sie einen neuen Chat mit dem Agenten starten. Der Hinweis verschwindet 7 Tage nach der Veröffentlichung, oder früher, sobald ein Nutzer seit dem Release 3 Chats mit dem Agenten gestartet hat. Für Versionen, die du selbst veröffentlicht hast, siehst du den Hinweis nicht, und die erste veröffentlichte Version zeigt nie einen Hinweis.

### Analytics

Nutze die Tabs **Analytics** und **Feedback**, um Agenten-Leistung und Nutzerfeedback zu prüfen. Siehe [Agenten-Analytics](/de/using-langdock/agents/analytics) für die vollständige Analytics- und Feedback-Referenz.

### Tracing und Logging

Für tiefere Einblicke in das Verhalten und die Leistung deines Agenten kannst du Tracing über [Langfuse](https://langfuse.com) aktivieren.

**So funktioniert es:**

1. **Workspace-Admins** aktivieren zunächst das Agenten-Logging in den Workspace-Einstellungen. Dadurch wird die Funktion für Agenten in deinem Workspace verfügbar.

2. **Agenten-Editoren** können dann das Logging für einzelne Agenten konfigurieren:
   * Aktiviere den **Allow agent logs**-Toggle in der Agenten-Konfiguration
   * Setze die **Tracing cloud URL** (Standard: `https://cloud.langfuse.com`)

Nach der Konfiguration werden detaillierte Logs über die Interaktionen deines Agenten an Langfuse gesendet. Das gibt dir Einblick in:

* Einzelne Konversations-Traces
* Modell-Inputs und -Outputs
* Leistungsmetriken und Latenz
* Token-Verbrauch pro Interaktion

<Info>
  Diese Funktion erfordert die Genehmigung eines Workspace-Admins, bevor sie genutzt werden kann. Wenn du die Logging-Optionen nicht siehst, kontaktiere deinen Workspace-Admin, um Agenten-Logs in den Workspace-Einstellungen zu aktivieren.
</Info>

<Tip>
  Langfuse bietet sowohl eine Cloud-Version als auch Self-Hosted-Optionen. Wenn deine Organisation eine selbst gehostete Langfuse-Instanz verwendet, aktualisiere die Tracing cloud URL, um auf deine interne Installation zu verweisen.
</Tip>

<Info>
  Für zusätzliche Agenten-Management-Funktionen wie Labels, Anheften, Duplizieren und Besitzer-Transfer, siehe [Erweiterte Funktionen](/de/using-langdock/agents/advanced-features).
</Info>

## FAQ

<AccordionGroup>
  <Accordion title="Welche Informationen zählen zum Kontext eines Agenten?">
    Zum Kontext eines Agenten können die Nachricht des Nutzers, die bisherige Unterhaltung, die Agenten-Anweisungen, angehängte Dateien, abgerufenes Wissen, verfügbare Tools, Tool-Ergebnisse und Systemanweisungen gehören. Komplexe Agenten füllen den Kontext daher schneller als ein einfacher Chat.
  </Accordion>

  <Accordion title="Wie entscheide ich, welche Wissensquellen und Actions ich einem Agenten anhänge?">
    Hänge nur das Wissen und die Actions an, die der Agent für seine konkrete Aufgabe braucht. Breite Agenten mit vielen Quellen und Tools sind schwerer zu steuern und können irrelevante Informationen abrufen. Teile komplexe Aufgaben auf fokussierte Agenten oder Subagenten auf.
  </Accordion>

  <Accordion title="Warum nutzt ein Agent ein angehängtes Tool oder eine Wissensquelle nicht?">
    Ein Agent kann ein Tool oder eine Quelle überspringen, wenn der Prompt den Bedarf nicht klar macht, Berechtigungen fehlen, die Suche keine relevanten Inhalte findet oder eine andere Anweisung Vorrang hat. Beschreibe den erwarteten Ablauf explizit in den Agenten-Anweisungen und teste mit repräsentativen Beispielen.
  </Accordion>

  <Accordion title="Wie beeinflusst angehängtes Wissen die Antworten eines Agenten?">
    Angehängtes Wissen gibt dem Agenten wiederverwendbare Informationen, die er während einer Unterhaltung abrufen kann. Der Agent erhält meist relevante Auszüge, nicht unbedingt jedes angehängte Dokument vollständig. Die Qualität der Antwort hängt von der Suche, den Berechtigungen, den Anweisungen und der Frage des Nutzers ab.
  </Accordion>

  <Accordion title="Wann sollte ich eine agentenspezifische Wissensdatenbank statt direkter Dateien nutzen?">
    Nutze eine agentenspezifische Wissensdatenbank, wenn dieselben Dokumente wiederkehrende Unterhaltungen oder viele Nutzer unterstützen sollen. Nutze direkte Dateien, wenn die Informationen temporär sind, klein genug für die aktuelle Aufgabe oder nur in einem Chat gebraucht werden.
  </Accordion>

  <Accordion title="Warum antwortet ein Agent im Chat, statt ein Dokument zu erstellen?">
    Wenn die Anweisungen eines Agenten vorgeben, direkt im Chat zu antworten oder keine Dateien zu erstellen, öffnet sich der Dokumenten-Editor nicht automatisch. Eine explizite Bitte um ein Dokument in der Nachricht erstellt weiterhin eins, und Nutzer können den Editor jederzeit über den Button **Dokument erstellen** oder das Menü **Tools** öffnen.
  </Accordion>
</AccordionGroup>
