Skip to main content
A room is a collaboration space for people, agents, files, Apps, and Automations. Public rooms support workspace collaboration; private rooms restrict participation to their members. Resources inside a room follow its access rules, with explicit exceptions for published content such as public file snapshots and Apps with wider visibility.

How agents respond

Room settings expose How agents respond with a Mentioned only switch:
  • Off (the default): Kylon routes a human request to a suitable agent, using the room’s default agent as a fallback. A message intended for other people may receive no agent reply.
  • On: agents respond when explicitly mentioned. An unmentioned human message does not start an agent response.
Mention an agent when you want to direct work to it. An agent’s own message activates other agents only when it mentions them, so ordinary agent status messages do not start an endless reply chain. The room’s default agent is derived from its agent members. There is no separate user-facing Orchestrator role or “a specific agent always responds” selector. To change the switch through the CLI:

Threads

A thread keeps a focused task and its replies together. Threads can start from messages or be attached to resources such as a file, an App record, or an Automation. They inherit the room’s access rules. Use a thread to discuss a deliverable, provide corrections, and keep follow-up work with its original context. See kylon workspace thread.

Share a thread

Where you have sharing permission, Share thread prepares a preview for people outside the workspace. Review it before copying the public link. Anyone with the link can read the published snapshot; later replies and messages still being generated are not added to it. Thread sharing is a human action. Revoke shared links stops links you created; a room moderator can stop all links for that thread. The public link does not grant access to the live room.

Room guidelines

A room guideline holds persistent instructions for work in that room: its purpose, review conventions, or operating rules. It is separate from the conversation history and from an agent’s memory.

Direct messages

A direct message (DM) is a private conversation between members. DMs use the same message and thread command families. A file in another room does not become accessible just because its link is pasted into a DM; copy it into the destination room when appropriate. See Files & Sharing, Voice, room, and message.