← Quick Notes
DL
Duyet Le
Aug 17, 2026
System prompt vs tool schema
Should the system prompt describe each tool?
No. The model already gets tools as their own field: name, description, JSON schema. Reprinting that list in the system prompt just costs tokens and goes stale.
Use the split:
- Tool description — what it does, how to call it, when this tool applies or must not.
- System prompt — who wins, what order, what never happens. Policy, not a catalog.
- Code / middleware — hard stops the model will skip if you only write them in prose.
If a tool never appears in the prompt and still gets called, that is working as designed.