Skip to main content
The Chat Console lets you talk to your agents directly from the browser. You can start new conversations, review past sessions, and watch your agents think and respond in real time. Who it’s for: anyone testing an agent’s behavior before exposing it on a real channel, plus developers debugging tool calls live.

​
Routes

  • /chat — opens the console without a selected session
  • /chat/:conversationRef — searches every authorized tenant and agent partition without a session-kind filter, selects the owning agent, and opens the matching direct-message, group, or sub-agent conversation

​
Backing API

  • POST /api/chat — sends messages for console-created web conversations; body is JSON { message, agentId?, sessionKey?, locale? } (locale is a canonical BCP-47 tag; see the HTTP gateway reference)
  • session.list and session.history — resolve a routed conversation across authorized agents, then load it through its exact tenant, agent, and conversation-reference authority
  • session.send — continues a selected stored conversation through the same scoped authority
  • SSE events on the dashboard’s event stream drive the streaming response (token-by-token append, tool call status updates, completion)
All requests carry the gateway token as a Bearer header (read from sessionStorage.comis_token).

​
What You See

The Chat Console is split into two main areas side by side.

​
Session Sidebar

On the left, the session sidebar lists direct-message conversations for the selected agent. Each session shows its label or shortened opaque conversation reference, channel kind, message count, and last activity. At the top of the sidebar you will find:
  • A New Session button (labelled “New”) that creates a fresh session for the agent currently selected in the message area
  • A search bar (“Filter sessions…”) that filters the visible session list by conversation reference or label as you type
Click any session in the list to load its conversation in the message area. Route resolution is separate from the direct-message sidebar query: a routed group or sub-agent conversation can remain active even though it is not a sidebar row. The console switches to the owning agent, loads history with the resolved tenant, agent, and conversation reference, and uses that same exact scope when continuing the conversation. The message input remains disabled unless all three authority fields resolve.
For richer filtering — by agent, channel, or content match across all sessions — use the Sessions view instead. The chat console’s sidebar is a quick filter, not a full session browser.

​
Message Area

On the right, the message area shows the full conversation history for the selected session. Messages are displayed as bubbles with different styles depending on who sent them:
  • Your messages appear on the right side
  • Agent responses appear on the left side with support for formatted text, lists, code blocks, and other rich content
  • System messages appear centered with a distinct style
  • Error messages are highlighted in red so they stand out
At the top of the message area, a header bar lets you select the agent and shows the active conversation reference and message count.

​
Tool Call Cards

When your agent uses tools behind the scenes — like searching the web, reading a file, or running a command — the Chat Console shows expandable cards in the conversation. Each card displays:
  • The tool name
  • The input parameters the agent sent to the tool
  • The output the tool returned
  • Whether the tool call succeeded or encountered an error
Click a tool call card to expand it and see the full details. These cards help you understand exactly what your agent did to arrive at its answer.

​
Message Input

At the bottom of the screen, a text input lets you type messages to your agent. The input area automatically grows as you type longer messages.

​
Starting a Conversation

1

Pick the agent you want to talk to

At the top of the message area, use the agent selector dropdown to choose which agent the next session will be created for.
2

Click New

Click the New button at the top of the session sidebar. A fresh session is created for the selected agent on the web channel; its session key is auto-generated as web:<agent>:<uuid>. The new session is selected immediately.
3

Send your first message

Type your message in the input area at the bottom and press Enter to send it. The conversation streams back word-by-word.
The chat console uses the web channel for sessions it creates. Selecting an existing platform conversation resumes only that authorized stored target; its human-readable session key is never reused as transport identity.

​
During a Conversation

Once you send a message, the agent starts working on a response. Here is what to expect:
  • Live streaming — Responses for console-created web conversations appear word by word. A stored-conversation continuation appears after its scoped session request completes.
  • Formatted responses — Agent messages render with full formatting support including bold text, bullet lists, code blocks, and links.
  • Tool activity — If the agent calls tools during its response, you will see tool call cards appear in the conversation stream. These show what the agent is doing behind the scenes.
  • Errors — If something goes wrong during the response, an error message appears in red with details about what happened.
Keyboard shortcuts:
  • Press Enter to send your message
  • Press Shift + Enter to insert a new line without sending
  • Use the scroll-to-bottom button that appears when you scroll up in a long conversation
You can also type slash commands in the message input for quick actions: /new (start a new session), /reset (reset the current session), /compact (compact the current session context), /export (download the session as JSONL), /switch (change agent), and /help (see all commands).

​
Attachments and Voice

The Chat Console supports file attachments and voice recordings alongside text messages:
  • File attachments — Click the attachment button to attach images, audio files, or documents to your message. You can attach up to 5 files at a time, each up to 10 MB.
  • Voice recording — Use the microphone button to record a voice message up to 2 minutes long. The recording is sent to your agent for transcription and processing.
Attachment previews appear above the message input before you send, so you can review and remove files before they go out.

Sessions View

Browse all sessions with filtering, bulk actions, and detailed statistics.

Agents View

View and manage the agents you are chatting with.