Skip to content

Commit 7850c00

Browse files
committed
docs: move hardware note to bottom, condense sessions and MCP sections
- Hardware disclaimer no longer kills momentum after the hero intro - Sessions + keyboard shortcuts merged into one compact section - MCP section reduced to card links — power users click through
1 parent b264914 commit 7850c00

1 file changed

Lines changed: 28 additions & 38 deletions

File tree

docs/guides/agent-ui.mdx

Lines changed: 28 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -20,10 +20,6 @@ gaia-ui
2020

2121
Everything installs automatically — Python, the AI model, the backend. No accounts, no API keys, no cloud. Just your machine.
2222

23-
<Note>
24-
**Tested on AMD Ryzen AI MAX+ 395** with the **Qwen3.5-35B-A3B-GGUF** model via Lemonade Server. Other hardware or model combinations may work but are not officially verified. If you encounter issues, please [open a GitHub issue](https://github.com/amd/gaia/issues/new) with your processor model, RAM, LLM model, and OS.
25-
</Note>
26-
2723
---
2824

2925
## What You Can Do
@@ -57,38 +53,6 @@ Drag files into the chat — or just ask the agent to find them. It indexes the
5753
>
5854
> *"What's the total spend in this expense report?"*
5955
60-
### Keep Conversations Organized
61-
62-
Sessions let you separate work by topic — one for your tax documents, another for a code review, a third for research. You can:
63-
64-
- **Create** a new session from the sidebar
65-
- **Rename** sessions by clicking the title
66-
- **Search** across all sessions with `Ctrl+K`
67-
- **Export** as Markdown or JSON
68-
- **Delete** with confirmation
69-
70-
Sessions sync between the CLI (`gaia chat`) and the Agent UI — start in one, pick up in the other.
71-
72-
### Extend with External Tools (MCP)
73-
74-
Connect external MCP servers to give the agent access to GitHub, Slack, databases, and more:
75-
76-
```bash
77-
gaia mcp add time "uvx mcp-server-time"
78-
```
79-
80-
Or expose the Agent UI itself as an MCP server — letting Claude Code, Cursor, or any MCP client drive GAIA agents programmatically. Conversations appear in the UI in real time.
81-
82-
<CardGroup cols={2}>
83-
<Card title="Use as MCP Server" icon="server" href="/guides/mcp/agent-ui">
84-
Let external AI tools control GAIA agents through 15 built-in tools
85-
</Card>
86-
87-
<Card title="Add MCP Clients" icon="plug" href="/guides/mcp/client">
88-
Connect external services to extend the agent's capabilities
89-
</Card>
90-
</CardGroup>
91-
9256
---
9357

9458
## Install
@@ -195,14 +159,36 @@ Or expose the Agent UI itself as an MCP server — letting Claude Code, Cursor,
195159

196160
---
197161

198-
## Keyboard Shortcuts
162+
## Sessions and Shortcuts
163+
164+
Sessions let you organize conversations by topic. They sync between the CLI (`gaia chat`) and the Agent UI — start in one, pick up in the other. Export any session as Markdown or JSON from the session menu.
199165

200166
| Shortcut | Action |
201167
|----------|--------|
202168
| `Enter` | Send message |
203169
| `Shift+Enter` | New line |
204170
| `Escape` | Stop agent response |
205-
| `Ctrl+K` | Focus sidebar search |
171+
| `Ctrl+K` | Search across sessions |
172+
173+
---
174+
175+
## Extend with MCP
176+
177+
The agent supports the **Model Context Protocol** in both directions — connect external tools to expand what the agent can do, or expose the Agent UI itself so other AI tools can drive it.
178+
179+
<CardGroup cols={2}>
180+
<Card title="Add Tools to the Agent" icon="plug" href="/guides/mcp/client">
181+
Connect GitHub, Slack, databases, and more via MCP servers
182+
</Card>
183+
184+
<Card title="Expose Agent UI to Other Tools" icon="server" href="/guides/mcp/agent-ui">
185+
Let Claude Code, Cursor, or any MCP client control GAIA agents
186+
</Card>
187+
</CardGroup>
188+
189+
<Warning>
190+
Misconfigured MCP servers can cause slow responses. If you experience timeouts, check `~/.gaia/mcp_servers.json` and remove any servers you don't need. See [Troubleshooting](#llm-response-times-out-or-fails) for details.
191+
</Warning>
206192

207193
---
208194

@@ -325,6 +311,10 @@ For the REST API reference and backend classes, see the [Agent UI SDK Reference]
325311

326312
---
327313

314+
<Note>
315+
**Hardware:** Tested on AMD Ryzen AI MAX+ 395 with Qwen3.5-35B-A3B-GGUF via Lemonade Server. Other configurations may work — [report issues here](https://github.com/amd/gaia/issues/new).
316+
</Note>
317+
328318
<small style="color: #666;">
329319

330320
**License**

0 commit comments

Comments
 (0)