Skip to content
Agent UI
BlocksConversationWorkspace

ConversationWorkspace

Responsive shell with conversation history and composer. Import from @agent-ui/react or a direct subpath. Tailwind CSS v4 theme tokens are required.

ConversationWorkspace ships with a full API table, a copyable example, and accessibility notes.

tsx
Conversations
What is Agent UI?
Sent
A UI library for building AI agent interfaces with React.
Sent

Installation

Install the package once, then import ConversationWorkspace from its direct entry point or from the root.

bash
pnpm add @agent-ui/react
tsx
import { ConversationWorkspace } from "@agent-ui/react/blocks/conversation";

Tailwind CSS v4 users: add @source "../node_modules/@agent-ui/react/src" to the global stylesheet so the library utilities are generated.

Usage

The example below is the same code that renders the preview. Copy it, swap in your own handlers, and ship.

tsx
import { ConversationWorkspace } from "@agent-ui/react";
 
<ConversationWorkspace messages={[]} conversations={[]} />

API reference

Every prop ConversationWorkspace accepts, its type, default, and behaviour.

API reference for this component
NameTypeDefaultDescription
messagesReact prop—Configuration exposed through the component's public React props.
conversationsReact prop—Configuration exposed through the component's public React props.
activeConversationIdReact prop—Configuration exposed through the component's public React props.
onNewConversationcallback—Configuration exposed through the component's public React props.
onSelectConversationcallback—Configuration exposed through the component's public React props.

Accessibility

Provide explicit action authorization and accessible labels when composing the block.
Use it with the rest of the library

ConversationWorkspace composes with MessageList, ChatShell, useChat, and the provider compose blocks. Browse the full reference or see all components in the gallery.

3 lines · copy-ready