ag-ui-protocol / ag-ui-protocol/ag-ui
Clarify tool event behavior of fronted and backend
- Dominant language
- Python
- Stars
- 15.9k
- Forks
- 1.4k
- Avg merge
- 1d 17h
- Merged PRs (30d)
- 163
Description
The current AG-UI tool calling protocol mixes two distinct modes:
1. The tool call is actually executed by the backend/remote side, and events are synchronized to the frontend for display purposes only.
2. The tool call is executed by the frontend/client side, with results returned to the backend/remote side — similar to Human-in-the-Loop (HITL).
However, the current protocol specification does not clearly distinguish between these two modes. How should developers differentiate between them? The documentation should be improved to clarify this.
Additionally, for function calls, parameters should support the `dict` type for greater clarity and precision. Relying solely on `string` types introduces unnecessary serialization/deserialization overhead.
Contributor guide
Assessment
This issue has not been assessed yet.