Name: Towards AI Legal Name: Towards AI, Inc. Description: Towards AI is the world's leading artificial intelligence (AI) and technology publication. Read by thought-leaders and decision-makers around the world. Phone Number: +1-650-246-9381 Email: pub@towardsai.net
228 Park Avenue South New York, NY 10003 United States
Website: Publisher: https://towardsai.net/#publisher Diversity Policy: https://towardsai.net/about Ethics Policy: https://towardsai.net/about Masthead: https://towardsai.net/about
Name: Towards AI Legal Name: Towards AI, Inc. Description: Towards AI is the world's leading artificial intelligence (AI) and technology publication. Founders: Roberto Iriondo, , Job Title: Co-founder and Advisor Works for: Towards AI, Inc. Follow Roberto: X, LinkedIn, GitHub, Google Scholar, Towards AI Profile, Medium, ML@CMU, FreeCodeCamp, Crunchbase, Bloomberg, Roberto Iriondo, Generative AI Lab, Generative AI Lab VeloxTrend Ultrarix Capital Partners Denis Piffaretti, Job Title: Co-founder Works for: Towards AI, Inc. Louie Peters, Job Title: Co-founder Works for: Towards AI, Inc. Louis-François Bouchard, Job Title: Co-founder Works for: Towards AI, Inc. Cover:
Towards AI Cover
Logo:
Towards AI Logo
Areas Served: Worldwide Alternate Name: Towards AI, Inc. Alternate Name: Towards AI Co. Alternate Name: towards ai Alternate Name: towardsai Alternate Name: towards.ai Alternate Name: tai Alternate Name: toward ai Alternate Name: toward.ai Alternate Name: Towards AI, Inc. Alternate Name: towardsai.net Alternate Name: pub.towardsai.net
5 stars – based on 497 reviews

Frequently Used, Contextual References

TODO: Remember to copy unique IDs whenever it needs used. i.e., URL: 304b2e42315e

Resources

Free: 6-day Agentic AI Engineering Email Guide.
Learnings from Towards AI's hands-on work with real clients.
How to Design Tool Schemas That Prevent Bad LLM Tool Calls
Artificial Intelligence   Latest   Machine Learning

How to Design Tool Schemas That Prevent Bad LLM Tool Calls

Last Updated on July 6, 2026 by Editorial Team

Author(s): Shahidullah Kawsar

Originally published on Towards AI.

AI Engineer Interview Preparation


A large e-commerce company is adding an AI assistant that can search products, compare prices, check inventory, and create support tickets. The first draft has one tool named search with a description that only says search records. During testing, the model sometimes searches customers when the user asks about products and sometimes searches products when the user asks about tickets. What is the best schema improvement?

How to Design Tool Schemas That Prevent Bad LLM Tool Calls

After a set of MCQ-style scenarios, the article explains that reliable LLM tool use comes from designing tight, explicit tool schemas: split capabilities into narrow tools with clear boundaries and descriptions, use enumerations or strongly typed parameters to prevent invalid arguments, and require clarification (or safe validation errors) when inputs like identities or time are ambiguous. It emphasizes least-privilege and safety for destructive or sensitive actions by accepting constrained identifiers (not arbitrary paths) and keeping dangerous powers inside trusted application code. It also highlights structured, user-safe error responses for tool failures, domain-specific naming that scales as tool catalogs grow, architectural patterns like routing/dynamic tool loading to reduce candidate overlap, restrictive parameter types for consistent filtering, and schema testing focused on realistic ambiguous/underspecified requests rather than only happy paths.

Read the full blog for free on Medium.

Join thousands of data leaders on the AI newsletter. Join over 80,000 subscribers and keep up to date with the latest developments in AI. From research to projects and ideas. If you are building an AI startup, an AI-related product, or a service, we invite you to consider becoming a sponsor.

Published via Towards AI


Towards AI Academy

We Build Enterprise-Grade AI. We'll Teach You to Master It Too.

15 engineers. 100,000+ students. Towards AI Academy teaches what actually survives production.

Start free — no commitment:

6-Day Agentic AI Engineering Email Guide — one practical lesson per day

Agents Architecture Cheatsheet — 3 years of architecture decisions in 6 pages

Our courses:

AI Engineering Certification — 90+ lessons from project selection to deployed product. The most comprehensive practical LLM course out there.

Agent Engineering Course — Hands on with production agent architectures, memory, routing, and eval frameworks — built from real enterprise engagements.

AI for Work — Understand, evaluate, and apply AI for complex work tasks.

Note: Article content contains the views of the contributing authors and not Towards AI.