KI-Agenten: Werkzeuge eindeutig beschreiben

Zwei Personen prüfen an einem Laptop drei schematische Werkzeugkarten für Suche, Lagerbestand und Entwurf.
KI-generiertes Symbolbild mit fiktiven Personen und einer schematischen Benutzeroberfläche.

Ein KI-Agent soll einen Lagerbestand prüfen. Er findet drei Funktionen: „Artikel“, „Bestand“ und „Auftrag“. Welche davon liefert die verfügbare Menge? Und welche verändert bereits etwas? Wenn diese Unterschiede unklar bleiben, beginnt die Fehlersuche oft am falschen Ende: beim Modell statt bei der Beschreibung seiner Werkzeuge.

Für Deinen nächsten Agentenversuch lohnt sich deshalb ein kleiner Vorabtest. Beschreibe drei Werkzeuge so, dass eine fachkundige Kollegin sie ohne Rückfragen unterscheiden kann. Prüfe anschließend mit fiktiven Aufgaben, ob auch die KI die passende Auswahl trifft.

Was mit einem Werkzeug gemeint ist

Ein Werkzeug ist hier eine aufrufbare Funktion: etwa einen Artikel suchen, einen Bestand abfragen oder einen Reservierungsentwurf anlegen. Die verwendete Plattform legt fest, welche Funktionen verfügbar sind. Nicht jedes KI-Angebot erlaubt Dir, ihre Beschreibung selbst zu bearbeiten. Bei eigenen Integrationen kann Dein IT-Team sie häufig gestalten; bei fertigen Produkten kannst Du Unklarheiten zumindest erkennen und dokumentieren.

Anthropic empfiehlt für Agenten wenige gezielt ausgewählte Werkzeuge mit unterscheidbaren Aufgaben. Klare Namen, verständliche Beschreibungen und passende Rückgaben gehören dabei zusammen. Überlappende Funktionen können die Auswahl erschweren. Die Herstellerempfehlung liefert einen Ausgangspunkt, keinen Erfolgsnachweis für Deinen konkreten Prozess. Quelle: Anthropic, Werkzeugdesign für Agenten.

Ein fiktives Lagerbeispiel

Stell Dir einen Schulungsbetrieb mit erfundenen Artikeln vor. Ein Agent soll Auskünfte vorbereiten. Für den Versuch gibt es drei gedachte Werkzeuge, keine Verbindung zu einem echten Warenwirtschaftssystem:

  • Artikel suchen: Findet Artikelnummer und Bezeichnung anhand eines Suchbegriffs. Liefert keine Bestände und verändert keine Daten.
  • Bestand lesen: Benötigt eine eindeutige Artikelnummer und einen Lagerort. Liefert die dort aktuell frei verfügbare Stückzahl samt Abrufzeit. Reserviert keine Ware.
  • Reservierungsentwurf erstellen: Benötigt Artikelnummer, Lagerort und Stückzahl. Erzeugt ausschließlich einen Entwurf für eine spätere menschliche Prüfung. Verändert den verfügbaren Bestand nicht und sendet nichts.

Diese Beschreibungen sind Übungsmaterial. Sie behaupten keine vorhandene Funktion eines bestimmten Anbieters. Gerade der letzte Punkt ist im echten System zu prüfen: Ein Feld namens „Entwurf“ garantiert nicht, dass im Hintergrund keine weiteren Aktionen stattfinden.

Fünf Angaben für Deine Werkzeugbeschreibung

Nutze für die Besprechung mit Fachbereich und IT eine kurze Vorlage. Unsere folgende Arbeitsvorlage ist eine praktische Empfehlung, keine vorgeschriebene Norm.

1. Zweck: Welches konkrete Ergebnis liefert die Funktion? „Liest die frei verfügbare Stückzahl für einen Artikel an einem Lagerort“ ist genauer als „Verwaltet Bestände“.

2. Benötigte Eingaben: Was muss vor dem Aufruf feststehen? Im Beispiel sind es Artikelnummer und Lagerort. Ein Produktname kann mehrere Varianten meinen. Eine Rückfrage ist dann besser als eine erfundene Zuordnung.

3. Rückgabe: Welche Informationen kommen zurück? Vereinbare verständliche Felder wie Artikelnummer, Lagerort, verfügbare Stückzahl und Abrufzeit. Kläre auch, wie „kein Treffer“ und ein technischer Fehler auseinanderzuhalten sind.

4. Wirkung: Liest die Funktion nur oder verändert sie Daten? Entstehen ein Entwurf, eine verbindliche Reservierung oder eine Nachricht? Halte jede zusätzliche Wirkung ausdrücklich fest.

5. Grenze: Wann passt das Werkzeug nicht? „Keine Lieferterminzusage“ macht die Grenze sichtbar: Eine vorhandene Menge ist noch keine Zusage für den Kunden. Technische Rechte und Prüfungen müssen solche Grenzen zusätzlich absichern.

