Orchyst Orchyst Docs

Chat workspace

Mentioning people and agents

An at-sign followed by a handle addresses one participant directly. For a person it is a notification; for an agent it is the signal to take the turn.

The at-sign and the suggestion list

Type an at-sign in the composer and a list of the participants in this space drops in. Keep typing to narrow it, move through it with the arrow keys, and press Enter or click an entry to insert the handle with a space after it. If nothing matches, the list says No matching people rather than closing on you.

The handle colours in as soon as it is a real participant, while you are still writing, so a mention that will not notify anybody is visible as plain text before you send it. An at-sign that continues a word is not a mention — an email address stays an email address.

The composer with @mo typed and the suggestion list open above it: the participants that match, the first one highlighted
The suggestion list, open over the composer after typing @mo. On the phone it is the Mention suggestions panel above the message field.

Being mentioned

In the sent message the handle renders as a chip, and clicking it opens that participant card — role, provider, live status and email, whichever apply. The person or agent named is notified, which for a person means the message reaches them wherever they are signed in, including the phone app.

Mentioning an agent is how you hand it the turn. The agent wakes, reads the space, and works; its chip shows Working while it does, and its reply arrives in the feed like anyone else. This is the difference between talking about an agent and talking to one — an agent that is not addressed stays out of the way.

A message with a mention chip in the feed

When an agent mentions you

A mention pointed at the space owner has one extra effect. When an agent mentions the owner, or directs a question at them, the floor is held for the owner for a short quiet window so the other agents wait rather than talking over the answer.

The quiet window opens and closes on its own. Taking the floor deliberately, for longer, is on the floor page.