@devries-cameron20 / composio Mirror · read-only
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 03:37 UTC

next
mdx 46 lines 3.12 KB
Raw
1 ---
2 title: 'Free-Form Arguments Reach Execution in AutoGen, Google ADK, and OpenAI Agents'
3 description: 'The Python AutoGen and Google ADK providers no longer drop free-form tool arguments, and OpenAI Agents stops telling the model that open arguments are closed'
4 date: '2026-10-20'
5 ---
6
7 A tool argument that accepts arbitrary keys, such as an object with no `properties`, `additionalProperties: true`, or `patternProperties`, could reach your tool as `{}` in the Python AutoGen and Google ADK providers. No input error was raised, so the tool ran with different arguments from the ones the model sent.
8
9 LangChain, LangGraph, and CrewAI were fixed in Python `0.19.0` (see [Free-Form Object Arguments Are Preserved Across SDKs](/docs/changelog/2026/08/06)). This release covers the remaining agentic providers.
10
11 ### Bug Fixes
12
13 - **AutoGen** (`composio-autogen`): both runtime paths, `autogen_core` tools and AG2's `register_tools`, now pass every key the tool schema allows to execution and validate it with the same rules as LangChain and CrewAI. The advertised tool schema now marks the top-level object as open when the source schema does.
14 - **Google ADK** (`composio-google-adk`): top-level keys the tool schema allows are no longer filtered down to named parameters, and arguments are validated before execution.
15 - **OpenAI Agents** (`composio-openai-agents`): the advertised top-level schema keeps the source's `additionalProperties` instead of always setting it to `false`. A schema that declares no properties is advertised as open, matching the TypeScript provider.
16
17 **Before:**
18
19 ```python
20 # tool comes from Composio(provider=AutogenProvider()).tools.get(...)
21 # its input schema is {"type": "object", "properties": {}}
22 await tool.run_json({"filters": {"status": "open"}}, CancellationToken())
23 # The tool executed with {}
24 ```
25
26 **After:**
27
28 ```python
29 await tool.run_json({"filters": {"status": "open"}}, CancellationToken())
30 # The tool executes with {"filters": {"status": "open"}}
31 ```
32
33 ### Behavior Change for AutoGen and Google ADK
34
35 <Callout type="warn">
36 AutoGen and Google ADK now validate tool arguments against the tool's JSON schema, as LangChain, LangGraph, and CrewAI already do. Calls that used to succeed after the provider silently dropped or converted a value now return an error result to the agent: `{"successful": false, "error": "...", "data": null}`.
37 </Callout>
38
39 - An unknown top-level key on a schema that declares properties and omits `additionalProperties` is rejected instead of dropped.
40 - A value of the wrong type, such as `"5"` for an integer, is rejected instead of converted.
41 - An optional argument the model leaves out is no longer sent as `""`, `0`, or `{}`. The schema's declared default applies instead.
42 - An invalid `patternProperties` or schema-valued `additionalProperties` raises when the tool is wrapped.
43
44 ### Known Limitation
45
46 On Google ADK and on AutoGen's AG2 `register_tools` path, the tool declaration is still built from named parameters. A tool whose whole argument object is free-form is therefore not advertised to the model as open, so the model may not send those keys. Free-form objects nested under a declared argument work on every provider.