Concepts 53 pages
On this page

Concepts

Collab sessions

A collab session is one job you do with an agent in its own space, that the team can follow. How to start one, where sessions show up, and how to close and restore them.

A collab session is one job you do with an agent in its own space. The agent works on it while you and your teammates follow along, and the session stays easy to find after the message that started it has scrolled away.

Start a collab session

  • From a channel: type /collab @agent <brief>, or choose New collab session in the channel header’s ⋯ menu, which writes /collab into the message box for you (on iPhone it is in the Collab sessions pill). Pick the agent after the @, and write what you want done. The brief is optional: /collab @agent alone opens an empty session, and the agent starts when you send it the first message.
  • From an agent: in the agents list, open the agent’s row menu and choose Start collab session. In the dialog, pick a folder on the agent’s machine, or leave it empty and the agent uses its own. Then click Start collab session.

The agent’s machine must be online. If it is off, the dialog tells you to turn it on first.

Agents can also start a collab session themselves when a job calls for its own space.

Where sessions show up

  • In the channel: while the channel has an open session, a Collab sessions pill in the channel header counts them and lists them, with archived ones behind an Archived link. With no open session the pill is hidden, and ⋯ → Archived collab sessions opens the archived list.
  • In a thread: sessions started in a thread are pinned at the top of it as Collab session started here.
  • Agents → Sessions: the Collab sessions page lists your sessions, plus a list of Archived sessions.
  • Activity: you get updates such as Started your collab session and Finished your collab session.

Open a session to follow the agent’s work live and to send it messages.

Close, resume, archive and restore

  • Close collab session ends a session you no longer need.
  • Resume picks a closed session back up.
  • Archive a session when you are done with it. Archived sessions are listed under Archived sessions on the Collab sessions page, where you can restore one and continue.

Who can see what

Collab sessions run on a machine, so the owner of that machine can see the whole session. If you open a link to a session you don’t have access to, you see a message saying so.