Verlässliche Tool-Aktionen entwerfen

In der Ausführungsbeschreibung erklärst du, wann der Agent ein Tool verwenden soll. Nenne die benötigten Angaben und beschreibe, was er nach Erfolg oder bei einem Fehler sagen soll.

Ausführungsbeschreibung schreiben

Für einen Rückrufwunsch:

Nutze create_callback_request, sobald Name, Anliegen und bevorzugte
Rückrufnummer bekannt und bestätigt sind. Übermittle die bestätigten Werte.
Erfinde keine fehlenden Felder. Bestätige die Übermittlung erst bei Erfolg.
Bei einem Fehler erkläre, dass die Übermittlung nicht bestätigt werden konnte,
und nutze den eingerichteten Ausweichweg. Wiederhole einen Schreibvorgang
nicht automatisch, ohne den Erfolg der ersten Anfrage zu prüfen.

Ersetze create_callback_request durch den Namen deines Tools. Beschreibe einen konkreten nächsten Schritt für Fehlerfälle, etwa eine alternative Kontaktmöglichkeit. Lege die Pflichtangaben zusätzlich im Eingabeschema fest.

Eingaben eindeutig machen

Gib jedem Feld einen eindeutigen Namen, den passenden Datentyp und eine kurze Beschreibung. Wähle für Rufnummern String und für Ja/Nein-Angaben Boolean. Hinterlege Zugangsdaten in der Zugangsdatenverwaltung.

Benenne bei dynamischen E-Mail- oder Weiterleitungszielen die vertrauenswürdige Quelle. Ein vom Anrufer gewünschtes Ziel allein berechtigt nicht dazu, private Daten oder Anrufe beliebig weiterzuleiten.

Ergebnis behandeln

Ergebnis	Verhalten des Agenten
Bestätigter Erfolg	Die tatsächlich abgeschlossene Aktion benennen.
Fehlende Eingabe	Die fehlende Angabe erfragen.
Kein Treffer	Das fehlende Ergebnis erklären und sinnvoll nachfragen.
Fehler oder Timeout	Den gemeldeten Fehler erklären. Fehlt ein eindeutiges Ergebnis, keine Aussage über Erfolg oder Misserfolg treffen und den vorgesehenen nächsten Schritt anbieten.

Lass Im Hintergrund ausführen deaktiviert, wenn der Agent auf das Ergebnis warten soll. Bei API-, MCP- und Websuche-Tools kannst du eine kurze Fortschrittsmeldung aktivieren. Der Agent formuliert sie passend zum Gespräch.

Gesamten Ablauf testen

Teste eine erfolgreiche Anfrage, fehlende Angaben und einen Fehler. Prüfe jeweils die übermittelten Daten, das Ergebnis im Zielsystem und die Antwort des Agenten. Die API-Tool-Anleitung beschreibt das Testpanel. Mit Antwort-Mapping legst du fest, welche Daten der Agent erhält.