Tool Description Writer: Clear Schemas for an Agent's Functions

Write function descriptions an agent can use correctly.

Added October 15, 2026. Written with AI assistance and checked for clarity and placeholders; not reviewed by a lawyer, accountant, clinician or other professional. How these prompts are made

The Open buttons send the prompt text as currently shown below to that site only when you click. Fill in the placeholders first.

Write clear tool descriptions for an agent. The tools and what they do: [TOOL_LIST]. For each tool, the real parameters and their types: [PARAMETERS]. Known pitfalls: [PITFALLS].

For every tool produce: a one-sentence description starting with a verb; when to use it and when not to; each parameter with type, allowed values, an example, and whether required; what the tool returns, including error shapes; side effects (does it send, delete or charge?); and a warning line for irreversible actions. Add an 'order of use' note where tools depend on each other. Review the set for overlap between tools, ambiguous names, parameters with similar names, and missing error cases, and propose renamed tools if needed. Provide JSON schema blocks for two of the tools and a table comparing the tools at a glance.

Test the descriptions by writing five user requests and showing which tool the agent should call and with which arguments, plus one request where it should call none.

Fill in before use

Optional: type your details and the prompt above updates. Nothing is saved or sent.

Replace each bracketed placeholder with your own details, then paste into Any AI or another assistant.

search_orders: Finds customer orders by email or order number. Use when the user asks about an existing order; do not use for product questions.
Parameters: email (string, optional); order_number (string, optional, format AB-12345); at least one is required.
Returns: a list of up to 10 orders with status; error {code: 'not_found'} when none match.
Side effects: none (read only).
Test request: 'Where is my order AB-55120?' calls search_orders with order_number 'AB-55120'. 'What colours does the jacket come in?' calls no tool.

• json-output