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.
Commands the core registers
Section titled “Commands the core registers”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>).
schedule list
Section titled “schedule list”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.
schedule cancel
Section titled “schedule cancel”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.
Who may use them
Section titled “Who may use them”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.
Buttons that are not commands
Section titled “Buttons that are not commands”Three kinds of Discord buttons handle clicks:
- The cards for held actions and
ask_userquestions. Their buttons areRunandCancel, 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,Submitwith aCancelbeside it, andPreviewswhen an option has a preview.Canceltells 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, withContinue(another full budget) andCancel. With no answer withinturnLimits.cardSeconds(5 minutes by default) the turn is aborted. - The
Stopbutton on a long turn. Only the owner can press it. It answersStopped., orNothing is running right now.when the turn has already ended, orOnly <name>'s owner can stop it.to anyone else.
Commands from plugins
Section titled “Commands from plugins”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.