poka-yoke
Designing something so the wrong use is impossible or obvious, a term from Japanese manufacturing for mistake-proofing.
In more detail
Anthropic applies it to tools for agents: change parameters so mistakes are hard to make, for example by requiring absolute file paths instead of relative ones. A tool that cannot be called wrongly beats a description that warns against it.
Related terms
- tool definition — The name, description and JSON Schema for its input that tell a model what a tool does and how to call it.
- actionable error — An error message written for the model that says what failed and how to fix the call, so its retry can succeed.
Taught in
- Designing Tools A Model Can Use — AI Engineering: LLM Apps, RAG & Agents