What is a tool schema?

Definition

A schema can name each argument, specify its type and distinguish required values from optional ones. This lets the application check a proposed call before passing it to the tool.

A clear schema helps an agent form valid requests. It complements runtime permissions and broader checks because a well-formed call can still be unauthorized or inappropriate for the task.

ELI5

For example, a calendar-search tool could require a date and accept an optional person. A schema tells the assistant what information belongs in each field.

The calendar app can reject a missing or badly formatted date before sending the search.

Does a schema tell an agent which tool to choose?

It describes how an individual tool is called. A description, router or task instructions can help determine when the tool is useful.

Can a tool schema enforce permission?

It can reject malformed input. The service handling the call must still enforce permission to perform the action.

  1. Sohail Shaikh and Ankush Rastogi in plain T-shirts beside the words Agent Tool Routing on black.
Definition card for tool schema: What is a tool schema?

A tool schema describes the inputs an application expects when an AI system requests a tool action.