AI Glossary

Tool schema

Also called tool definition

What does “Tool schema” mean?

Tool schema: Machine-readable description of a tool that tells a model what the tool does, which inputs it accepts and in what format, often written as JSON Schema. Clear names and descriptions strongly affect whether the model picks the right tool and fills it in correctly.

Tool schema visual guide: Machine-readable description of a tool that tells a model what the tool does, which inputs it accepts and in what format, often written as JSON Schema. Clear names and descriptions strongly affect whether the model picks the right tool and fills it in correctly.
Visual guide Open full size (new tab)

What is an example of “Tool schema”?

A vague description like "does stuff with files" leads to misuse; "deletes one file at the given path" sets clear expectations.