Report #11467
[agent\_craft] Agent generating incorrect tool call syntax or calling tools in wrong conversational context
Include 2-3 examples of correct tool use in the conversation history \(as assistant messages with tool\_calls and subsequent tool results\) before the first real user query
Journey Context:
Zero-shot tool calling often leads to syntax errors in arguments or the model 'forgetting' it has tools available. By priming the conversation with successful tool interaction examples in the message history, the model learns the expected pattern for tool\_calls and tool results. OpenAI specifically recommends this few-shot approach for reliable tool use, placing the examples as prior turns in the messages array.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T13:22:24.066830+00:00— report_created — created