Skip to content

Slash commands

The bot registers one root command, /roundtable unless you set discord.rootCommand. Features add their subcommands under that root. The root command works in the server and in a direct message with the bot.

Its description reads <name> control panel (owner only) in English, where <name> is the name setting. With locale: "zh-TW" the descriptions below are in Traditional Chinese.

The core registers one subcommand group, schedule.

Command Description Who may use it
/roundtable schedule list List the schedules of every channel Owner
/roundtable schedule cancel id:<schedule> Cancel a schedule Owner

The group description is Schedules, and the id option of cancel reads The schedule to cancel. The id option is required and completes as you type, listing each schedule as #<id> <title> (<recurrence>).

list shows every schedule in every channel. Each entry gives the schedule’s id, title, channel, target, how it repeats, when it runs next, who set it, and when it last ran with the outcome. When there are none, it says No schedules right now. The footer says you can ask the bot to create and edit schedules in conversation, and use this command to review and cancel them.

cancel deletes the chosen schedule and shows it once more under the title Schedule cancelled. If the value is not a number it answers Pick a schedule from the list. If no schedule has that id it answers There is no schedule #<id>.

To create or change a schedule, ask an agent; see Schedules and background work.

The bot checks the Discord user id and allows only an owner to use /roundtable. Every answer is visible only to the person who ran the command. Anyone else gets a panel titled Owner only that says /roundtable is the control panel of the assistant’s owner, followed by whatever you set in discord.refusalHint. Autocomplete returns no choices for non-owners. Admins and members talk to the agents in their channels. See Access tiers.

Three kinds of Discord buttons handle clicks:

  • The cards for held actions and ask_user questions. Their buttons are Run and Cancel, or the answer options. A set of questions is one card: a menu for each question, a button that opens a form for written answers and a note, Submit with a Cancel beside it, and Previews when an option has a preview. Cancel tells the agent you declined the question, so it does not ask again. See Access tiers for who may answer.
  • The card of a turn that reached its time limit: the built-in runtime’s budget (10 minutes by default) or cap (30 by default), set by turnLimits. It names the limit, what the turn is doing and the tools so far, with Continue (another full budget) and Cancel. With no answer within turnLimits.cardSeconds (5 minutes by default) the turn is aborted.
  • The Stop button on a long turn. Only the owner can press it. It answers Stopped., or Nothing is running right now. when the turn has already ended, or Only <name>'s owner can stop it. to anyone else.

A plugin adds its own subcommands under the root, and may add top-level commands of its own, with commands.add from setup. A name used twice, or a plugin that registers the root itself, stops the start with a message that names the command. See What plugins can add.

A plugin can add an agent-panel subcommand using agentPanel from pi-roundtable/discord. The bot registers no agent-panel command by default.