OpenAI (Responses API): optional tool parameters are treated as required

DEV TMS AI Studio
1

In TTMSMCPCloudAITools.ToJSON (TMS AI Studio 2.0.1.0), for aiOpenAI the tool schema includes "additionalProperties": false but no "strict" field. When strict is omitted, the Responses API normalizes the schema to strict mode whenever possible. In strict mode all properties become required, so parameters with Required := False are always sent by the model, filled with 0, "" or false. The tool receives these filler values as if they were real filters (e.g. max_number = 0 returns no records), and it returns wrong results without any error.

Reference: https://developers.openai.com/api/docs/guides/function-calling (strict mode section).

Suggested fix: send "strict": false (or add a property to control it). Alternatively, in strict mode, declare optional parameters with type ["", "null"] and list them in required.

We currently patch it on TTMSMCPCloudAITools.ToJSON by adding ,"strict": false after the tool description when Service = aiOpenAI.

Thanks in advance

2

Thanks for your feedback. That is a good suggestion and we added a new property to control the strict setting for the OpenAI & compatible APIs. Next update will have this improvement.