Skip to content

Commit bcde15c

Browse files
committed
moved technical overview from landing page into architecture as Design Principles
1 parent ed75e9d commit bcde15c

File tree

1 file changed

+29
-1
lines changed

1 file changed

+29
-1
lines changed

docs/concepts/architecture.mdx

Lines changed: 29 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,35 @@ architecture that enables seamless, efficient communication between front-end
88
applications and AI agents. This document covers the core architectural
99
components and concepts.
1010

11-
## Overview
11+
## Design Principles
12+
13+
AG-UI is designed to be lightweight and minimally opinionated, making it easy to
14+
integrate with a wide range of agent implementations. The protocol's flexibility
15+
comes from its simple requirements:
16+
17+
1. **Event-Driven Communication**: Agents need to emit any of the 16
18+
standardized event types during execution, creating a stream of updates that
19+
clients can process.
20+
21+
2. **Bidirectional Interaction**: Agents accept input from users, enabling
22+
collaborative workflows where humans and AI work together seamlessly.
23+
24+
The protocol includes a built-in middleware layer that maximizes compatibility
25+
in two key ways:
26+
27+
- **Flexible Event Structure**: Events don't need to match AG-UI's format
28+
exactly—they just need to be AG-UI-compatible. This allows existing agent
29+
frameworks to adapt their native event formats with minimal effort.
30+
31+
- **Transport Agnostic**: AG-UI doesn't mandate how events are delivered,
32+
supporting various transport mechanisms including Server-Sent Events (SSE),
33+
webhooks, WebSockets, and more. This flexibility lets developers choose the
34+
transport that best fits their architecture.
35+
36+
This pragmatic approach makes AG-UI easy to adopt without requiring major
37+
changes to existing agent implementations or frontend applications.
38+
39+
## Architectural Overview
1240

1341
AG-UI follows a client-server architecture that standardizes communication
1442
between agents and applications:

0 commit comments

Comments
 (0)