Zum Hauptinhalt springen

Agenten anpassen

Nutzungsanweisung (usageInstructions)​

Das ist die wichtigste Einstellung für das Routing.

Der Orchestrator sieht von jedem Agenten ausschliesslich dessen usageInstructions. Anhand dieser Beschreibung entscheidet er, an welchen Agenten eine Anfrage weitergeleitet wird.

Empfehlungen:

  • Beschreibe präzise, für welche Themen und Fragetypen der Agent zuständig ist.
  • Nenne explizit, was nicht in den Scope fällt, wenn es zu Überschneidungen mit anderen Agenten kommen könnte.
  • Wenn ein Agent auch Anfragen aus einem fremden Themenbereich empfangen, aber ablehnen soll, dann das ebenfalls erwähnen.

Beispiel:

Für alle Fragen zu Produkten, Preisen und Verfügbarkeit.
Nicht zuständig für Fragen zu Reklamationen und Rücksendungen.

Agent-Prompt (prompt)​

Der Prompt definiert das Verhalten des Agenten: Was soll er antworten, was soll er ablehnen, welche Links soll er verwenden?

Für vorgefertigte Agenten (z.B. der Knowledge Base Agent) ist der Prompt intern festgelegt. Für individuelle Anpassungen steht das Feld Spezifische Instruktionen (customAgentInstructions) zur Verfügung.

Typische Verwendung des Prompts:

  • Feste Antworttexte für bestimmte Themen definieren
  • Links auf externe Ressourcen einbauen
  • Verhalten für Randfälle spezifizieren

Beispiel einer Prompt-Sektion:

### Öffnungszeiten
Wenn nach Öffnungszeiten gefragt wird:
- Antworte immer mit: "Die aktuellen Öffnungszeiten finden Sie auf unserer Website."
- Keine konkreten Zeiten nennen.

Spezifische Instruktionen (customAgentInstructions)​

Ergänzen den eingebauten Prompt eines vordefinierten Agenten. Diese Instruktionen haben Vorrang vor dem Standard-Prompt, wenn es zu Widersprüchen kommt.

Typische Anwendungsfälle für den Knowledge Base Agent:

  • Bestimmte Fragen explizit sperren: 
    Beantworte keine Fragen zu Personen oder Mitarbeitenden. Antworte mit __NO_ANSWER__.
  • Fragen aus einem fremden Themenbereich ablehnen: 
    Wenn die Frage einen direkten Produktvergleich mit einem Konkurrenzanbieter verlangt:
    Antworte ausschliesslich mit __NO_ANSWER__.
  • Datenqualitätsregeln durchsetzen: 
    Wenn du Zahlen nennst und die Quelle ein konkretes Jahr angibt,
    dann erwähne dieses Jahr ebenfalls.
info

__NO_ANSWER__ ist ein spezielles Schlüsselwort. Gibt ein Agent diesen Wert zurück, greift das Verhalten bei Wissenslücken.

Für weitergehende Konfiguration des Knowledge Base Agent – insbesondere den Umgang mit fehlendem Kontext – siehe Knowledge Base Agent konfigurieren.

Tools​

Jedem Agenten können Tools zugewiesen werden. Ein Tool ist eine externe Funktion (z.B. eine API oder ein Datenbankzugriff), die der Agent zur Laufzeit aufrufen kann, um aktuelle oder strukturierte Daten abzurufen.

Pro Agent kann konfiguriert werden:

  • Zugewiesene Tools – Welche Tools der Agent aufrufen darf
  • Parallele Tool-Aufrufe – Ob der Agent mehrere Tools gleichzeitig aufrufen darf
  • Tool-Aufruf erforderlich – Ob der Agent bei jeder Antwort mindestens ein Tool aufrufen muss