KI-Agenten & Builder

Ein Agent ist ein wiederverwendbarer KI-Assistent, den Sie einmal konfigurieren und immer wieder einsetzen. Statt eine Aufgabe bei jedem Öffnen eines Chats neu zu erklären, halten Sie Anweisungen, Modell, Tools und Referenzmaterial in einer einzigen gespeicherten Konfiguration fest – und starten dann eine Konversation, die bereits weiß, was zu tun ist.

Diese Seite erklärt alles: wie Sie vorhandene Agenten finden und nutzen, wie Sie Ihren eigenen von Grund auf erstellen und wie Sie erweiterte Funktionen wie Sub-Agenten, Formular-Agenten, benutzerspezifische Konfigurationsfelder und den integrierten Evaluierungsbereich nutzen.

Die Agentenseite mit einem empfohlenen Agenten und Ihrer Agentenbibliothek

Was ein Agent ist#

Ein Agent bündelt alles, was eine Konversation benötigt, in einer dauerhaften Konfiguration:

• Eine Systemanweisung (genannt „Anweisungen"), die Rolle, Ton und Regeln des Agenten festlegt
• Ein fest zugewiesenes Modell und einen Anbieter, mit denen er stets antwortet
• Einen Satz Tools (Dateisuche, Websuche, Integrationen und mehr), die er verwenden darf
• Optionale Wissensdateien, auf die er zurückgreifen kann – seine eigene private, durchsuchbare Bibliothek
• Optionale Kontextdateien – kurze Dokumente, die bei jeder Antwortrunde vollständig eingefügt werden
• Limits pro Antwortrunde, die jede Antwort in Grenzen halten
• Ein Symbol, einen Farbverlauf, eine Kategorie und eine Beschreibung, damit er in der Galerie leicht erkennbar ist

Jede mit einem Agenten gestartete Konversation läuft über diese gemeinsame Konfiguration. Ändern Sie den Agenten, übernimmt jede künftige Konversation, die ihn verwendet, die Änderung sofort.

Agenten stammen aus zwei Quellen:

1. Builder-Agenten – im visuellen Builder erstellt und in Ihrem Arbeitsbereich gespeichert. Sie können sie bearbeiten, teilen, klonen und löschen.
2. Config-Agenten – von Ihrem Administrator in der Instanzkonfigurationsdatei deklariert und beim Start der Plattform geladen. Diese tragen in der Builder-Ansicht ein Config-Abzeichen, und alle Felder sind schreibgeschützt. Sie können nicht über die Benutzeroberfläche bearbeitet oder gelöscht werden.

Die Agentenseite#

Öffnen Sie die Agentenseite über die Haupt-Seitenleiste. Sie sehen:

Das Empfehlungen-Karussell oben auf der Agentenseite

Jede Agentenkarte zeigt den Farbverlauf, das Symbol, den Namen, das Kategorie-Abzeichen (einschließlich eines Multi-Agenten-Abzeichens, wenn der Agent Sub-Agenten hat), die Beschreibung, Tags und den Eigentümer. Ein ⋯-Überlaufmenü auf Karten, die Ihnen gehören, bietet die Optionen Bearbeiten, Duplizieren, Teilen und Löschen.

Durch Klicken auf den Namen oder das Cover einer Karte öffnen Sie den Builder. Durch Klicken auf Verwenden → auf einer Karte starten Sie sofort eine neue Konversation mit diesem Agenten.

Ihren ersten Agenten erstellen – Schritt für Schritt#

Diese Anleitung erstellt einen „Workspace Copilot"-Agenten: einen Allgemeinassistenten, der das Web durchsuchen kann und stets prägnant antwortet.

Schritt 1 – Builder öffnen

Klicken Sie oben rechts auf der Agentenseite auf + Neuer Agent. Der Builder öffnet sich mit einem leeren Formular und einem Live-Vorschaubereich auf der rechten Seite.

Schritt 2 – Identitätsfelder ausfüllen

Im Tab Allgemein:

1. Name – geben Sie Workspace Copilot ein.
2. Beschreibung – fügen Sie eine einzeilige Zusammenfassung hinzu, z. B. Ihr täglicher KI-Assistent für Schreiben, Recherche und schnelle Antworten.
3. Kategorie – wählen Sie die passendste Kategorie aus dem Dropdown (z. B. Produktivität). Die Kategorie erscheint auf der Karte und hilft Kollegen, den Agenten in der Galerie zu finden.
4. Symbol – klicken Sie auf den Symbolbereich, um aus der integrierten Symbolbibliothek zu wählen oder ein PNG/JPG/WebP-Bild hochzuladen (bis zu 700 KB). Wenn Sie dies überspringen, wird ein Standard-Robotersymbol verwendet.
5. Vorschaubild-Farbverlauf – wählen Sie einen Farbverlauf für das Cover der Karte. Lassen Sie das Feld leer, wird automatisch eine Farbe aus der Kategorie abgeleitet.
6. Tags – fügen Sie einige kurze Tags hinzu (z. B. schreiben, recherche). Tags helfen anderen, den Agenten bei der Suche zu finden.
7. Gesprächseinstiege – fügen Sie ein oder zwei vorgeschlagene Einstiegsfragen hinzu. Diese erscheinen als anklickbare Chips, wenn jemand eine neue Konversation mit dem Agenten öffnet, und erleichtern den Einstieg.

Der Builder-Tab „Allgemein" mit dem Live-Vorschau-Chat

Schritt 3 – Anweisungen schreiben

Scrollen Sie nach unten zu Anweisungen. Dies ist die Systemanweisung – das wichtigste Feld. Schreiben Sie klar und präzise:

Sie sind ein freundlicher, prägnanter Arbeitsassistent für ein professionelles Team.
Antworten Sie stets in der Sprache, in der der Benutzer schreibt.
Geben Sie Ihre Quellen an, wenn Sie Ergebnisse der Websuche verwenden.
Halten Sie Antworten unter 300 Wörtern, sofern der Benutzer nicht mehr Details wünscht.

Über dem Anweisungsfeld befinden sich zwei Hilfsfunktionen:

• Optimieren – schickt Ihren Entwurf an die KI, die ihn in einen qualitativ hochwertigeren Prompt umschreibt. Der Vorschlag erscheint nebeneinander mit Ihrem Original, damit Sie ihn Übernehmen oder Verwerfen können – nichts ändert sich, bis Sie sich entschieden haben.
• Aus Vorlage – öffnet eine Bibliothek fertiger Prompt-Vorlagen. Wählen Sie eine aus, füllen Sie alle von der Vorlage geforderten Variablen aus und entscheiden Sie dann, ob Sie Ihre aktuellen Anweisungen ersetzen oder anhängen möchten.

Schritt 4 – Modell auswählen

Wählen Sie unter Modell das Modell aus, das dieser Agent immer verwenden soll. Die Liste zeigt nur Modelle, die Ihr Administrator konfiguriert hat. Das gewählte Modell ist fest zugewiesen – Benutzer können es beim Chat mit dem Agenten nicht wechseln.

Wenn das Modell erweitertes Reasoning unterstützt, erscheint ein Dropdown Reasoning-Aufwand:

Schritt 5 – Tools hinzufügen (Aktionen)

Klicken Sie auf + Aktion hinzufügen, um die Aktionsauswahl zu öffnen. Stöbern Sie nach Kategorie:

• Fähigkeiten – integrierte Tools (Websuche, Dateisuche, Code-Interpreter usw.)
• Integrationen – verbundene externe Tools, die Ihr Arbeitsbereich eingerichtet hat
• Sub-Agenten – andere Agenten, an die dieser Aufgaben delegieren kann

Aktivieren Sie für den Workspace Copilot die Websuche, damit er aktuelle Informationen abrufen kann.

Die Aktionsauswahl mit Fähigkeiten, Integrationen und Sub-Agenten

Schritt 6 – Sichtbarkeit festlegen

Wählen Sie unter Sichtbarkeit, wer diesen Agenten nutzen darf:

Für einen persönlichen Assistenten belassen Sie es vorerst bei Privat.

Schritt 7 – In der Live-Vorschau testen

Die rechte Spalte des Builders ist ein echter, funktionsfähiger Chat, der Ihren ungespeicherten Entwurf ausführt. Geben Sie eine Frage ein, um zu sehen, wie der Agent mit den aktuellen Anweisungen und dem Modell antwortet. Dabei werden Token verbraucht und das echte Modell verwendet – es ist keine Simulation.

Schritt 8 – Speichern

Klicken Sie auf Speichern (oben rechts im Builder). Der Agent befindet sich nun in Ihrem Arbeitsbereich. Sie finden ihn auf der Agentenseite unter Meine Agenten.

Builder-Tabs Referenz#

Die Arbeit im Builder ist in vier Tabs gegliedert:

Tab „Allgemein" – alle Felder#

Identität

Anweisungen

Die Systemanweisung. Klartext. Definieren Sie die Rolle, den Ton, die Sprachregeln, das Ausgabeformat und etwaige dauerhafte Einschränkungen des Agenten. Verwenden Sie Optimieren, um einen groben Entwurf zu verbessern, oder Aus Vorlage, um mit einer bewährten Struktur zu beginnen.

Eingabetyp

Modell und Reasoning-Aufwand

Siehe Modell und Reasoning-Aufwand weiter unten.

Aktionen

Die Tools, die dieser Agent aufrufen kann. Siehe Tools und Aktionen weiter unten.

Wissensdateien

Dateien, die der Agent per Retrieval (RAG) durchsuchen kann. Siehe Wissensdateien weiter unten.

Benutzerkonfigurationsfelder

Felder, die jeder Benutzer für sich selbst ausfüllt, um das Verhalten des Agenten anzupassen, ohne den Agenten selbst zu verändern. Siehe Benutzerspezifische Konfiguration weiter unten.

Sichtbarkeit und Mitglieder

Wer auf den Agenten zugreifen darf. Siehe Sichtbarkeit und Teilen weiter unten.

Modell und Reasoning-Aufwand#

Jeder Agent ist fest an ein einzelnes Modell und einen Anbieter gebunden. Welche Modelle verfügbar sind, hängt von Ihrer Bereitstellung ab – Ihr Administrator entscheidet, welche erscheinen, daher gibt es keine festen Modellnamen in dieser Anleitung.

Für Modelle, die erweitertes Reasoning unterstützen, erscheint ein Dropdown Reasoning-Aufwand:

Die Reasoning-Aufwand-Einstellung wird beim Agenten gespeichert. Sie gilt nur für Modelle, die tatsächlich einen Reasoning-Kanal unterstützen; bei Standardmodellen hat sie keine Wirkung.

Die Anweisungen schreiben#

Das Anweisungsfeld ist das wichtigste Feld im Builder. Schreiben Sie klar und präzise. Einige Grundsätze:

• Geben Sie die Rolle des Agenten oben an: „Sie sind ein Besprechungs-Zusammenfasser für ein Rechtsteam."
• Legen Sie das Ausgabeformat fest: „Antworten Sie immer mit einer Aufzählung von Aktionspunkten gefolgt von einer Prosaübersicht."
• Setzen Sie Sprachregeln: „Antworten Sie in der Sprache, in der der Benutzer schreibt."
• Geben Sie an, was der Agent nicht tun soll: „Spekulieren Sie niemals über Rechtsberatung."

Optimieren schreibt Ihren Entwurf in eine qualitativ hochwertigere Version um. Der Vorschlag wird neben Ihrem Original angezeigt. Klicken Sie auf Übernehmen, um Ihren Entwurf zu ersetzen, oder auf Verwerfen, um das Bisherige zu behalten – nichts ändert sich, bis Sie sich entschieden haben.

Aus Vorlage öffnet die Bibliothek der Prompt-Vorlagen. Wählen Sie eine Vorlage aus, füllen Sie alle {{Variable}}-Aufforderungen aus, die die Vorlage verlangt, und entscheiden Sie dann, ob Sie das, was bereits im Feld steht, ersetzen oder die Vorlage anhängen möchten.

Tools und Aktionen#

Tools werden im Builder als Aktionen bezeichnet. Sie ermöglichen einem Agenten mehr, als nur mit Text zu antworten. Öffnen Sie die Aktionsauswahl (klicken Sie auf + Aktion hinzufügen), um nach Kategorie zu stöbern.

Integrierte Fähigkeiten

Integrationen

Der Abschnitt Integrationen listet verbundene externe Tools auf, die Ihrem Arbeitsbereich zur Verfügung stehen (beispielsweise Microsoft Outlook oder ein Dokumentenmanagementsystem). Das Hinzufügen einer Integration gibt dem Agenten Zugang zu den Aktionen dieser Tools. Die am häufigsten verwendeten Integrationen werden zuerst aufgelistet.

Sub-Agenten

Im Abschnitt Sub-Agenten können Sie andere Agenten als Mitarbeiter einbinden, an die dieser Agent Aufgaben delegieren kann. Siehe Sub-Agenten weiter unten.

Wissensdateien#

Wissensdateien bilden eine dauerhafte, durchsuchbare Bibliothek, die dem Agenten angehängt ist. Wenn ein Benutzer eine Frage stellt, durchsucht der Agent die Dateien und zitiert die relevantesten Passagen in seiner Antwort – dies nennt sich Retrieval oder RAG.

So fügen Sie eine Wissensdatei hinzu: Ziehen Sie eine Datei per Drag-and-Drop in den Wissensdateibereich oder klicken Sie auf die Upload-Schaltfläche. Dateien werden im Hintergrund verarbeitet und indiziert. Ein rotierender Indikator zeigt die laufende Verarbeitung an; ein Bereit-Indikator erscheint, wenn die Datei durchsucht werden kann.

Wissensdateien werden bei jeder Antwortrunde durchsucht, wenn die Aktion Dateisuche aktiviert ist. Sie unterscheiden sich von Kontextdateien – Kontextdateien werden vollständig eingefügt, während Wissensdateien durchsucht werden und nur die relevanten Fragmente in die Antwort einfließen.

Kontextdateien#

Kontextdateien sind Referenzdokumente, deren vollständiger Inhalt bei jeder Antwortrunde in die Anweisungen des Agenten eingefügt wird. Anders als Wissensdateien (die durchsucht und in Fragmenten zitiert werden) sind Kontextdateien immer vollständig präsent – stellen Sie sie sich als festen Wissensspeicher vor, den der Agent stets vor sich hat.

Verwenden Sie Kontextdateien für kurzes, stets relevantes Material: einen Stilleitfaden, ein Glossar, eine Sammlung feststehender Regeln, ein teamspezifisches FAQ. Halten Sie sie kurz. Für größere Dokumentensammlungen verwenden Sie stattdessen Wissensdateien.

Der Tab Kontext im Builder ermöglicht es Ihnen, Kontextdokumente direkt zu verfassen und zu bearbeiten, und zwar mit einem umfangreichen Markdown-Editor mit einem Bearbeiten/Vorschau-Umschalter – demselben Editor wie im Chat-Eingabefeld.

Der Builder-Tab „Kontext" mit dem Markdown-Editor und dem Bearbeiten/Vorschau-Umschalter

Sichtbarkeit und Teilen#

Sichtbarkeitsstufen

Mitglieder zu einem privaten Agenten hinzufügen

Wenn Sie einen privaten Agenten mit Kollegen teilen, erhält jede Person eine von zwei Rollen:

Der Eigentümer hat stets die volle Kontrolle, einschließlich des Löschens des Agenten und der Änderung von Mitgliedsrollen. Ein Mitglied kann sich selbst aus einem Agenten entfernen, der Eigentümer kann sich jedoch nicht selbst entfernen.

Config-Agenten (schreibgeschützt)

Agenten, die aus der Instanzkonfigurationsdatei stammen, tragen im Builder ein Config-Abzeichen. Alle Felder sind schreibgeschützt; die Schaltfläche „Speichern" erscheint nicht. Diese Agenten werden von Ihrem Administrator verwaltet und beim Neustart des Servers neu geladen.

Sub-Agenten (Master–Worker)#

Ein Agent kann Teile einer Aufgabe an andere Agenten delegieren, die als Sub-Agenten eingebunden sind. Der delegierende Agent ist der Master; die von ihm aufgerufenen Agenten sind die Worker. Jeder Sub-Agent erscheint in der Aktionsliste des Masters als eigenes aufrufbares Tool.

Sub-Agenten sind besonders nützlich, wenn eine Aufgabe unterschiedliche Spezialisierungsschritte hat – ein „Meeting Summarizer"-Agent könnte beispielsweise einen „Übersetzer"-Sub-Agenten für mehrsprachige Ausgabe einsetzen und einen „Aktionspunkte-Extraktor"-Sub-Agenten zur Erstellung einer strukturierten Aufgabenliste.

Funktionsweise von Sub-Agenten-Aufrufen

• Der Master sendet einen Freitext-Prompt an jeden Sub-Agenten, den er aufruft.
• Sub-Agenten haben kein Gedächtnis über die Konversationshistorie des Masters – der Master muss alle benötigten Informationen in den von ihm verfassten Prompt aufnehmen.
• Sub-Agenten können innerhalb einer Antwortrunde parallel laufen.
• Sie sind pro Antwortrunde begrenzt – standardmäßig fünf Aufrufe pro Runde, im Tab Erweitert anpassbar.
• Sub-Agenten geben reinen Text zurück, den der Master in seine endgültige Antwort einbezieht.
• Die Verschachtelung ist eine Ebene tief: Ein Sub-Agent kann selbst keine Sub-Agenten haben.

In der Konversation

Jeder Sub-Agenten-Lauf erscheint als aufklappbare Schrittkarte inline in der Assistentennachricht und zeigt:

• Den Namen des Sub-Agenten (oder seinen Anzeigenamen, falls der Eigentümer einen festgelegt hat)
• Den Status: Läuft / Fertig
• Tokenanzahl und Dauer

Klappen Sie eine Karte auf, um den Prompt des Masters an den Sub-Agenten und die vollständige Ausgabe des Sub-Agenten zu sehen.

Sub-Agenten im Builder hinzufügen

1. Klicken Sie im Tab Allgemein auf + Aktion hinzufügen.
2. Wechseln Sie in der Aktionsauswahl zur Kategorie Sub-Agenten.
3. Wählen Sie den Agenten aus, den Sie als Worker einbinden möchten.
4. Der Sub-Agent erscheint in der Aktionsliste. Klicken Sie auf seine Zeile, um einen Verwendungshinweis zu konfigurieren (teilt dem Master mit, wann er ihn aufrufen soll), einen Anzeigenamen (erscheint in der Transkriptkarte) und optionale Modellparameter-Überschreibungen für Aufrufe über diesen Master.

Einen Sub-Agenten löschen

Wenn Sie versuchen, einen Agenten zu löschen, der derzeit als Sub-Agent eines anderen Agenten eingebunden ist, zeigt ein Warndialog die Master-Agenten an, die ihn referenzieren. Sie können:

• Abbrechen und den Sub-Agenten zuerst aus den Master-Agenten entfernen, oder
• Trotzdem löschen wählen, um den Agenten zu erzwingen – die betroffenen Master-Agenten markieren den Slot dann als fehlerhaft, bis Sie sie aktualisieren.

Die Sichtbarkeitsstufe Intern

Setzen Sie die Sichtbarkeit eines Agenten auf Intern, um ihn zu einem Baustein-Agenten zu machen, der nur als Sub-Agent aufgerufen werden kann. Er erscheint nie in der Hauptagenten-Auswahl und kann nicht in einer eigenständigen Konversation gestartet werden.

Formular-Agenten#

Standardmäßig verwendet ein Agent ein Freitext-Eingabefeld. Setzen Sie den Eingabetyp auf Formular, wird das Eingabefeld durch ein strukturiertes Formular ersetzt. Dies ist nützlich, wenn Sie jedes Mal einheitliche, vollständige Eingaben möchten – beispielsweise ein „Meeting Summarizer", der immer nach Datum, Teilnehmern und Rohnotizen fragt, bevor er beginnt.

Unterstützte Feldtypen

Ein Formular im Builder erstellen

1. Suchen Sie im Tab Allgemein den Abschnitt Eingabetyp.
2. Wechseln Sie von Prompt zu Formular.
3. Ein Editor für Formularfelder erscheint. Klicken Sie auf + Feld hinzufügen, um jedes Feld hinzuzufügen.
4. Legen Sie für jedes Feld seine Bezeichnung, den Typ und ob es erforderlich ist fest.
5. Fügen Sie bei Auswahl-Feldern die Liste der Optionen hinzu.
6. Die Live-Vorschau in der rechten Spalte aktualisiert sich sofort und zeigt das Formular so an, wie Benutzer es sehen werden.

Wenn jemand das Formular ausfüllt und auf „Absenden" klickt, werden die Antworten zur ersten Nachricht zusammengestellt und genau wie jede andere Agentenkonversation verarbeitet. Formular-Agenten öffnen sich auf ihrer eigenen dedizierten Ausführungsseite.

Benutzerspezifische Konfiguration#

Manche Agenten müssen von jedem Benutzer eigene Angaben erhalten – beispielsweise ein E-Mail-Assistent, der die E-Mail-Signatur jeder Person benötigt, oder ein Support-Agent, der die bevorzugte Sprache jeder Person kennen muss.

Benutzerkonfigurationsfelder ermöglichen es dem Agenten, diese Eingaben zu deklarieren. Jeder Benutzer füllt seine eigenen Werte aus, die bei jeder Antwortrunde in seine Version der Systemanweisung des Agenten eingefügt werden – ohne dass sich für andere Benutzer etwas ändert.

Für die Benutzerkonfiguration verfügbare Feldtypen

Wie Benutzer ihre Konfiguration ausfüllen

Ein Einstellungsrad-Symbol in der Werkzeugleiste des Chat-Eingabefelds öffnet den Benutzerkonfigurationsbereich. Das Rad ändert seine Farbe, um den Füllstatus anzuzeigen:

• Gelb – Felder sind vorhanden, aber einige sind noch nicht ausgefüllt
• Grün – alle Felder sind ausgefüllt
• Rot – ein Pflichtfeld fehlt

Dasselbe Farbabzeichen erscheint auf dem Agenten-Chip, den Zuletzt-verwendet-Pillen und den @-Erwähnungszeilen im Chat. Wenn ein Benutzer versucht, eine Nachricht zu senden, während ein Pflichtfeld fehlt, öffnet sich der Konfigurationsbereich automatisch und die Runde wird blockiert, bis das Feld gespeichert wurde.

Vorlagengalerie und Klonen#

Jeder Agenten-Eigentümer kann seinen Agenten zur Prüfung in die Vorlagengalerie einreichen. Sobald ein Administrator ihn genehmigt, erscheint die Vorlage im Tab Vorlagen der Agentenseite, wo jeder im Arbeitsbereich:

• Sie durchsuchen und ihre vollständige Konfiguration lesen kann
• Sie direkt ausführen kann, ohne sie zu klonen
• Sie klonen kann, um eine eigene private Kopie zu erstellen

Klonen erstellt eine vollständige Kopie der ausführbaren Konfiguration der Vorlage – einschließlich ihres Sub-Agenten-Teams –, die Ihnen gehört. Der Klon beginnt als privater Entwurf ohne Vorlagenstatus, sodass Sie ihn frei anpassen können, ohne das Original zu beeinflussen. Wenn ein Sub-Agent in der Vorlage einer ist, auf den Sie bereits Zugriff haben, wird er als Verweis behalten; andernfalls wird er ebenfalls vollständig kopiert.

Um einen Agenten als Vorlage einzureichen, öffnen Sie den Builder, öffnen Sie das ⋯-Menü auf der Agentenkarte und wählen Sie Als Vorlage einreichen. Ein Administrator prüft und genehmigt oder lehnt den Antrag ab.

Administratoren können außerdem Verifiziert (Vertrauensabzeichen) und Empfohlen (wird in der Galerie zuerst angezeigt) auf jede genehmigte Vorlage schalten.

Live-Vorschau#

Die rechte Spalte des Builders führt Ihren ungespeicherten Entwurf als echten Chat (oder Formular für Formular-Agenten) aus, damit Sie die Anweisungen vor dem Speichern testen können. Geben Sie eine Nachricht ein und sehen Sie, wie die aktuelle Konfiguration antwortet.

Da der Entwurf noch keine gespeicherte Identität hat, sind zwei Dinge von der Vorschau ausgenommen:

• Sub-Agenten-Aufrufe – Sub-Agenten werden nicht aufgerufen
• Wissensbasis-Retrieval – die Suche in Wissensdateien ist nicht aktiv

Speichern Sie den Agenten und starten Sie eine echte Konversation, um diese Funktionen zu nutzen.

Tab „Evaluierungen"#

Der Tab Evaluierungen ermöglicht es Ihnen, Testdatensätze zu erstellen, den echten Agenten dagegen auszuführen und die Ergebnisse zu prüfen – vollständig innerhalb der Anwendung, ohne externe Tools verwenden zu müssen.

Der Builder-Tab „Evaluierungen"

Was Evaluierungen leisten

Evaluierungstypen

Jeder Testpunkt wird von den für den Agenten aktivierten Evaluatoren bewertet:

Eine Evaluierung durchführen

1. Öffnen Sie den Agenten im Builder und klicken Sie auf den Tab Evaluierungen.
2. Klicken Sie auf Neuer Datensatz und fügen Sie Ihre Testfälle hinzu (Eingabe + erwartete Ausgabe).
3. Klicken Sie auf Ausführen, um einen Evaluierungslauf zu starten.
4. Der Laufstatus wird aktualisiert, während jeder Punkt abgeschlossen wird. Wenn er fertig ist, klicken Sie auf den Lauf, um Ergebnisse pro Punkt zu sehen.

Trace-Viewer

Die Detailansicht für jeden Punkt zeigt die Eingabe, Ausgabe, erwartete Ausgabe und Bewertungen des Agenten. Ein Trace-Diagramm zeigt die vollständige Aufrufsequenz des Laufs, gerendert innerhalb der Anwendung – Sie benötigen keinen Zugang zu externen Beobachtungstools.

Agenten im Chat verwenden#

Sobald ein Agent existiert, ist der Start einer Konversation mit ihm schnell erledigt:

• Öffnen Sie die Befehlspalette (/ im Chat-Eingabefeld oder Strg+K / Cmd+K) und geben Sie den Namen des Agenten ein, oder
• klicken Sie auf eine Agentenkarte auf der Agentenseite, oder
• klicken Sie auf eine Agentenkachel auf der Startseite oder einer Projektseite.

Die Agenten, die Sie zuletzt verwendet haben, erscheinen in der Zuletzt verwendet-Leiste auf der Agentenseite und als Schnellauswahl-Pillen im Chat-Eingabefeld.

Wenn ein Agent aktiv ist:

• Läuft jede Nachricht durch seine Anweisungen, Tools und das fest zugewiesene Modell.
• Die Modellauswahl im Nachrichtenfeld ist auf das Modell des Agenten gesperrt.
• Alle Tool-Aufrufe, die der Agent vornimmt, erscheinen als aufklappbare Karten im Nachrichtenthread.
• Wenn Sie zu einer Konversation zurückkehren, die mit einem Agenten gestartet wurde, wird der Agent automatisch wiederhergestellt.

Tab „Erweitert" – Limits und RAG-Einstellungen#

Der Tab Erweitert enthält technische Einstellungen, die bewusst vom alltäglichen Tab „Allgemein" getrennt sind.

Rekursionslimit pro Antwortrunde

Das Rekursionslimit steuert, wie viele Tool-Aufruf-Runden der Agent pro Antwortrunde erlaubt sind. Eine Runde ist ein Zyklus, bei dem der Agent Tools aufruft, die Ergebnisse erhält und entscheidet, was als Nächstes zu tun ist. Ein höheres Limit erlaubt dem Agenten mehr Arbeit pro Runde; ein niedrigeres Limit hält die Antworten schneller und kostengünstiger.

RAG-Chunk-Strategie (Wissensdateieinstellungen)

Wenn der Agent Wissensdateien hat, können Sie überschreiben, wie diese Dateien für diesen Agenten speziell in durchsuchbare Stücke aufgeteilt werden. Lassen Sie diese Felder leer, um die Arbeitsbereichs-Standardwerte zu verwenden.

Der Builder-Tab „Erweitert" mit Rekursionslimit, Dateiverarbeitung, Sichtbarkeit und Chunk-Strategie

Sub-Agenten-Limits

Wenn der Agent Sub-Agenten eingebunden hat, können Sie Folgendes steuern:

Fehlerbehebung#

Häufig gestellte Fragen#

F: Kann ich denselben Agenten in mehreren Projekten verwenden? A: Ja. Setzen Sie die Sichtbarkeit des Agenten auf Admin-global (nur Administratoren) oder teilen Sie ihn mit den betreffenden Personen als Privat-Agent mit Mitgliedern. Der Agent ist dann für diese Benutzer zugänglich, unabhängig davon, in welchem Projekt sie arbeiten.

F: Was ist der Unterschied zwischen Wissensdateien und Kontextdateien? A: Wissensdateien werden durchsucht und nur die relevantesten Passagen werden in die Antwort einbezogen (Retrieval). Kontextdateien werden bei jeder Antwortrunde vollständig eingefügt, unabhängig von der Frage. Verwenden Sie Kontextdateien für kurzes, stets relevantes Material (Stilleitfäden, Glossare); verwenden Sie Wissensdateien für große Dokumentensammlungen.

F: Kann ich die Konfiguration eines Agenten exportieren oder importieren? A: Ja. Klicken Sie in der Builder-Kopfzeile auf YAML importieren, um eine Konfiguration aus einer YAML-Datei zu laden, oder verwenden Sie die Exportoption, um den Agenten als YAML herunterzuladen. Dies ist nützlich für die Sicherung von Agenten oder deren Übertragung zwischen Arbeitsbereichen. Config-Agenten (mit dem Config-Abzeichen) können nicht über die Benutzeroberfläche exportiert werden.

F: Was passiert, wenn ich einen Agenten lössche, den jemand anderes verwendet? A: Bestehende Konversationen, die den Agenten verwendet haben, werden nicht gelöscht – ihre History bleibt erhalten. Neue Konversationen mit diesem Agenten sind nicht mehr möglich.

F: Kann ein Agent sich selbst als Sub-Agent aufrufen? A: Nein. Zirkuläre Sub-Agenten-Verweise werden beim Speichern der Agentenkonfiguration blockiert.

F: Warum ist die Modellauswahl gesperrt, wenn ich mit einem Agenten chatte? A: Agenten weisen ein bestimmtes Modell fest zu, damit ihr Verhalten konsistent ist. Der Agenten-Eigentümer hat das Modell im Builder gewählt. Wenn Sie ein anderes Modell benötigen, starten Sie einen normalen Chat ohne Auswahl eines Agenten.

F: Kann ich einen Agenten aus der Vorlagengalerie ausprobieren, ohne ihn zu klonen? A: Ja. Klicken Sie im Tab Vorlagen auf Verwenden bei einer genehmigten Vorlage, um direkt eine Konversation damit zu starten. Klonen Sie ihn nur, wenn Sie ihn anpassen möchten.

F: Wie viele Sub-Agenten kann ein Master-Agent haben? A: Es gibt kein festes Limit für die Anzahl der eingebundenen Sub-Agenten. Es gibt ein Aufruf-Limit pro Runde (Standard 5) und ein Token-Limit pro Runde (Standard 50.000 Token), um unkontrollierte Auffächerung zu verhindern. Beide sind im Tab Erweitert anpassbar.

F: Warum sehe ich ein Einstellungsrad auf dem Agenten-Chip? A: Der Agent hat benutzerspezifische Konfigurationsfelder – Eingaben, die für Sie spezifisch sind, wie Ihre E-Mail-Signatur oder eine bevorzugte Sprache. Klicken Sie auf das Rad, um Ihre Werte einzugeben. Ein Pflichtfeld, das nicht ausgefüllt ist, blockiert das Senden von Nachrichten, bis es vervollständigt wurde.

F: Wer kann Vorlagengalerie-Einreichungen genehmigen? A: Nur Administratoren können Vorlagen-Einreichungen genehmigen oder ablehnen. Nachdem Sie einen Agenten eingereicht haben, prüft ein Administrator ihn und genehmigt ihn, um ihn für alle in der Galerie sichtbar zu machen.

Weiterführend: Chatten · Projekte · Dateien & Wissen · Integrationen · Einstellungen