Skip to main content

Conversations

A conversation, or thread, is one exchange with an agent. The Conversations page lists all of yours; the sidebar shows the most recent ones while you work.

Who can use it: the Member role. A role with read-only access to the Work Room can see conversations shared with it but cannot start one.

VideoConversations2:16

Recorded on .

Find a conversation​

The Conversations page: New conversation, the All and Starred chips, Filter by agent, Sort, and threads grouped by Today, Yesterday, This week and Older.The Conversations page: New conversation, the All and Starred chips, Filter by agent, Sort, and threads grouped by Today, Yesterday, This week and Older.
Conversations groups your threads by when you last touched them. Use the chips, the agent filter and the sort to narrow the list.

The list is grouped by when you last touched each thread: Today, Yesterday, This week and Older. Each row shows the agent that answered and the number of messages.

  • All and Starred switch between every thread and the ones you starred.
  • Filter by agent narrows the list to one agent. Clear filter removes it.
  • Sort offers Recent, Longest first and Shortest first.
  • The search box finds threads by title.

New conversation starts a fresh thread. From anywhere in the Work Room the keyboard shortcut Alt+N does the same, opening in whichever room your workspace policy has set as the default.

Two words are used for the same thing. The chip, the button and the heading say Star and Starred; a few of the confirmations still say favorites. It is one concept.

Continue a conversation​

Select a row to open the thread.

An open conversation with the Sales Pipeline Coach: the thread header naming the agent with the message count, the user's question, the answer with its green receipt chip reading Searched knowledge base · 2 sources and numbered citation markers, the top of a Total Q4 Revenue card, and the composer at the bottom.An open conversation with the Sales Pipeline Coach: the thread header naming the agent with the message count, the user's question, the answer with its green receipt chip reading Searched knowledge base · 2 sources and numbered citation markers, the top of a Total Q4 Revenue card, and the composer at the bottom.
An open conversation. The receipt line under each answer says where it came from, and the composer stays at the bottom for your next message.
  • The header names the agent and shows the message count. Select it to Switch agent for your next message.
  • Each answer carries a receipt line: whether the agent searched your knowledge sources and how many it used, answered from model knowledge alone, called specialist agents, or applied a skill. When knowledge was used, citation chips under the answer point to the sources.
  • Good response, Bad response, Copy, Read aloud and Regenerate response are the icon buttons under every answer.
  • Some agents reply with cards rather than text: figures, charts, tables or an action that asks for your decision. Cards have their own download and open controls.

The composer stays at the bottom. Attach adds documents; typing @ mentions another agent.

Rename and share a conversation​

The Work Room sidebar with a conversation's More options menu open, offering Open, Add to Favorites, Rename, Share, Remove from Recent and Delete.The Work Room sidebar with a conversation's More options menu open, offering Open, Add to Favorites, Rename, Share, Remove from Recent and Delete.
Rename, Share and Delete live in the sidebar's row menu. The header inside a thread has neither a star nor a share.

Renaming and sharing live in the sidebar rather than on this page. More options (the three dots) on a conversation in the sidebar's recent list offers Open, Add to Favorites (Remove from Favorites on a starred one), Rename, Share, Remove from Recent and Delete. Remove from Recent hides the thread from your recent lists without deleting it. Rename opens a small dialog; Save stays disabled until the name has changed. A conversation's title is otherwise set by the platform from its first exchange, and there is no way to name one at creation.

Share opens the sharing dialog with a copy-link option. Sharing a conversation is reserved for administrators on the platform side: for anyone else the dialog is offered and the platform refuses, so treat the copy link as the thing that works.

The header inside a thread shows the agent and the message count and nothing else. There is no star or share control there; both are in the sidebar.

Star, export and delete​

  1. Star a thread

    Use Star on the row. Starred threads appear under the Starred chip and in the sidebar for quick access. Unstar removes the pin.

  2. Select several threads

    Tick the rows you want. The bar shows how many are selected and offers Export and Delete.

  3. Export

    Export downloads the selected threads as one JSON file named for the date. The file is assembled in your browser from what the page has already loaded, so it holds what you can see and nothing the page has not fetched. A confirmation tells you how many were exported.

  4. Delete
    A Delete chat dialog naming the conversation, warning that the action cannot be undone, with Cancel and Delete buttons.A Delete chat dialog naming the conversation, warning that the action cannot be undone, with Cancel and Delete buttons.
    Deleting names the conversation and says it cannot be undone. A delete that fails keeps this dialog open with the error in it.

    Delete asks you to confirm. Deleting permanently removes the selected conversations and cannot be undone. Several are deleted one at a time, and the confirmation says how many succeeded and how many did not. From the sidebar, a delete that fails keeps the dialog open with the error in it rather than claiming success.

Conversations and API sessions​

A conversation and a session are the same thing seen from two sides: the Work Room shows you yours, and a developer's application reaches the same rows through the public API as sessions belonging to the key's owner.

In the Work RoomThrough the public API
Started byNew conversation, or the first message in a roomThe first turn that names a session id, or a create call
Listed forYou, on this page and in the sidebarThe key's owner, and only sessions that hold at least one message
TitleSet by the platform from the first exchange, renamed from the sidebarSet at creation, or from the first message and later replaced by a generated one
Star, share, exportHereNot available
DeleteHere, permanentlyThe delete route, permanently; another owner's session is refused
HistoryThe thread viewThe history route, which any key in the tenant can read by id

Do this from your own code

Limits and behaviour​

  • Archive in the selection bar is disabled and marked coming soon. There is no archive on the platform yet, and the button says so rather than pretending.
  • If the list fails to load, the page says so and offers Retry. Your history is not gone; the list could not be fetched.
  • If a thread cannot be restored after your connection dropped, the page keeps the agent selected and asks you to refresh.
  • Conversations shared with you appear here and under Shared with me, where you can join them with their full history.

Describes the platform as of .

Was this page helpful?