Bei MCP, einem Protokoll zur Anbindung von Werkzeugen, umfasst die Werkzeugdefinition unter anderem Name, Beschreibung und ein Schema für Eingaben. Die Spezifikation verlangt außerdem Eingabeprüfung und Zugriffskontrollen auf Serverseite. Eine gut formulierte Beschreibung ersetzt diese technische Absicherung nicht. Quelle: MCP-Tools-Spezifikation, Version 2025-11-25.

Kopierbarer Prompt für einen Trockenlauf

Teste zunächst nur die Auswahl. Verwende einen freigegebenen KI-Chat und keine echten Kunden- oder Zugangsdaten. Der folgende Prompt simuliert Werkzeuge in Textform; er richtet keine Integration ein.

„Prüfe diese vollständig fiktiven Arbeitsaufträge. Du hast keine realen Werkzeuge und darfst keine Aktion ausführen.

Gedachte Werkzeuge:
A: Artikel suchen. Eingabe: Suchbegriff. Ausgabe: passende Artikelnummern und Bezeichnungen. Keine Bestände, keine Änderungen.
B: Bestand lesen. Eingaben: eindeutige Artikelnummer und Lagerort. Ausgabe: frei verfügbare Stückzahl und Abrufzeit. Keine Reservierung und keine Lieferterminzusage.
C: Reservierungsentwurf erstellen. Eingaben: Artikelnummer, Lagerort, Stückzahl. Ausgabe: Entwurf zur menschlichen Prüfung. Keine Bestandsänderung und kein Versand.

Arbeitsaufträge:
1. Wie viele Stück von Artikel T-104 sind in Lager Nord frei verfügbar?
2. Haben wir den Adapter in Blau?
3. Bereite für Artikel T-104, Lager Nord, drei Stück als Reservierungsentwurf vor.
4. Sage dem Kunden zu, dass morgen zehn Stück ankommen.
5. Prüfe den Bestand von T-104.

Nenne je Auftrag das passende Werkzeug oder die notwendige Rückfrage. Wenn mehrere Schritte nötig sind, zeige deren Reihenfolge. Erfinde keine Bestände, Artikelzuordnungen oder Liefertermine. Kennzeichne Aufgaben, die keines der Werkzeuge abdeckt. Antworte kurz mit Auftrag, Auswahl und einem Satz Begründung.“

Woran Du eine brauchbare Antwort erkennst

Lege die erwartete Auswahl vor dem Test fest. Für unsere Übung gilt:

  • Auftrag 1 passt zu B. Artikelnummer und Lagerort sind vorhanden.
  • Auftrag 2 beginnt mit A. Bei mehreren blauen Adaptern muss zuerst die Variante geklärt werden; für eine anschließende Bestandsprüfung fehlt außerdem der Lagerort.
  • Auftrag 3 passt zu C. Ein erstellter Entwurf wäre noch keine ausgeführte Reservierung.
  • Auftrag 4 ist durch keines der Werkzeuge abgedeckt. Bestand allein belegt keinen Liefertermin; auch ein Versandwerkzeug fehlt.
  • Auftrag 5 erfordert die Rückfrage nach dem Lagerort.

Dies sind erwartete Übungsantworten, keine berichteten Testergebnisse. Vergleiche sie mit Deiner tatsächlichen Ausgabe. Schreibe auf, wo eine Zuordnung falsch war oder eine Rückfrage fehlte. Ändere anschließend gezielt eine unklare Beschreibung und teste erneut, auch mit anders formulierten Aufträgen.

Vom Trockenlauf zur echten Anwendung

Der Texttest zeigt, ob Beschreibungen verständlich sind. Er belegt nicht, dass eine technische Integration richtig arbeitet. Lass im nächsten Schritt in einer getrennten Testumgebung prüfen, welche Funktion tatsächlich aufgerufen wird, welche Daten sie erhält und was sie verändert.

Wähle dafür einen überschaubaren Prozess mit eindeutig prüfbarem Ergebnis. Du möchtest einen solchen Anwendungsfall mit Deinem Team vorbereiten? Hier findest Du unsere Formate zu KI-Agenten.

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert

Dieses Feld ist ein Pflichtfeld

Dieses Feld ist ein Pflichtfeld

Dieses Feld ist ein Pflichtfeld

Bei der Übermittlung Ihrer Nachricht ist ein Fehler aufgetreten. Bitte versuchen Sie es erneut.

Sicherheitsüberprüfung

Ungültiger Captcha-Code. Versuchen Sie es erneut.

Information icon

Wir benötigen Ihre Zustimmung zum Laden der Übersetzungen

Wir nutzen einen Drittanbieter-Service, um den Inhalt der Website zu übersetzen, der möglicherweise Daten über Ihre Aktivitäten sammelt. Bitte überprüfen Sie die Details in der Datenschutzerklärung und akzeptieren Sie den Dienst, um die Übersetzungen zu sehen.