ag-ui-protocol / ag-ui-protocol/ag-ui

Clarify tool event behavior of fronted and backend

Open
#381 6 comments 4 reactions 0 assignees View on GitHub
documentation
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

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.