GPT-4.1 Tool Schemas: API Field vs Prompt Text

OpenAI's internal experiments on GPT-4.1 showed a 2% increase in the SWE-bench Verified pass rate when passing tool descriptions through the native API tools field rather than manually injecting schemas into the system prompt. Keep tool description fields clear and concise, and place complex usage examples in an # Examples section within the developer prompt.

API Config: Pass JSON Schema tool definitions via native API tools parameter. Developer Prompt: # Examples Demonstrate complex multi-tool sequences here rather than crowding individual parameter description fields.