Design an agent's tools
Specifies the tools an agent needs: names, descriptions, parameters and failure modes the model can use well.
Use it when
Giving an LLM agent access to your API or data.
What you fill in
- agent What the agent should accomplish
- apis The APIs or actions available
The prompt
Design the tool set for an agent that should agent. Available actions: apis 1. The minimum set of tools (fewer, higher-level tools beat many thin ones). For each: name, a description written for the model (when to use it and when not), JSON schema for parameters with descriptions, and what it returns. 2. Errors each tool can return, written so the model knows how to recover. 3. Which tools need human approval and why. 4. Three example tasks traced step by step through the tools. Before you answer, check your draft against every instruction above and fix anything that misses.
Why it works
- Descriptions written for the model, including when not to use a tool.
- Recoverable error messages.
- Approval gates on risky actions.