Agents

Agents sind konfigurierbare KI-Assistenten, die Fragen beantworten, Tools ausführen und Arbeit in Ihrer Organisation automatisieren. Es gibt zwei Typen:

Chat (konversationell) — spricht mit Benutzern in der Chat- und Sprachoberfläche.
Workflow (funktional) — führt strukturierte Aufgaben mit definierten Ein- und Ausgaben aus; Workflow-Agents können außerdem Tools implementieren und per API aufgerufen werden.

Agent-Liste

Öffnen Sie Admin > Agents, um alle Agents zu sehen. Von der Liste aus können Sie:

Create Agent — öffnet einen neuen Agent im Editor.
Open — einen bestehenden Agent bearbeiten.
Duplicate — einen Agent als Ausgangspunkt kopieren.
Delete — einen Agent entfernen. Ist der Agent mit Tools verknüpft, erscheint eine Warnung.

Der Node-Graph-Editor

Jeder Agent öffnet sich in einem visuellen Editor: einer Arbeitsfläche mit verbundenen Konfigurations-Nodes. Bearbeiten Sie einen Node und klicken Sie auf Save, um Ihre Änderungen zu speichern, oder auf Back, um den Editor zu verlassen.

Veröffentlichungszustände

Ein Auswahlfeld im Editor steuert, wer den Agent verwenden kann:

Zustand	Bedeutung
Draft	Nur Admins können ihn testen.
Private	Nur die Erstellerin bzw. der Ersteller kann ihn nutzen.
Live	Für alle in der Organisation verfügbar.

Lassen Sie Agents während der Entwicklung in Draft, wechseln Sie für den persönlichen Gebrauch zu Private, und stellen Sie auf Live, sobald der Agent für die gesamte Organisation bereit ist.

Konfigurations-Nodes

Settings

Der Settings-Node enthält die Kernkonfiguration des Agents:

Type — Chat oder Workflow.
Internal name — technischer Bezeichner.
Chat/Display name — der Name, den Benutzer sehen.
Description — was der Agent tut.
Text model — Qualitätsstufe: Budget, Balanced oder Pro. Höhere Stufen kosten mehr Credits pro Lauf.
Call budget — die maximale Anzahl an Zügen, die der Agent in einem Lauf ausführen darf.
Dynamic tool calls — wenn aktiviert, kann der Agent bei Bedarf verfügbare Tools finden und nutzen, über die explizit zugewiesenen hinaus.

Manche Agents werden von nara verwaltet und zentral aktualisiert. Bei verwalteten Agents beschränkt sich die Konfiguration auf einen textbasierten Custom appendix, der Ihre Anweisungen über die verwaltete Definition legt; Reset customizations entfernt ihn. Selbst erstellte Agents sind vollständig bearbeitbar.

Persona

Wählen Sie eine Persona, die Ton und Kommunikationsstil des Agents bestimmt. Suchen Sie nach einer Persona oder entfernen Sie die Auswahl mit Clear.

Task

Eine Freitextbeschreibung der Aufgabe des Agents. Sie ist die zentrale Anweisung, die dem Agent sagt, was er erreichen soll.

Skills

Eine Liste von Skill-Einträgen, jeweils mit Titel und optionaler Beschreibung, die Fähigkeiten beschreiben, die der Agent anwenden soll.

Operating Protocol

Ein Graph aus Phasen, der den Agent Schritt für Schritt durch strukturierte Prozesse führt. Siehe Operating protocols.

Tools

Tools zuweisen oder entfernen, die der Agent aufrufen darf, mit Konfiguration pro Tool. Siehe Tools.

Resources

Referenzdokumente (Title + Content) anhängen, die der Agent bei der Arbeit heranziehen kann.

Input-/Output-Datentypen (Workflow)

Workflow-Agents deklarieren die Datentypen, die sie als Eingabe akzeptieren und als Ausgabe zurückgeben, und werden dadurch wie Funktionen aufrufbar.

Test Console (Workflow)

Workflow-Agents enthalten im Editor eine Test Console: Geben Sie JSON-Argumente ein, klicken Sie auf Execute Test und prüfen Sie das Ergebnis — ohne den Editor zu verlassen.

Call this agent via API

Der Dialog Call this agent via API zeigt, wie der Agent programmatisch aufgerufen wird: die Endpoint-URL, die erforderlichen Header und kopierfertige Codebeispiele. Zur Token-Einrichtung siehe API-Authentifizierung.

Ask-Me Assistant

Statt Nodes von Hand zu bearbeiten, können Sie den gewünschten Agent in natürlicher Sprache beschreiben. Der Ask-Me Assistant erstellt aus Ihrer Beschreibung einen überprüfbaren Vorschlag — einen Diff über Phasen, Tools und Metadaten —, den Sie prüfen und mit Apply auf den Agent anwenden können.