The Chat Interface
A reference for the controls AgentQ offers in each of its chat surfaces, and for what the input accepts.
Full-Page Chat
The full-page chat opens when you click AgentQ
in the left sidebar. It has a collapsible chat sidebar on the left, split into a Chats tab and an Archived tab, and the main chat area on the right. The header of that area carries the chat's title, reading New Chat until you send the first message and Untitled Chat if the title is ever cleared. An archived chat shows an Archived badge beside it. Archive sits at the right of the header, and appears only on a saved chat that is not already archived. Before there are any messages, the area greets you by first name with How can I help you,
| Control | Icon | Description |
|---|---|---|
| Search chats | Open the search field and filter the list you are on by title or message content. See Search Chats. | |
| Refresh | Reload the list to surface recently created chats. | |
| Chats / Archived | Two tabs at the top of the sidebar, each with a count. Chats holds the active chats and Archived the ones you have archived, where Restore and Delete live. | |
| New chat | Start a new chat. Shown only on the Chats tab. See Start a New Chat. | |
| Toggle sidebar | The round button on the sidebar's outer edge hides the sidebar to give the chat area more room. The same button, with the arrow flipped, brings it back. | |
| Archive | On the right of the chat header, archives the open chat. See Archive a Chat. | |
| Attach file | Upload a document to send with your message. See Attach a File. | |
| Send message | Send the message to AgentQ. | |
| Scroll to bottom | Appears over the messages once you scroll up, and returns you to the newest one. | |
| Suggested prompts | Sits above the input on the empty state and offers one prompt at a time. Click it to send it as the opening message of a new chat. When AgentQ has more than one, and move between them, dots mark your place, and a counter reads 1 of N. |
Floating Chat
The floating chat is the persistent widget in the bottom-right corner of every page. Click the AgentQ button to open it, or press Q to toggle it from anywhere on the page, except while you are typing in an input.
| Control | Icon | Description |
|---|---|---|
| Chat history | Open the list of previous chats to resume one. See Resume a Chat. | |
| New Chat | Start a new chat. | |
| Open full chat | Open the current chat in the full-page AgentQ view. | |
| Close | Close the floating chat. | |
| Attach file | Upload a document to send with your message. See Attach a File. | |
| Send message | Send the message to AgentQ. | |
| Scroll to bottom | Appears over the messages once you scroll up, and returns you to the newest one. | |
| Suggested prompts | Sits above the input on the empty state and offers one prompt at a time. Click it to send it as the opening message of a new chat. When AgentQ has more than one, and move between them, dots mark your place, and a counter reads 1 of N. |
Resize the Panel
The floating chat has three resize handles along its top and left edges:
- The top edge drags to change only the height.
- The left edge drags to change only the width.
- The top-left corner drags to change both dimensions at once. A small square patterned with diagonal lines marks this corner.
Hover any handle to see a subtle highlight; the active handle turns primary while you drag.
The panel size persists per browser: your last-chosen width and height are restored the next time you open the floating chat. Clearing your browser storage resets it to the default.
The panel enforces size limits: it never shrinks below a minimum size, and it never grows beyond your current viewport (a small margin is kept around the edges).
How the Chat List Is Organised
Both tabs sort newest first on the time a chat was last updated, and break the list into headings for TODAY, YESTERDAY, PREVIOUS 7 DAYS, and OLDER. A heading appears only when a chat falls under it.
Each row carries the chat's title, a lit dot when it is the chat you have open, and on the Archived tab. A title too long for the row is truncated, and hovering shows it in full. A spinner marks a chat that is still generating a response while you read another one.
Outside a search, both lists load more as you scroll. The counter beside each tab is the total for that list, so it does not move while you search, and it is hidden when the list is empty.
When a list has nothing in it, Chats reads No chat history yet and Archived reads No archived chats. A search that matches nothing reads Not found on either tab.
When the Input Is Read-Only
The message input is replaced by a notice in two situations.
Opening an archived chat shows This chat was archived, with a round Restore button beside it that brings the chat back to the Chats tab and returns the input. See Restore a Chat.
With no AI provider connected, it shows AgentQ is not connected. This conversation is read-only. with a Set up AgentQ button. The button is shown to everyone, but only a Manager or Admin reaches the settings page through it, since the configuration is theirs to make. Anyone else has to ask one of them to connect a provider. The sidebar stays where it is, so earlier chats remain readable while AgentQ is disconnected. See Add Integration.
Stop a Response
While AgentQ is working, the Send message button is replaced by Stop . Click it to interrupt the response. Whatever AgentQ produced so far is kept as a partial response with a Stopped indicator. The button appears as soon as the message is sent, so you can pull out during the wait before the first words arrive, not only mid-answer.
The same control is available in the floating chat.
Paste Large Content
When you paste text of 1,000 characters or more into the input, AgentQ captures it as an attachment rather than inserting it into the input field. The pasted content appears as a removable panel labeled PASTED above the input. It is included with your message when you send it, giving AgentQ full context while keeping the input clean.
In the floating chat, the pasted content appears as a compact chip.
Attach a File
When your active AI provider supports file uploads, click Attach file next to the message input, choose a document in the native file picker, and click Open. You can also drag the file straight onto the chat area. The selected file appears as a removable chip above the input. Type your prompt and send the message, and the file is sent together with your text.
In the floating chat, the attached file appears as a compact chip.
Supported file types
| Category | Formats |
|---|---|
| Documents | PDF (.pdf), Word (.doc, .docx) |
| Spreadsheets | Excel (.xls, .xlsx), CSV (.csv), TSV (.tsv) |
| Structured data | JSON (.json), XML (.xml) |
| Plain text | Text (.txt), Markdown (.md) |
Limits
- One file per message.
- Up to 20 MB per file.
Provider coverage
Attach file is shown only when the active AI provider supports file uploads. The button is currently available for:
- Qualytics (a narrower set of formats, see the note below)
- Anthropic
- Google Gemini
- Google Vertex AI
- Amazon Bedrock (Claude models)
- OpenAI
- Azure OpenAI
- Heroku
If your provider is not on this list, paste your content as text instead. See Paste Large Content above.
The Qualytics provider reads a narrower set of formats
On the Qualytics provider you can attach PDF, Word .docx, Excel .xlsx, and text-based files (CSV, TSV, plain text, JSON, XML, Markdown). The legacy .doc and .xls formats, PowerPoint, and images cannot be read, so the file picker leaves them out while this provider is selected. Dragging one onto the chat is turned away with a message listing the formats that do work. Save the file as .docx or .xlsx, export it as CSV or PDF, or paste its content as text.
A PDF has to be text-searchable. A scanned or image-only PDF is still accepted, but no text can be read from it, so AgentQ answers that it found no readable content rather than returning an error. Very long documents are truncated.
Note
Files are sent to your configured AI provider as attachments. Qualytics does not store the uploaded file; only the text of your chat is saved to history. The provider you have configured handles file content according to its own data-processing policies. On the Qualytics-managed provider the file goes to the Qualytics gateway, which extracts the document's text and passes that to the model.
See Also
-
MCP
What the Model Context Protocol is, how it works, and why it matters.
-
AgentQ in Action
How Qualytics implements MCP, with its endpoint, tools, and tool step labels.
-
Tool Catalog
Every tool AgentQ can call, what each one does, and what it shares with the model.
-
Semantic Reporting
The structured query interface AgentQ uses to count, filter, and inspect platform resources.
-
Access Controls
How an administrator chooses what chat may share with the model, and what each level unlocks.
-
AgentQ Audit
What each audit entry holds, how cost estimates work, and what the period summary reports.
-
Supported AI Providers
Every provider you can connect, what the Beta badge means, and which ones take file attachments.
-
Amazon Bedrock Authentication
The three ways to authenticate to Bedrock, and what an IAM role setup expects.
-
Conversations, Responses & Context
How to write prompts, read AgentQ responses, and work with context-aware chats.
-
AgentQ Limits
Rate limits, token usage, timeouts, SQL constraints, and scope constraints.
-
Examples
Worked scenarios showing what you ask AgentQ, what it does, and the shape of the answer.
-
Best Practices
Prompt design, cost management, guardrail behavior, rate limits, and async operation patterns.
-
Permissions
The user roles behind chatting with AgentQ, configuring it, and reading the audit.
-
How It Works
Where AgentQ appears, how a turn runs, and what it is allowed to see.