Skip to main content

Overview

Every agent comes with a beautiful web UI out of the box. The interface supports both static customization (header/intro) and native UI components that stream rich content progressively to users.

Default Web UI

When you deploy your agent, it automatically gets a web interface accessible at your agent’s URL. The default UI includes:
  • Chat Interface: A modern, responsive chat interface
  • Message History: Automatic conversation history management
  • Real-time Streaming: Support for streaming responses
  • Native UI Components: Rich components like thinking bubbles, code blocks, tables, and more
  • Mobile Responsive: Works seamlessly on all devices
  • Auto RTL Support: Automatically supports right-to-left languages

Native UI Components

Cycls provides native UI components that render beautifully in the chat interface. Simply yield structured objects to display rich content that streams progressively.

Text

Plain strings are rendered as markdown text with full formatting support.

Thinking Bubbles

Show your agent’s reasoning process with collapsible thinking bubbles.

Code Blocks

Display syntax-highlighted code with language detection.

Tables

Stream tables row-by-row for progressive rendering.

Callouts

Display styled callout boxes for important information.
Available styles: success, warning, info, error

Images

Display images with optional captions.

Status Indicators

Show progress or status updates during long operations.

Component Reference

Header and Intro Customization

You can also customize the header and introduction sections using HTML and TailwindCSS:

Styling Guidelines

  • HTML Support: Full HTML5 support with inline styles
  • TailwindCSS: Complete TailwindCSS framework available
  • Raw Tags: Wrap custom HTML in <raw> tags to prevent escaping
  • Responsive Design: Use TailwindCSS responsive classes for mobile compatibility
  • Clickable Links: Use urllib.parse.quote to encode messages in links
Create clickable links that automatically send encoded text to the chat:

Custom Frontend Applications

You can connect any custom frontend to your agent using the OpenAI-compatible API at /chat/completions or the Cycls Protocol at /chat/cycls.

Next Steps

Agent API

Learn about the built-in REST API and streaming protocols.