Skip to content

Update quickstart for managed agent #1120

Open
DianaHackmamba wants to merge 1 commit into
mainfrom
update-quickstart
Open

Update quickstart for managed agent #1120
DianaHackmamba wants to merge 1 commit into
mainfrom
update-quickstart

Conversation

@DianaHackmamba

@DianaHackmamba DianaHackmamba commented Jun 4, 2026

Copy link
Copy Markdown
Contributor

This whole quickstart needs more explanation. Tell me (the reader) what is in it for me, what the agent will do, and how it will help me. Get me excited about what I am going to build!

Summary by CodeRabbit

Release Notes

  • Documentation
    • Reorganized agent documentation under new "Connect" section with updated navigation and menu structure.
    • Added comprehensive Managed Agent quickstart guide with step-by-step CLI setup instructions.
    • Added new Connect overview page explaining Agent Communication Infrastructure (ACI) and architecture.
    • Updated all internal documentation links across custom code agents, managed agents, and integration guides.
    • Legacy agent documentation URLs now automatically redirect to new Connect paths.

@greptile-apps

greptile-apps Bot commented Jun 4, 2026

Copy link
Copy Markdown

PR author is not in the allowed authors list.

@netlify

netlify Bot commented Jun 4, 2026

Copy link
Copy Markdown

Deploy Preview for docs-novu ready!

Name Link
🔨 Latest commit 063be37
🔍 Latest deploy log https://app.netlify.com/projects/docs-novu/deploys/6a21c3b20e8e320009505f32
😎 Deploy Preview https://deploy-preview-1120--docs-novu.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@coderabbitai

coderabbitai Bot commented Jun 4, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

📝 Walkthrough

Walkthrough

This PR restructures Novu's documentation by migrating the /agents namespace to /connect. The changes include: updating Next.js routing configuration to handle the new /connect prefix; adding middleware support to redirect legacy /agents URLs to /connect; creating a new Connect documentation hub with an overview page; updating custom code agent documentation (quickstart, concepts, build guide, and setup pages) with new routing paths; creating a managed agent quickstart and updating all managed agent documentation pages; and updating cross-references in integration documentation. The PR maintains backward compatibility through redirect logic while establishing the new documentation structure.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

  • novuhq/docs#1078: Updates /agents documentation section detection and routing in middleware and configuration, which complements this PR's namespace reorganization from /agents to /connect.
🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (2 warnings)

Check name Status Explanation Resolution
Title check ⚠️ Warning The PR title is misleading—it claims to update the managed agent quickstart, but the actual changes go far beyond that, including extensive documentation route migrations from /agents to /connect across the entire documentation structure. Revise the title to accurately reflect the scope, such as 'Migrate documentation routes from /agents to /connect and update managed agent quickstart' to better represent the comprehensive changes made throughout the codebase.
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (1)
content/docs/connect/index.mdx (1)

54-56: ⚡ Quick win

Consider differentiating the quickstart descriptions.

The descriptions for both the managed agent quickstart (lines 54-55) and custom code agent quickstart (lines 75-76) are identical: "Connect a Slack provider and send your first message in under 5 minutes." While both are quickstarts, differentiating these descriptions would help readers understand the key difference between the two approaches at a glance.

For example:

  • Managed agent: "Set up a Claude-powered agent and send your first message in under 5 minutes."
  • Custom code agent: "Build your own agent with custom code and connect to Slack in under 5 minutes."

