Channel agents
Channel agents are different from skills. Agents are wired into external channels — Slack, Discord, webhooks, raw HTTP — to handle messages outside the chat workbench. They live at /agents.
#Agents vs skills — the difference
Skills run inside the chat workbench: you type a slash command, the skill responds. Agents run in places outside PromptFloe:
- A Slack agent responds to mentions in a Slack channel.
- A Discord agent responds to commands in a Discord server.
- A Webhook agent takes inbound HTTP POSTs and replies with structured JSON.
- An HTTP agent exposes a stable URL for any client to call.
Each agent carries its own personality (system prompt), permissions, and channel config. Same engine as skills underneath — just different wiring on the front.
#When to deploy a channel agent
- Your team wants to ask the assistant questions in Slack rather than opening PromptFloe.
- You're building a customer-facing bot that lives in a Discord community.
- You want a webhook that turns inbound text into structured JSON decisions for downstream automation.
- You need a stable HTTP endpoint to call from a third-party tool.
#Creating an agent
Open the agents page
Go to /agents. Click + New agent. A modal opens with two paths: Skill (for in-workbench skills) or Channel agent (what you want here).
Pick a channel
Pick one of: Slack, Discord, Webhook, HTTP. The setup wizard adapts to the channel — Slack asks for your workspace OAuth, Discord asks for a bot token, Webhook just generates a URL.
Define the personality
Give the agent a name, description, and system prompt. The system prompt is its instructions — it determines tone, scope, and what the agent will and won't answer.
Connect & test
Finish the channel-specific connection (OAuth callbacks, bot invite, webhook signature secret). Use the built-in test panel to send a sample message and verify the agent responds.
#Permissions and limits
| Field | Type | Description |
|---|---|---|
| Free | no agents | Channel agents require a paid plan. |
| Basic | 1 agent | One concurrent channel agent. |
| Pro | 5 agents | Five concurrent channel agents. |
| Max | 25 agents | Twenty-five concurrent channel agents. |
| Enterprise | unlimited | No agent caps; SLA included. |
#Built-in skill agents on /agents
The /agents page also surfaces all built-in skills as runnable cards. Click Run on any of them to drop the slash command into chat and execute it. This makes /agents a one-stop launcher whether you want to invoke a skill or manage a channel agent.