> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Chat

> Conversations, bookmarks, forking, multi-conversation, and sharing chats in ClickHouse Agents

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

export const galaxyOnClick = eventName => () => {
  try {
    if (typeof window !== "undefined" && window.galaxy && eventName) {
      window.galaxy.track(eventName, {
        interaction: "click"
      });
    }
  } catch (e) {}
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>Beta</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                Beta feature. 
                <u>
                    <a href="/docs/beta-and-experimental-features#beta-features">
                        Learn more.
                    </a>
                </u>
            </span>
        </div>;
};

The chat surface in ClickHouse Agents handles conversations, branching, side-by-side comparison, and sharing.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/TCLsdkFwl4CgDiNY/images/cloud/agent-builder/chat/chat.png?fit=max&auto=format&n=TCLsdkFwl4CgDiNY&q=85&s=1e3b4593c3655276965c0381728db32a" alt="ClickHouse Agent chat surface showing the left navigation, the agent identity header, and the message composer" size="lg" width="3836" height="1938" data-path="images/cloud/agent-builder/chat/chat.png" />

<h2 id="conversations">
  Conversations
</h2>

Start a new conversation by clicking the compose icon in the left navigation.
Select the agent you wish to use from the Agent selector dialogue at the top left of the conversation window - by default the **ClickHouse Agent** is selected.
You can now type your message in the composer, and press send. Each conversation is saved to your sidebar history and can be reopened, renamed, or deleted later.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/TCLsdkFwl4CgDiNY/images/cloud/agent-builder/chat/conversation.png?fit=max&auto=format&n=TCLsdkFwl4CgDiNY&q=85&s=77bda86b7d95fa7012b3bde654f7d411" alt="Chat surface with the compose icon highlighted in the left navigation, the sidebar showing the Chats history with a saved Top 10 Tables Ranked conversation, and the composer with a sample question typed" size="lg" width="3838" height="1934" data-path="images/cloud/agent-builder/chat/conversation.png" />

You can edit any of your messages in place, and the agent will regenerate its response from that point in the conversation history.
You can also regenerate the agent's last response only, without re-sending your message.

<h2 id="bookmarks">
  Bookmarks
</h2>

Bookmark a message or a whole conversation to flag it for quick retrieval. Bookmarks are private to you and survive conversation renames.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/TCLsdkFwl4CgDiNY/images/cloud/agent-builder/chat/bookmark.png?fit=max&auto=format&n=TCLsdkFwl4CgDiNY&q=85&s=c2a71bb84f2499dee4228f32b4a65996" alt="Chat header with the bookmark icon highlighted and an Add Bookmarks tooltip visible" size="lg" width="3836" height="1938" data-path="images/cloud/agent-builder/chat/bookmark.png" />

<h2 id="forking">
  Forking
</h2>

Forking creates a new conversation branched from a specific message. You can use it to explore an alternative path without disrupting the original thread.
There are three fork modes available:

* **Visible messages only** - lets you copy the direct path to the forked message.
* **Include related branches** - lets you copy the main path plus any existing branches.
* **Include all to here** - lets you copy everything up to the forked message.

Forked conversations are independent, so changes don't sync back to the original.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/TCLsdkFwl4CgDiNY/images/cloud/agent-builder/chat/fork.png?fit=max&auto=format&n=TCLsdkFwl4CgDiNY&q=85&s=03633bff285d355b75fb0af3adaa000b" alt="Select a fork option dialog showing three fork mode icons, Start fork here and Remember checkboxes, and the message action toolbar below" size="lg" width="3836" height="1938" data-path="images/cloud/agent-builder/chat/fork.png" />

<h2 id="multi-conversation">
  Multi-conversation
</h2>

Multi-conversation runs two conversations side-by-side and sends the same prompt to both. Use it to compare responses across models or to A/B test different agent configurations.

Click the **+** button in the chat header to spawn a parallel conversation alongside the current one.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/TCLsdkFwl4CgDiNY/images/cloud/agent-builder/chat/multi-conversation.png?fit=max&auto=format&n=TCLsdkFwl4CgDiNY&q=85&s=9c2ec4ea5964f62bc64b901b00df3d83" alt="Chat header with the Add multi-conversation button highlighted, and a + ClickHouse Agent indicator above the composer" size="lg" width="3836" height="1938" data-path="images/cloud/agent-builder/chat/multi-conversation.png" />

The two conversations then sit side-by-side and receive the same prompt:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/TCLsdkFwl4CgDiNY/images/cloud/agent-builder/chat/multi-conversation-2.png?fit=max&auto=format&n=TCLsdkFwl4CgDiNY&q=85&s=74e195bae69bf79bd56e8788f01ecf2a" alt="Multi-conversation view with two ClickHouse Agent conversations running side by side, both executing the same run_select_query tool calls" size="lg" width="3836" height="1938" data-path="images/cloud/agent-builder/chat/multi-conversation-2.png" />

<h2 id="sharing-chats">
  Sharing chats
</h2>

Generate a shareable link for any conversation to send it to a teammate or save it for reference. Recipients see a read-only view, including artifacts and visible branches. You can revoke a link from the sharing dashboard at any time.

Edits to existing messages appear in the shared view; messages added after the link was generated do not.

To share a conversation, open its menu in the sidebar and select **Share**:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/TCLsdkFwl4CgDiNY/images/cloud/agent-builder/chat/share.png?fit=max&auto=format&n=TCLsdkFwl4CgDiNY&q=85&s=58156bd36a9d5b2180c4a4c810aef147" alt="Conversation menu in the sidebar with Share, Rename, Duplicate, Archive, and Delete options visible" size="lg" width="3838" height="1934" data-path="images/cloud/agent-builder/chat/share.png" />

Then click **Create link** in the share dialog:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/TCLsdkFwl4CgDiNY/images/cloud/agent-builder/chat/share-modal.png?fit=max&auto=format&n=TCLsdkFwl4CgDiNY&q=85&s=5adab4a1a10a937f1567efbd78085c83" alt="Share link to chat dialog with the Create link button and a note that your name and any messages added after sharing stay private" size="md" width="1098" height="424" data-path="images/cloud/agent-builder/chat/share-modal.png" />
