SUZENT / Docs
THE SUZENT HANDBOOK

Chat apps

Talk to your agent from Telegram, Slack, Discord, Feishu (Lark), or WeChat.

Talk to your agent from the chat apps you already use. It's the same agent, with the same memory and files, whether you're at your desk or on your phone.

AppSupports
TelegramText, photos, files
SlackText, files, threads
DiscordText, files, DMs and channels
Feishu (Lark)Text, files
WeChatText, images

How it works

  1. Create a bot in the app. Each app's page has the steps.
  2. In Suzent, open Settings → Social Channels, pick the app, paste the bot's credentials on the Connection tab, and enable it.
  3. On the Access control tab, add your own user ID to Allowed users.

Suzent keeps these settings in config/social.json, which you can also edit by hand. config/social.example.json shows every option.

Only people you allow can talk to your agent. Messages from anyone not on the app's allowed list are refused. See Access control & pairing for letting others in, and for choosing which model and tools chat apps use.

Conversations persist. Each chat becomes a regular Suzent conversation that remembers its history, even after a restart. Photos are read by the model if it supports images. Files you send are saved to the project library's uploads folder, where the agent can open them. Files the agent makes for you come back to the same conversation (see Receiving files); WeChat can't receive them yet.

Message updates arrive as separate messages. When the agent sends you a note while it works, it shows up in the chat app as its own message, and its emoji reactions show on your message in Telegram, Slack and Discord.

Talk to Regent from any chat app

By default each chat app, and each group, has its own conversation. To have your direct messages from every chat app go to Regent instead, open Settings → Social Channels and turn on Direct messages go to Regent under Agent Capabilities.

  • Wherever you write from, you continue the same conversation, and Regent answers in the app you wrote from.
  • /sess switch <id> moves that one conversation to another session for all your chat apps at once, and /sess reset brings it back to Regent.
  • Group chats keep their own sessions.
  • Everyone you allow on a chat app joins this conversation, so leave it off if you have let other people in.

Commands in a chat app

Send these as messages to the bot:

CommandWhat it does
/approve (or /y)Approve the action the agent is waiting on. /ya also allows it for the rest of the conversation.
/deny (or /n)Refuse it.
/new [title]Start a fresh conversation.
/sess ls, /sess switch <id>, /sess infoList your conversations, switch to another, or show the current one. Your choice is kept after a restart.
/sess resetGo back to the default conversation.
/retryRedo the agent's last answer.
/model [id]Show or change the model for this conversation.
/goal <goal>Give the agent a goal to keep working on.
/statusCheck that Suzent is healthy.
/helpList every command.

Keep it online

Chat apps only work while Suzent is running. On Windows and macOS, closing the window leaves Suzent in the notification area or the menu bar. To keep chat apps available after you quit, turn on the background service.

Edit this page on GitHub ↗

On this page