ag-ui

ag-ui

https://github.com/ag-ui-protocol/ag-ui?tab=readme-ov-file

AG-UI: The Agent-User Interaction Protocol

AG-UI is an open, lightweight, event-based protocol that standardizes how AI agents connect to user-facing applications. Built for simplicity and flexibility, it enables seamless integration between AI agents, real time user context, and user interfaces.

Features

• 💬 Real-time agentic chat with streaming
• 🔄 Bi-directional state synchronization
• 🧩 Generative UI and structured messages
• 🧠 Real-time context enrichment
• 🛠️ Frontend tool integration
• 🧑‍💻 Human-in-the-loop collaboration

 

https://docs.ag-ui.com/introduction

AG-UI Overview

 

​https://docs.ag-ui.com/sdk/python/core/overview

https://docs.ag-ui.com/sdk/python/encoder/overview

 

The Agent–User Interaction (AG-UI) Protocol

AG-UI is an open, lightweight, event-based protocol that standardizes how AI agents connect to user-facing applications. Built for simplicity and flexibility, it standardizes how agent state, UI intents, and user interactions flow between your model/agent runtime and user-facing frontend applications—to allow application developers to ship reliable, debuggable, user‑friendly agentic features fast while focusing on application needs and avoding complex ad-hoc wiring.

---

​

 

Building blocks (today & upcoming)

Streaming chat

Live token and event streaming for responsive multi turn sessions, with cancel and resume.

Multimodality

Typed attachments and real time media (files, images, audio, transcripts); supports voice, previews, annotations, provenance.

Generative UI, static

Render model output as stable, typed components under app control.

Generative UI, declarative

Small declarative language for constrained yet open-ended agent UIs; agents propose trees and constraints, the app validates and mounts.

Shared state

(Read-only & read-write). Typed store shared between agent and app, with streamed event-sourced diffs and conflict resolution for snappy collaboration.

Thinking steps

Visualize intermediate reasoning from traces and tool events; no raw chain of thought.

Frontend tool calls

Typed handoffs from agent to frontend-executed actions, and back.

Backend tool rendering & side effects

Visualize backend tool outputs in app and chat, emit side effects as first-class events.

Interrupts (human in the loop)

Pause, approve, edit, retry, or escalate mid flow without losing state.

Sub-agents and composition

Nested delegation with scoped state, tracing, and cancellation.

Agent steering

Dynamically redirect agent execution with real-time user input to guide behavior and outcomes.

Tool output streaming

Stream tool results and logs so UIs can render long-running effects in real time.

Custom events

Open-ended data exchange for needs not covered by the protocol.

---

 

视频讲解

https://www.bilibili.com/video/BV1k6EPzjECG/?vd_source=57e261300f39bf692de396b55bf8c41b

 

在线体验

https://dojo.ag-ui.com/langgraph-fastapi/feature/shared_state