Was macht ein gutes Tool aus?
Gut gestaltete Tools sind die Grundlage fähiger KI-Agenten. Schema, Benennung und Dokumentation eines Tools beeinflussen direkt, wie zuverlässig ein LLM es nutzen kann.
Design-Prinzipien
Befolge diese Prinzipien, um Tools zu erstellen, die Agenten effektiv nutzen können.
Klare Benennung
Verwende beschreibende, eindeutige Namen. "search_web" ist besser als "sw" oder "query".
Explizite Parameter
Jeder Parameter sollte einen klaren Typ, eine Beschreibung und Einschränkungen haben.
Vorhersehbare Ausgaben
Gib konsistente, strukturierte Antworten zurück. Fehlermeldungen in die Ausgabe einbeziehen.
Minimaler Umfang
Jedes Tool sollte eine Sache gut machen. Bevorzuge viele fokussierte Tools statt weniger komplexer.
Schema-Design
Tool-Schemas sagen dem LLM, wie es deine Tools verwenden soll. Gute Schemas verhindern Fehler.
Gutes Schema
{
"name": "search_web",
"description": "Das Web nach einer Suchanfrage durchsuchen.",
"parameters": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Die Suchanfrage."
},
"max_results": {
"type": "integer",
"description": "Maximale Anzahl der Ergebnisse.",
"minimum": 1,
"maximum": 10,
"default": 5
}
},
"required": [
"query"
],
"additionalProperties": false
}
}Schlechtes Schema
{
"name": "sw",
"parameters": {
"q": { "type": "string" },
"n": { "type": "number" }
}
}Fehlerbehandlung
Tools sollten Fehler elegant behandeln und informative Meldungen zurückgeben, auf die das LLM reagieren kann.
Tool-Schema-Builder
Erstelle und validiere Tool-Schemas interaktiv
Den Toolvertrag definieren
Dieser Editor prüft den unterstützten JSON-Schema-Teilumfang. Namen müssen eindeutig sein; parameterlose Tools sind gültig. Aussagekräftige Beschreibungen sind eine separate redaktionelle Empfehlung. Strikte Anbietermodi können zusätzliche Regeln verlangen.
Parameter
Generiertes Schema
{
"name": "search_web",
"description": "Das Web nach einer Suchanfrage durchsuchen.",
"parameters": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Die Suchanfrage."
}
},
"required": [
"query"
],
"additionalProperties": false
}
}Wichtige Erkenntnisse
- 1Tool-Design beeinflusst direkt die Agenten-Zuverlässigkeit
- 2Explizite Schemas mit Beschreibungen verhindern LLM-Verwirrung
- 3Gib strukturierte Fehler zurück, die der Agent verstehen und darauf reagieren kann
- 4Teste Tools mit verschiedenen Eingaben, um Randfälle zu finden