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": "Search the web for information",
"parameters": {
"query": {
"type": "string",
"description": "The search query",
"required": true
},
"max_results": {
"type": "integer",
"description": "Maximum results (1-10)",
"default": 5
}
}
}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
Tool-Name
Define your tool's identity
Parameters
2 parameters defined
Generiertes Schema
JSON Schema output
{
"name": "search_web",
"description": "Search the web for information on a given query",
"parameters": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "The search query"
},
"max_results": {
"type": "number",
"description": "Maximum number of results to return (1-10)"
}
},
"required": [
"query"
]
}
}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