> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qxlabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Chat

Chat is where you interact with your agents. The home screen is a chat, ready to go: type a question and press **Enter** to begin. Once a conversation has messages, a **New chat** button appears at the top right to start fresh.

## Pick an agent

Every chat runs against an agent. New chats start with **QX**, the built-in default that's connected to all available tools and knowledge, so you can begin right away.

To use a different one, choose it from the agent grid on the home screen (search by name, or open the full list with **Manage**), or switch from inside the message box: click the agent's name at the bottom, or type **@** to search and choose. Your own agents and the built-in ones are listed separately. You can switch agents in the middle of a conversation, and the next reply comes from the agent you just picked while the history stays put.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/qx-labs/ZJkiVX6zo-84vXkk/images/agents/chat/pick-an-agent-light.png?fit=max&auto=format&n=ZJkiVX6zo-84vXkk&q=85&s=c9f6b8c0c95b0466e2f57c07624ce6cf" alt="The chat home screen with the agent picker open, listing built-in and your agents" width="858" height="608" data-path="images/agents/chat/pick-an-agent-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/qx-labs/ZJkiVX6zo-84vXkk/images/agents/chat/pick-an-agent-dark.png?fit=max&auto=format&n=ZJkiVX6zo-84vXkk&q=85&s=0a2792225eaa56f6446e552eba76ea41" alt="The chat home screen with the agent picker open, listing built-in and your agents" width="858" height="608" data-path="images/agents/chat/pick-an-agent-dark.png" />
</Frame>

## Set up the agent for this chat

Three controls at the bottom of the message box tune what the agent can use, just for this conversation, without changing the saved agent. Each shows a count so you can see what's active at a glance.

### Capabilities

Toggle the agent's built-in abilities, such as web search or recalling past chats, on or off for this chat. See [Capabilities](/agents/capabilities).

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/qx-labs/ZJkiVX6zo-84vXkk/images/agents/chat/capabilities-popover-light.png?fit=max&auto=format&n=ZJkiVX6zo-84vXkk&q=85&s=7f265a95048c4062e90f27e5dd35ec23" alt="The Capabilities popover with per-ability toggles" width="380" data-path="images/agents/chat/capabilities-popover-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/qx-labs/ZJkiVX6zo-84vXkk/images/agents/chat/capabilities-popover-dark.png?fit=max&auto=format&n=ZJkiVX6zo-84vXkk&q=85&s=220a4c654944539f8a76d6979c914009" alt="The Capabilities popover with per-ability toggles" width="380" data-path="images/agents/chat/capabilities-popover-dark.png" />
</Frame>

### Connected apps

Toggle which of your [connected apps](/connected-apps/overview) the agent may call, filter to find one, and open **Manage tools** to choose exactly which of an app's tools it can use. Haven't connected anything yet? Use **Connect new** right here.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/qx-labs/ZJkiVX6zo-84vXkk/images/agents/chat/apps-popover-light.png?fit=max&auto=format&n=ZJkiVX6zo-84vXkk&q=85&s=f6826ff6acf8609387ad7e0bd8d5b35c" alt="The Connected apps popover with per-app toggles" width="380" data-path="images/agents/chat/apps-popover-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/qx-labs/ZJkiVX6zo-84vXkk/images/agents/chat/apps-popover-dark.png?fit=max&auto=format&n=ZJkiVX6zo-84vXkk&q=85&s=c551d7727723fa3b3099e77b2eb4c7a7" alt="The Connected apps popover with per-app toggles" width="380" data-path="images/agents/chat/apps-popover-dark.png" />
</Frame>

### Knowledge

Toggle the [knowledge vaults](/agents/apps-and-knowledge) the agent can search, and use **Configure scope** to limit it to certain folders or files. If the agent has no vaults attached, add them from the agent editor.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/qx-labs/ZJkiVX6zo-84vXkk/images/agents/chat/knowledge-popover-light.png?fit=max&auto=format&n=ZJkiVX6zo-84vXkk&q=85&s=107cae309b827098739eea98ec467332" alt="The Knowledge popover with per-vault toggles" width="380" data-path="images/agents/chat/knowledge-popover-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/qx-labs/ZJkiVX6zo-84vXkk/images/agents/chat/knowledge-popover-dark.png?fit=max&auto=format&n=ZJkiVX6zo-84vXkk&q=85&s=a0e08eca77bd4ec8f04cd86ad340ed3b" alt="The Knowledge popover with per-vault toggles" width="380" data-path="images/agents/chat/knowledge-popover-dark.png" />
</Frame>

