KI-Agent erstellen: Aufgabe, Werkzeuge, Tests und Betrieb planen

Einen KI-Agenten erstellen heisst, einer Anwendung ein begrenztes Ziel, ausgewählte Werkzeuge und kontrollierte Handlungsmöglichkeiten zu geben. Vor dem Aufbau muss feststehen, welche Aufgabe sie bearbeitet, wann sie stoppt und wer Ergebnisse freigibt. Nicht jede Aufgabe braucht einen Agenten: Ein fester Workflow ist leichter abzugrenzen, wenn die Schritte bereits bekannt sind.

Diese Anleitung beschreibt die Architektur und Abnahme eines ersten Agenten für Unternehmen. Sie ist kein ausführbares Code-Tutorial. Das Beispiel ist fiktiv und kein getestetes Kundenprojekt. Produktfunktionen und technische Schnittstellen müssen bei der konkreten Umsetzung anhand der Herstellerdokumentation geprüft werden.

KI-Agent oder fester Workflow?

Anthropic unterscheidet vorgegebene Workflows von Agenten, bei denen das Modell Arbeitsschritte und Werkzeugnutzung selbst steuert. Die Empfehlung des Herstellers ist, mit einfachen, passenden Ansätzen zu beginnen. Quelle: Building effective agents.

Der Begriff "Agent" allein verspricht keine bessere Ergebnisqualität. Vergleiche den Aufbau mit der einfacheren Lösung an denselben Fällen.

Schritt 1: Einen eng begrenzten Job definieren

Das fiktive Beispiel ist eine interne Recherche zu einer Servicefrage. Der Agent darf freigegebene Handbücher durchsuchen, gefundene Stellen gegenüberstellen und einen Antwortentwurf für eine Fachkraft erstellen. Er darf keine Geräte bedienen, keine Bestellung auslösen und keine Kundenantwort versenden.

Beschreibe das Ergebnis vor der Werkzeugwahl: eine Antwort mit Quellenfassung, Belegstelle und offenen Punkten. Ist keine passende Quelle vorhanden, muss der Agent dies melden. Eine plausible Vermutung ist kein Ersatz für das fehlende Handbuch.

Schritt 2: Eingaben und Rechte festlegen

Der Eingang enthält die Servicefrage, das betroffene Produkt und gegebenenfalls die Version. Fehlt eine notwendige Angabe, fragt die Anwendung nach oder gibt den Fall zur Klärung zurück.

Der Agent erhält ausschliesslich die erforderlichen Leserechte. Inhalte, die der anfragenden Person nicht zugänglich sind, dürfen nicht über die Antwort sichtbar werden. Diese Kontrolle muss beim Datenabruf durchgesetzt und mit unterschiedlich berechtigten Testkonten geprüft werden.

Ein Prompt wie "zeige keine vertraulichen Daten" reicht dafür nicht. Auch ein rein lesender Agent kann Informationen unzulässig weitergeben, wenn die Quellenfreigabe fehlt.

Schritt 3: Werkzeuge mit klaren Ein- und Ausgaben verbinden

Jedes Werkzeug braucht eine dokumentierte Aufgabe, zulässige Eingaben und einen definierten Fehlerfall. Die Suche liefert beispielsweise Dokumentkennung, Fassung und Fundstelle. Ein fehlgeschlagener Abruf liefert einen Fehlerstatus statt einer erfundenen leeren Antwort.

Für die Wissensanbindung beschreibt Retrieval Augmented Generation die Grundlagen. Die Anwendung muss auch den Fall behandeln, dass Suche oder Abruf ausfallen.

Schritt 4: Einen begrenzten Arbeitsablauf bauen

Der Agent prüft zuerst, ob die Eingabe ausreicht. Danach sucht er passende Quellen, liest deren Kontext und erstellt den Entwurf. Er hält fest, welche Informationen fehlen oder sich widersprechen. Die Fachkraft entscheidet über die Verwendung.

