Skip to content

Configuration reference

This page covers all Slack bot configuration options. You can edit these settings at any time from the bot’s edit page in the dashboard.

A display name for the bot in the Quant dashboard. This does not affect the bot’s identity in Slack — that is determined by the Slack app (Quant-managed or BYO).

Choose between Quant-managed and BYO (Bring Your Own). See Setup types for details.

Restrict the bot to specific Slack channels. When set, the bot only responds in the listed channels. Leave empty to allow all channels.

This applies to @mentions and keyword triggers in channels. Direct messages are always allowed regardless of channel restrictions.

How long conversation history is retained per thread, from 1 to 90 days (default: 14 days). After a session expires, the next message in that thread starts a fresh conversation with no prior context.

Sessions are stored in DynamoDB with automatic TTL-based expiration.

When enabled, the bot responds to messages containing specific keywords in allowed channels, even without an @mention.

SettingDescription
EnabledToggle keyword monitoring on or off (default: off)
KeywordsComma-separated list of trigger words

Slash commands let users invoke the bot with a typed command:

  • Quant-managed: Fixed commands — /ask and /quant
  • BYO: Custom commands — configure any command name in your Slack app settings
TriggerDefaultNotes
@mention in channelAlways onThe primary interaction method
Direct messageAlways onPrivate conversations with the bot
Slash commandAlways onConfigurable command name (BYO only)
Keyword matchOffOpt-in per bot, requires keyword list

The bot’s backing agent can be configured directly from the bot editor. These settings are the same as those available in the agent configuration page.

Custom instructions for the bot’s agent. If sub-agents are also selected, routing instructions are appended automatically.

Assign built-in and custom tools to the bot’s agent. Some tools are auto-added based on other selections:

  • call_agent — automatically added when sub-agents are selected
  • query_vector_db — automatically added when knowledge base collections are selected

Auto-added tools show as checked with an “(auto-enabled)” hint.

Assign skills to the bot’s agent, grouped by namespace. Use the “select all” toggle to assign all skills in a namespace at once.

Select vector database collections the bot can search to ground its responses in your data.

Select agents the bot can delegate to. See Agents and routing for details on how routing works.

Sub-agents are optional. If none are selected, the bot handles all questions directly.

Expand the Advanced Configuration section in the bot editor to access these settings.

The AI model used by the bot’s agent. Only models that support tool use are available. Pre-populated with your organisation’s default model.

Controls response randomness (0—1). Lower values are more deterministic; higher values are more creative.

Maximum number of tokens in the agent’s response. Leave empty to use the model’s default.

Select a guardrail configuration to apply content safety policies to the bot’s responses.

Apply input and output filter policies for content validation and governance.

Enable extended context windows for models that support it.

  • Every Slack thread maps to one persistent AI session
  • New threads create a new session; follow-up messages in the same thread reuse the existing session with full conversation history
  • The bot always replies in-thread, never in the top-level channel
  • In direct messages, the initial message creates a new thread; subsequent messages in the conversation maintain the same session
  • Expired sessions (past the TTL) start a fresh conversation if the user messages again

Navigate to Slack Bots in the dashboard sidebar. The bot list shows:

  • Bot name and status (active/inactive)
  • Connected workspace name
  • Agent assignment and sub-agent count
  • Conversation count and last active time

Click a bot in the list to open the editor. All settings can be changed at any time. Changes to the agent configuration (system prompt, tools, skills) take effect on the next conversation.

Deleting a bot:

  • Quant-managed: Revokes the Slack OAuth token (uninstalls the bot from the workspace) and deletes the bot record and its backing agent
  • BYO: Deletes the bot record and its backing agent. You should manually remove the Slack app from your workspace

All bot operations are available via the REST API:

EndpointMethodDescription
/v1/slack/botsPOSTCreate a bot
/v1/slack/botsGETList all bots (org-scoped)
/v1/slack/bots/{botId}GETGet bot details (tokens masked)
/v1/slack/bots/{botId}PUTUpdate bot configuration
/v1/slack/bots/{botId}DELETEDelete bot and revoke token
/v1/slack/bots/{botId}/tokenPOSTStore or update credentials (write-only)
/v1/slack/bots/{botId}/sessionsGETList thread sessions
/v1/slack/bots/{botId}/statsGETUsage statistics (30-day window)

The stats endpoint returns aggregate usage data for the last 30 days:

FieldDescription
totalMessagesTotal messages processed
totalToolCallsNumber of tool executions
totalSubAgentCallsNumber of sub-agent delegations
avgResponseMsAverage response time in milliseconds
activeSessionCountCurrently active thread sessions