YOUR AGENT · YOUR CHAT APP

Put an agent to work in Slack

Connect your own Socket Mode app to a TokenFlux agent. Give it tasks in direct messages and channel threads, with streamed replies and scheduled work.

What it looks like in Slack · ExampleTokenFlux Agent

Read this page and summarize the key points.

TokenFlux Agent

Here are the key points, with links to the source…

One streaming message grows with the reply and becomes the final answer. Each top-level channel message that mentions the bot starts its own thread.

01 / Slack

How to connect

First, open Agents, select an agent, then select Manage and Channels.

  1. 01

    Create a Slack app and enable Socket Mode. Create an app-level token (xapp-) with connections:write.

  2. 02

    Add the bot scopes and message event subscriptions listed in the setup guide, then install the app.

  3. 03

    Paste the app-level and bot (xoxb-) tokens. Connect and start, then create a code and send link CODE in a direct message or channel.

Read the setup guide ↗

02 / Example

Three tasks to try

Example

A scheduled briefing

Every weekday at 9:00, summarize the top 10 Hacker News posts and send the summary to this chat.

Daily, weekdays, weekly, hourly or cron. Delivery can fail; check the run in the web app.

Example

Research a question

Search the web for this topic, read the source pages and give me a summary with links.

Web search and page reading.

Example

Work on files

Read the files in your workspace, run a script to check the data and save a report there.

Files and shell commands in the sandbox.

Read about automations ↗

Good to know

  • Text only. Images and files sent in chat are not read. Use the web app for images and workspace files for file tasks.
  • Your bot or app serves one agent. Every task spends your TokenFlux balance on model tokens.
  • By default, only the person who linked the chat can use the agent. It ignores other people. In groups, it reads messages that mention or reply to it.
  • In Feishu and Slack, a topic started by mentioning the bot in a top-level message follows by default when the platform permits it. Later messages from authorized users can start paid tasks without a mention. Send /follow off to require mentions again. To turn follow back on, send @bot /follow on; a plain /follow on is ignored while follow is off.

Chat commands

In Slack, mention the bot first: @bot /new. Slack handles messages that start with /.

CommandWhat it does
/newStart a new conversation with the next message.
/stopStop this chat’s running task.
/model [ID]List available models or set this conversation’s model.
/helpList all commands.
/members [on|off]In the whole group, the person who linked it sets who can use the agent. Read the warning above.
/follow [on|off]Feishu and Slack topics only. Use /follow off to require mentions. To turn it back on, send @bot /follow on.

Frequently asked questions

Is it free?

The agent spends your TokenFlux balance on model tokens. Each scheduled run is also a normal agent task.

Can it send scheduled results to this chat?

Yes. Ask the agent in a linked chat to create an automation, or select that chat in the web app. Delivery can fail. The answer stays in the web app.

Can it read images or files sent in chat?

No. Chat apps send text only. Use the web app to send images. The agent can read and write files in its sandbox workspace.

Explore the other channels

Give your agent its next task

Create an agent, connect your chat and start with a text message.