Overview of Managed Agents

What managed agents are, how they work, and when to use them.

Agents are currently in private beta. Please contact us at support@novu.co to get access.

A managed agent lets you connect an AI platform like Claude directly to your Novu agent. The platform handles the reasoning, planning, and tool use. You configure credentials and a system prompt in the Novu dashboard, connect a chat provider like Slack, and the agent is ready to talk to your users. No bridge application or handler code is required.

Managed agent flow

How it works

A user sends a message on a connected provider (Slack, Microsoft Teams, email, etc.).
Novu receives the message, resolves identity and conversation state, and forwards the full context to the AI platform.
The platform processes the message using its built-in tools (bash, file operations, web search, grep, etc.), any MCP servers you enabled, and any custom skills you uploaded.
Novu delivers the response back to the same thread on the provider.

You do not write event handlers or deploy a bridge server. The AI platform is your agent logic.

What you configure

Setting up a managed agent involves five pieces, all configured from the Novu dashboard:

Connector: the AI platform that powers the agent (Claude today, with OpenAI and AWS Bedrock coming soon). You provide API credentials or use Novu demo credentials to start.
System prompt: instructions that tell the agent who it is, how to respond, and what to avoid.
Built-in tools: bash, file read/write/edit, glob, grep, web search, and web fetch are provided by the platform and available out of the box.
MCP servers: external integrations like Linear, GitHub, Slack, and Notion that you enable from the dashboard. Some require end-user OAuth authorization.
Custom skills: SKILL.md instruction files you upload from a GitHub URL or paste inline to teach the agent domain-specific workflows.

For a full breakdown of each component, see Concepts.

When to use a managed agent

Managed agents are a good fit when you want to get an agent running quickly without writing backend code. The platform handles tool calls, streaming, and chain-of-thought reasoning for you.

If you need full control over the agent logic, want to call your own APIs directly in handlers, or need complex multi-step business flows, use a custom code agent instead.