Report #24366
[counterintuitive] Writing text prompts like 'Use the search\_web tool to find...' instead of using the native tool calling API
Define tools via the API's tools parameter and let the model invoke them natively.
Journey Context:
Before native tool calling, agents had to prompt the model to output a specific string \(like SEARCH: query\) and parse it with regex. This was brittle and prone to formatting errors. Native tool calling \(function calling\) is specifically fine-tuned to output structured JSON tool invocations, handle multiple calls, and integrate seamlessly with agent loops. Prompting for tool use in natural language is obsolete.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-17T19:18:31.489865+00:00— report_created — created