KURZ ERKLÄRT
Ein gutes Agentenwerkzeug beschreibt Zweck, Eingaben, Nebenwirkungen und überprüfbare Ergebnisse so klar, dass der nächste Schritt daraus hervorgeht. Entwerft Werkzeuge rund um konkrete Aufgaben und begrenzte Datenbereiche. Eine technische Schnittstelle allein erklärt einem Agenten weder, wann ihre Nutzung angebracht ist, noch wie er mit unvollständigen Antworten oder einem unklaren Ausführungszustand umgehen soll.
Wie ihr einzelne KI-Anwendungen in verlässliche Marketingabläufe einordnet, zeigt der übergeordnete Guide KI-Transformation im B2B-Marketing: Von einzelnen Prompts zu verlässlichen Abläufen.
Benennt Zweck und Nichtzuständigkeit
Ein Werkzeug namens Datensatz aktualisieren ist weniger eindeutig als einen freigegebenen CRM-Feldvorschlag übernehmen. Beschreibt, wann das Werkzeug gebraucht wird und welche ähnlich klingenden Aufgaben es nicht erledigt. Vermeidet überlappende Werkzeuge ohne erkennbare Unterscheidung. Wenn Lesen, Entwerfen und Ändern getrennte Berechtigungen brauchen, sollten Zweck und Zugang diese Grenzen sichtbar machen. Anthropics Werkzeugleitfaden behandelt klare Beschreibungen und sinnvolle Rückgaben als wichtige Gestaltungsaufgaben. Für euren Prozess müsst ihr zusätzlich festlegen, welches fachliche Ergebnis der Aufruf liefern soll und welche Verantwortlichkeit außerhalb des Werkzeugs bleibt. Mehr dazu im Leitfaden Lesen, Entwerfen, Ändern: Berechtigungen für Marketingagenten.
Macht Eingaben eindeutig und überprüfbar
Nutzt stabile Kennungen, klar beschriebene Felder und explizite Einheiten. Eine Zahl ohne Währung, Zeitraum oder Bezugsgröße ist keine ausreichend definierte Eingabe für eine Änderung. Prüft erlaubte Werte und Datensatzbezug serverseitig, bevor Nebenwirkungen entstehen. Ein Modell soll keinen Namen in eine Kennung umdeuten müssen, wenn mehrere passende Personen existieren. Gebt stattdessen einen eigenen Suchschritt oder eine eindeutige Auswahlmöglichkeit vor. Dokumentiert außerdem, ob fehlende Felder unverändert bleiben, geleert oder abgewiesen werden. Diese Unterschiede müssen im Änderungsauftrag sichtbar sein.
Beschreibt Nebenwirkungen und Vorbedingungen
Gebt an, ob ein Aufruf nur liest, einen Entwurf anlegt oder einen bestehenden Zustand ändert. Verlangt notwendige Freigaben und Versionsbedingungen an der ausführenden Grenze. Eine Beschreibung im Prompt genügt nicht, wenn derselbe Aufruf technisch beliebige Datensätze überschreiben kann. Legt fest, wie sich eine geänderte Zielversion auswirkt: Ein Konflikt sollte den Agenten zur erneuten Prüfung führen, nicht zum stillen Überschreiben. Dokumentiert auch indirekte Folgen wie ausgelöste Benachrichtigungen oder nachgelagerte Workflows, damit die fachliche Prüfung den tatsächlichen Umfang einer Aktion beurteilen kann.
Gebt handlungsfähige Ergebnisse zurück
Eine Rückgabe sollte Ergebniskennung, Ausführungsstatus, relevante Daten und mögliche Einschränkungen enthalten. Unterscheidet vollständig, teilweise, abgelehnt und unklar, soweit die Integration diese Zustände erkennen kann. Fehlertexte sollen einen zulässigen nächsten Schritt erklären, beispielsweise eine Kennung prüfen oder eine fehlende Freigabe beschaffen. Gebt nicht pauschal alle zugänglichen Datensätze zurück, wenn eine begrenzte Suche ausreicht. Große Antwortmengen erhöhen Sucharbeit und können berechtigte Grenzen verdecken. Der Agent muss erkennen können, ob weitere Ergebnisse verfügbar sind und wie er sie gezielt anfordert.
Untersucht einen fiktiven CRM-Aufruf
Ein fiktives Team stellt ein Werkzeug bereit, das einen geprüften Branchenvorschlag für genau einen CRM-Datensatz übernimmt. Der Aufruf enthält Datensatzkennung, erwartete Version, Vorschlagskennung und Freigabereferenz. Bei einer inzwischen geänderten Version meldet das Werkzeug einen Konflikt und führt keine Änderung durch. Im Erfolgsfall liefert es die neue Version und das tatsächlich gespeicherte Feld. Dieses hypothetische Beispiel zeigt einen begrenzten Vertrag. Ein allgemeines Werkzeug mit freiem Textauftrag an die gesamte Datenbank wäre schwerer zu prüfen und würde fachliche Rechte in einer undurchsichtigen Interpretation bündeln.
Prüft Werkzeugverständnis und Ausführung gemeinsam
Testet Aufgaben, bei denen ein Werkzeug nötig ist, und ähnliche Aufgaben, bei denen es nicht verwendet werden sollte. Ergänzt falsche Kennungen, fehlende Freigaben, Konflikte und unklare Rückgaben. Bewertet nicht nur erfolgreiche technische Antworten, sondern auch richtige Werkzeugwahl und korrekte Interpretation des Ergebnisses. Wenn der Agent nach einer Teilantwort fertig meldet, braucht möglicherweise der Vertrag klarere Zustände. Haltet die Tests nach Werkzeugänderungen aktuell. Ein verbesserter Name oder eine präzisere Fehlermeldung kann wirksamer sein als zusätzliche allgemeine Anweisungen im übergeordneten Prompt. Mehr dazu im Leitfaden Regel, Workflow oder Agent: Die richtige Automatisierung wählen.
INTERAKTIV / VOM LESEN ZUR ANWENDUNG
Drei Prüfpunkte für eure Umsetzung
Wähle einen Punkt und halte deinen persönlichen Lesefortschritt fest. Die Häkchen werden weder gespeichert noch übertragen und sind keine Bewertung eures Unternehmens.
PRÜFPUNKT 01
Beschreibt Nebenwirkungen und Vorbedingungen
Gebt an, ob ein Aufruf nur liest, einen Entwurf anlegt oder einen bestehenden Zustand ändert.
Im Artikel vertiefen ↗PRÜFPUNKT 02
Gebt handlungsfähige Ergebnisse zurück
Eine Rückgabe sollte Ergebniskennung, Ausführungsstatus, relevante Daten und mögliche Einschränkungen enthalten.
Im Artikel vertiefen ↗PRÜFPUNKT 03
Untersucht einen fiktiven CRM-Aufruf
Ein fiktives Team stellt ein Werkzeug bereit, das einen geprüften Branchenvorschlag für genau einen CRM-Datensatz übernimmt.
Im Artikel vertiefen ↗Häufige Fragen
Sollte jedes API-Endpunkt ein Agentenwerkzeug werden?
Nein. Wählt Werkzeuge nach sinnvollen Aufgaben und prüfbaren Grenzen, statt alle technischen Funktionen ungefiltert anzubieten.
Reicht ein JSON-Schema?
Es hilft bei der Struktur, erklärt aber fachliche Bedeutung, Nebenwirkungen und Abschlussbedingungen nicht vollständig.
Was gehört in eine Fehlermeldung?
Ein klarer Zustand, der betroffene Teil und ein zulässiger nächster Schritt ohne unnötige interne oder sensible Angaben.
Wie lässt sich „Benennt Zweck und Nichtzuständigkeit“ praktisch umsetzen?
Ein Werkzeug namens Datensatz aktualisieren ist weniger eindeutig als einen freigegebenen CRM-Feldvorschlag übernehmen. Beschreibt, wann das Werkzeug gebraucht wird und welche ähnlich klingenden Aufgaben es nicht erledigt. Vermeidet überlappende Werkzeuge ohne erkennbare Unterscheidung.
Was ist bei „Macht Eingaben eindeutig und überprüfbar“ besonders wichtig?
Nutzt stabile Kennungen, klar beschriebene Felder und explizite Einheiten. Eine Zahl ohne Währung, Zeitraum oder Bezugsgröße ist keine ausreichend definierte Eingabe für eine Änderung. Prüft erlaubte Werte und Datensatzbezug serverseitig, bevor Nebenwirkungen entstehen.
