Promote a Workflow
If you've already built a workflow with an agent node, you can promote it to an agent. The promoted agent works exactly like a wizard-built one — same built-in tools, same session lifecycle, same context handling.
When to use this
Use Promote from workflow when:
- You designed and tested the brain workflow visually in the Workflow Builder.
- You need tool wiring or trigger setup that's easier to build in the workflow canvas than the wizard's tile picker.
- You're upgrading an existing workflow into an agent rather than starting from scratch.
If you're starting fresh, the Agent Builder wizard is usually faster.
Requirements
Your workflow must have:
| Requirement | Why |
|---|---|
| Exactly one agent node | A promoted agent has one brain. |
| An LLM node with a real model selected | Placeholders left over from a template will block promotion. |
| At least one trigger (webhook, task-due, REST, cron) | Without one, the agent can't accept messages or scheduled work. |
If any requirement is missing, the promote action shows you which ones in the modal so you can fix them all at once.
How to promote
- Open Workflows, pick the workflow you want to promote.
- Click Promote to Agent.
- (Optional) Select deployed workflows to attach as tools the agent can call.
- Confirm.
If promotion succeeds the workflow becomes an agent and shows up on the Agents page. From there click Start to bring it online.
What you can change after promote
Once promoted, you can edit anything in Agent Settings:
- Model
- Personality
- Operating prompt
- Context policy
- Session policy
- Heartbeat schedule
You can also keep editing the underlying workflow in the Workflow Builder. Some changes (model, personality, policies) take effect after a redeploy — the Settings page surfaces the Apply changes button when needed.