## Attach files and write your prompt

Add files by dragging them onto the chat or pasting from your clipboard. You can attach images and common document and spreadsheet formats, and, for agents with [Workspace Access](/agents/persistent-workspace), audio and video.

The message box shows **Ask anything, type @ to switch agents**. Press **Enter** to send, or **Shift+Enter** for a new line.

## Run the agent

Send your message and the reply streams in. While it's working, **Stop generating** halts the response. Anything you type meanwhile is **queued** and sent as one follow-up when the reply finishes, or choose **Send now** to fold it into the reply already in progress. Leaving the page mid-reply asks you to confirm, so you don't lose it. Every answer has a **Copy** button to grab its text.

## Review the response

As the agent works, its steps appear as **tool calls** in the conversation, grouped into a collapsible activity area. Click any tool call to open a panel with its **Status**, **Duration**, and the **Inputs** and **Output** it used.

<Columns cols={2}>
  <Frame caption="Tool calls in the response">
    <img className="block dark:hidden" src="https://mintcdn.com/qx-labs/ZJkiVX6zo-84vXkk/images/agents/chat/response-tool-calls-light.png?fit=max&auto=format&n=ZJkiVX6zo-84vXkk&q=85&s=2e76260cd2bef6faf201d2ca6e567549" alt="An agent's response with tool calls listed inline" width="871" height="874" data-path="images/agents/chat/response-tool-calls-light.png" />

    <img className="hidden dark:block" src="https://mintcdn.com/qx-labs/ZJkiVX6zo-84vXkk/images/agents/chat/response-tool-calls-dark.png?fit=max&auto=format&n=ZJkiVX6zo-84vXkk&q=85&s=5b670847b743a74fc66713addfde6f7f" alt="An agent's response with tool calls listed inline" width="871" height="874" data-path="images/agents/chat/response-tool-calls-dark.png" />
  </Frame>

  <Frame caption="A tool call's details">
    <img className="block dark:hidden" src="https://mintcdn.com/qx-labs/ZJkiVX6zo-84vXkk/images/agents/chat/tool-detail-light.png?fit=max&auto=format&n=ZJkiVX6zo-84vXkk&q=85&s=b816eb81d2826c8432528d06c1f85607" alt="The detail panel for a single tool call, showing status, inputs, and output" width="571" height="827" data-path="images/agents/chat/tool-detail-light.png" />

    <img className="hidden dark:block" src="https://mintcdn.com/qx-labs/ZJkiVX6zo-84vXkk/images/agents/chat/tool-detail-dark.png?fit=max&auto=format&n=ZJkiVX6zo-84vXkk&q=85&s=31c1d6b514718d78278775d31ac48e41" alt="The detail panel for a single tool call, showing status, inputs, and output" width="571" height="827" data-path="images/agents/chat/tool-detail-dark.png" />
  </Frame>
</Columns>

When an answer draws on the web or your knowledge, numbered citations appear in the text and a **Sources** button lists every reference, each linking back to the original.

A small ring by the send button shows how full the conversation's context is. Long chats are summarized automatically so they keep going. If that's turned off for the agent, a **Summarize** button appears once the context fills up.

<Note>
  The top of the chat shows a status dot for your organization's [workspace](/agents/persistent-workspace): green when it's ready, amber while it's being set up. Some abilities stay unavailable until it's ready.
</Note>

## Manage your chats

Open **History** at the top of any chat to see all your conversations, newest first. Filter by agent, then open one to pick up where you left off. To remove a conversation, hover it and choose **Delete chat**. Deleting is permanent.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/qx-labs/ZJkiVX6zo-84vXkk/images/agents/chat/chat-history-light.png?fit=max&auto=format&n=ZJkiVX6zo-84vXkk&q=85&s=8c85d29dbe66d93cf40f8af908157bdf" alt="The chat history panel listing past conversations with an agent filter" width="1636" height="952" data-path="images/agents/chat/chat-history-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/qx-labs/ZJkiVX6zo-84vXkk/images/agents/chat/chat-history-dark.png?fit=max&auto=format&n=ZJkiVX6zo-84vXkk&q=85&s=62329191e29b6a19fe78477a9c18bab1" alt="The chat history panel listing past conversations with an agent filter" width="1636" height="952" data-path="images/agents/chat/chat-history-dark.png" />
</Frame>
