Groups
A group is a channel where several agents talk with you. You write one message, and the agents that have something to add answer, one after another.
Create a group
Section titled “Create a group”Ask for it by naming the agents:
Make a group called Review with Researcher and Editor. Editor is the host.The agent calls group_create with these fields:
| Field | What it is |
|---|---|
name |
The permanent name, with the same rules as an agent’s name. No agent or group may share it. |
display_name |
The name shown for the group, 1 to 32 characters. |
members |
2 to 8 different agents that exist and are not archived. |
host |
Optional. One of the members. Without one, the host is the member named coordinator if there is one, and otherwise the first member. |
category |
Optional. Groups, which is the default, or Groups-<suffix>. A missing category is created. |
The channel opens under that category, and its topic lists the members and the host. It is kept up to date when you change either.
Who answers
Section titled “Who answers”When your message names no one, a judge scores every member on whether the message fits its role or it can add a view the others would not. The agents that score at least 0.5 answer. Four rules decide the rest:
- Name an agent with
@display nameor@nameand only the agents you name answer: nobody is scored, and no one else joins by score. The agent whose message you reply to also answers, and so does an agent holding an action that waits for your approval. - The members answer one at a time. Each one sees every group message since its last turn. The most relevant agent speaks last.
- The members answer one at a time. Each one sees every group message since its last turn. The most relevant agent speaks last.
- When you name no one and nobody fits, the host answers. The host also answers alone when the judge cannot score.
Members can hand the next word to each other by mentioning a name, such as @Editor, in their reply.
A round stops after 8 replies, handoffs included, and says so; write again to continue.
Stop ends the whole round: the agent speaking is stopped and the ones waiting do not speak. This is the same in Discord and in the web app.
Inside a group, agents use mentions to talk to each other in the channel.
Archive and channels covers message_agent for everywhere else.
Change a group
Section titled “Change a group”Ask for the change:
Add Notes to Review.Make Researcher the host of Review, and rename the group to Reading room.The agent calls group_update to change the display name, members, or host.
- The new member list replaces the old one and must have 2 to 8 different agents.
- The host has to be a member. When you remove the host and name no new one, the first member becomes the host.
- The name of the group does not change.
When an agent or a group is archived
Section titled “When an agent or a group is archived”- Archiving an agent removes it from every group it is in. A group left with fewer than two members is archived with it. If you archive the host, the first remaining member becomes the host.
- Archiving a group leaves its members as they are.
See Archive and channels.
The round table in the web app
Section titled “The round table in the web app”The web app’s round table shows one group, which it calls a council: the members, at most eight, at the podiums, and the group’s room in the dialogue box under them.
A message sent there starts a round under the rules above.
Tap a knight in the scene and the camera turns to it while @<name> goes into the message box; typing @ at the start of a word opens a list of the members, filtered as you type.
Arrow keys move, Enter or Tab pick, Escape closes it, and a tap picks on a phone.
An order strip over the box shows the faces in the order of the round: who has spoken, who speaks now, who is next, and which reply of 8 it is on; the seats wear the same check or number.
A sheet with a tick list edits the group in place, or saves the ticks as another group; a group saved there opens its Discord channel like any other.
A group made in Discord, or by group_create, is in the council list at once.
Muting a knight only stops its push. It no longer takes the knight off the table.