Lege Grenzen für Laufzeit, Werkzeugaufrufe und Kosten fest. Wenn die Grenze erreicht ist, endet der Lauf mit einem nachvollziehbaren Status. Wiederholte Suche ohne neue Information ist kein Fortschritt.

Die erlaubten Aktionen müssen auch technisch begrenzt sein. Anweisungen in einem gefundenen Dokument bleiben Dokumentinhalt; sie dürfen keine neuen Rechte oder Werkzeuge aktivieren. Der Systemauftrag allein bietet dafür keine vollständige Absicherung.

Schritt 5: Fehlerfälle vor der Freigabe prüfen

Die Abnahmekriterien legt die fachliche und technische Verantwortung vor dem Test fest. Eine feste Zahl an Testfällen beweist keine Qualität. Massgeblich ist, ob die relevanten Aufgaben, schwierigen Fälle und Fehlerfolgen abgedeckt sind.

Prüfe Quelle und Aussage getrennt: Ein existierender Link belegt nicht automatisch den danebenstehenden Satz. Die Checkliste zur Ergebnisprüfung hilft bei der fachlichen Kontrolle.

Schritt 6: Betrieb und Änderungen vorbereiten

Vor der Übergabe braucht der Ablauf einen Verantwortlichen, eine Fehlermeldung und einen Stoppweg. Dokumentiere, wie eine Fachkraft einen Entwurf korrigiert und was bei einem Ausfall der Suche passiert.

Halte die verwendeten Fassungen von Vorlage, Modellkonfiguration und Werkzeugen fest. Nach Änderungen wiederholt ihr die betroffenen Tests. Protokolle müssen die Fehlersuche ermöglichen, ohne unnötig vertrauliche Inhalte zu sammeln; der Aufbewahrungsumfang ist betrieblich zu klären.

Mit welchem Werkzeug einen KI-Agenten bauen?

Die Auswahl hängt an den benötigten Schnittstellen und Kontrollen. Eine visuelle Workflow-Anwendung kann einen klaren Ablauf abbilden. Eine eigene Anwendung ist eine Option, wenn Zustände, Rechte oder Tests besondere Anforderungen stellen. Prüfe jeweils den tatsächlichen Funktionsumfang und die Wartbarkeit im Team.

Die Entscheidungshilfe zu ChatGPT, Make und n8n ordnet den Integrationsbedarf ein. Ein Frameworkwechsel löst keinen unklaren Auftrag und keine fehlende Quelle.

Was Aufwand und Nutzen bestimmt

Zur Einrichtung gehören Prozessklärung, Datenzugriff, Werkzeuge, Testfälle und Bedienung. Im Betrieb zählen Modellaufrufe, Infrastruktur, fachliche Prüfung und Pflege. Eine allgemeine Zusage "produktiv in sechs Wochen" lässt sich daraus nicht ableiten.

Für den ersten Pilot ist das Ziel eine belastbare Entscheidung: Erfüllt der Agent die Aufgabe innerhalb seiner Grenzen besser als die einfachere Alternative? Wenn das Team vor allem einen vorhandenen Assistenten besser nutzen muss, beginnt die Arbeit mit Mitarbeiterbefähigung. Für einen technischen Job hilft die Pilot-Entscheidungsvorlage.

Häufige Fragen

Wann braucht eine Aufgabe einen KI-Agenten?

Wenn unterschiedliche Schritte oder Werkzeuge abhängig vom Fall gewählt werden müssen. Bei bekannten festen Schritten prüfe zuerst einen Workflow oder eine begleitete Vorlage.

Ist die Anleitung ein ausführbares Code-Tutorial?

Nein. Sie beschreibt Architekturentscheidungen und Abnahme. Die technische Umsetzung muss anhand der gewählten Schnittstellen entwickelt und getestet werden.

Welche Tests braucht der erste Agent?

Prüfe vollständige Fälle, fehlende Angaben, widersprüchliche Quellen, Ausfälle, fremde Dokumentanweisungen, unzulässige Zugriffe und doppelte Eingänge. Der genaue Umfang folgt der Aufgabe.