Skip to content

docs(realtime): note tool schema strictness limits#3143

Closed
adityasingh2400 wants to merge 1 commit intoopenai:mainfrom
adityasingh2400:docs/realtime-tool-schema-limits-1681
Closed

docs(realtime): note tool schema strictness limits#3143
adityasingh2400 wants to merge 1 commit intoopenai:mainfrom
adityasingh2400:docs/realtime-tool-schema-limits-1681

Conversation

@adityasingh2400
Copy link
Copy Markdown
Contributor

Summary

  • Clarify that realtime function tools receive SDK-generated schemas, but strict tool-schema enforcement is not the same as Responses API function tools.
  • Recommend flat realtime tool argument shapes or validating richer JSON payloads inside the tool before side effects.

Test plan

  • uv run mkdocs build
  • git diff --check

Closes #1681.

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label May 6, 2026
@seratch
Copy link
Copy Markdown
Member

seratch commented May 6, 2026

I don't think using complex inputs for tools that could be called by realtime agents is a realistic use case, so I'd like to hold off adding this section.

@seratch seratch closed this May 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Calling MCP server tools with nested object params from Realtime API agents

2 participants