Also applies to: 75-77

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@content/docs/connect/index.mdx` around lines 54 - 56, The two Card
descriptions are identical; update the description text for the Card with
href="/connect/managed-agent/quickstart" (title "Quickstart") to something like
"Set up a Claude-powered agent and send your first message in under 5 minutes."
and update the Card for the custom code quickstart (the Card with
href="/connect/custom-agent/quickstart" or the second quickstart Card in this
file) to something like "Build your own agent with custom code and connect to
Slack in under 5 minutes." Ensure you only change the inner text of those Card
components so the titles/links remain unchanged.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@content/docs/connect/index.mdx`:
- Line 28: Fix the typo in the text "Cluade Managed Agents" by replacing it with
"Claude Managed Agents" wherever it appears (specifically the sentence that
starts "Delegate the agent logic entirely to a managed platform such as Cluade
Managed Agents."); update the string to "Claude Managed Agents" to correct
spelling and ensure consistent usage across the document.

---

Nitpick comments:
In `@content/docs/connect/index.mdx`:
- Around line 54-56: The two Card descriptions are identical; update the
description text for the Card with href="/connect/managed-agent/quickstart"
(title "Quickstart") to something like "Set up a Claude-powered agent and send
your first message in under 5 minutes." and update the Card for the custom code
quickstart (the Card with href="/connect/custom-agent/quickstart" or the second
quickstart Card in this file) to something like "Build your own agent with
custom code and connect to Slack in under 5 minutes." Ensure you only change the
inner text of those Card components so the titles/links remain unchanged.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: bc483baa-4ce1-4233-8668-54aa61edf8ec

📥 Commits

Reviewing files that changed from the base of the PR and between 112a194 and 063be37.

⛔ Files ignored due to path filters (2)
  • public/images/agents/managed-agent/agent-message-slack.png is excluded by !**/*.png
  • public/images/agents/managed-agent/novu-connect-demo.gif is excluded by !**/*.gif
📒 Files selected for processing (37)
  • content/docs/agents/managed-agent/quickstart.mdx
  • content/docs/connect/conversations.mdx
  • content/docs/connect/custom-code-agent/build-your-first-agent.mdx
  • content/docs/connect/custom-code-agent/concepts.mdx
  • content/docs/connect/custom-code-agent/going-to-production.mdx
  • content/docs/connect/custom-code-agent/meta.json
  • content/docs/connect/custom-code-agent/quickstart.mdx
  • content/docs/connect/custom-code-agent/setup-your-agent/connect-components.mdx
  • content/docs/connect/custom-code-agent/setup-your-agent/connect-components.model.mdx
  • content/docs/connect/custom-code-agent/setup-your-agent/create-an-agent.mdx
  • content/docs/connect/custom-code-agent/setup-your-agent/edit-sent-messages.mdx
  • content/docs/connect/custom-code-agent/setup-your-agent/handle-events.mdx
  • content/docs/connect/custom-code-agent/setup-your-agent/meta.json
  • content/docs/connect/custom-code-agent/setup-your-agent/overview.mdx
  • content/docs/connect/custom-code-agent/setup-your-agent/reply.mdx
  • content/docs/connect/custom-code-agent/setup-your-agent/scaffold-your-project.mdx
  • content/docs/connect/custom-code-agent/setup-your-agent/signals.mdx
  • content/docs/connect/get-started/agents-and-providers.mdx
  • content/docs/connect/get-started/mental-model.mdx
  • content/docs/connect/get-started/meta.json
  • content/docs/connect/get-started/what-is-aci.mdx
  • content/docs/connect/index.mdx
  • content/docs/connect/managed-agent/add-skills.mdx
  • content/docs/connect/managed-agent/concepts.mdx
  • content/docs/connect/managed-agent/configure-mcp-servers.mdx
  • content/docs/connect/managed-agent/meta.json
  • content/docs/connect/managed-agent/overview.mdx
  • content/docs/connect/managed-agent/quickstart.mdx
  • content/docs/connect/meta.json
  • content/docs/meta.json
  • content/docs/platform/integrations/chat/(providers)/ms-teams.mdx
  • content/docs/platform/integrations/chat/(providers)/slack.mdx
  • content/docs/platform/integrations/chat/(providers)/whats-app.mdx
  • content/docs/platform/integrations/chat/index.mdx
  • next.config.mjs
  • src/app/layout.config.tsx
  • src/middleware.ts
💤 Files with no reviewable changes (1)
  • content/docs/agents/managed-agent/quickstart.mdx


### External connectors

Delegate the agent logic entirely to a managed platform such as Cluade Managed Agents. You configure the agent's behavior, system prompt, tools, skills, and MCP servers and the platform runs the intelligence.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Fix typo: "Cluade" should be "Claude".

Line 28 contains a typo: "Cluade Managed Agents" should be "Claude Managed Agents".

✏️ Proposed fix
-Delegate the agent logic entirely to a managed platform such as Cluade Managed Agents. You configure the agent's behavior, system prompt, tools, skills, and MCP servers and the platform runs the intelligence.
+Delegate the agent logic entirely to a managed platform such as Claude Managed Agents. You configure the agent's behavior, system prompt, tools, skills, and MCP servers and the platform runs the intelligence.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
Delegate the agent logic entirely to a managed platform such as Cluade Managed Agents. You configure the agent's behavior, system prompt, tools, skills, and MCP servers and the platform runs the intelligence.
Delegate the agent logic entirely to a managed platform such as Claude Managed Agents. You configure the agent's behavior, system prompt, tools, skills, and MCP servers and the platform runs the intelligence.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@content/docs/connect/index.mdx` at line 28, Fix the typo in the text "Cluade
Managed Agents" by replacing it with "Claude Managed Agents" wherever it appears
(specifically the sentence that starts "Delegate the agent logic entirely to a
managed platform such as Cluade Managed Agents."); update the string to "Claude
Managed Agents" to correct spelling and ensure consistent usage across the
document.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants