Skip to content

Update quickstart for managed agent to use the CLI, also changed the …#1118

Open
Aviatorscode2 wants to merge 1 commit into
mainfrom
connect
Open

Update quickstart for managed agent to use the CLI, also changed the …#1118
Aviatorscode2 wants to merge 1 commit into
mainfrom
connect

Conversation

@Aviatorscode2

@Aviatorscode2 Aviatorscode2 commented Jun 4, 2026

Copy link
Copy Markdown
Contributor

Summary by CodeRabbit

Documentation

  • Reorganized agent documentation under new "Connect" section with updated navigation paths and routing structure
  • Added new Managed Agent quickstart guide with comprehensive setup instructions
  • Introduced new Connect overview and mental model reference pages
  • Updated navigation links across custom code and managed agent documentation for improved consistency

@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/6a21720f29b1a00008c5e644
😎 Deploy Preview https://deploy-preview-1118--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 agent documentation by migrating the /agents documentation namespace to /connect. It introduces a new Connect landing page and managed agent quickstart, migrates all custom code and managed agent documentation pages to the new routes, updates integration documentation links across the platform, configures Next.js rewrites to enable the new routes, and adds middleware redirects to maintain backward compatibility for legacy /agents paths.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

  • novuhq/docs#1078: Both PRs modify src/middleware.ts to handle /agents route changes; the referenced PR expands legacy /agents documentation redirects while this PR updates the middleware structure and adds forward redirects from /agents to /connect.
🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
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 (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately captures the primary changes: updating the managed agent quickstart to use the CLI and renaming the documentation route from '/agents' to '/connect'.
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: 2

🧹 Nitpick comments (1)
content/docs/connect/managed-agent/quickstart.mdx (1)

64-69: 💤 Low value

Consider adding periods to bullet points for consistency.

The bullet list items (Name, Identifier, System prompt, Tools, MCP servers, Skills) are not complete sentences but could benefit from periods for consistency with the Novu style guide, which expects bullet points to end with punctuation.

🤖 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/managed-agent/quickstart.mdx` around lines 64 - 69,
Update the bullet list containing the items "Name", "Identifier", "System
prompt", "Tools", "MCP servers", and "Skills" in quickstart.mdx so each bullet
ends with a period for punctuation consistency with the Novu style guide; edit
the six list lines to append a trailing period to each item.
🤖 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: In the sentence that currently reads "Delegate the agent logic
entirely to a managed platform such as Cluade Managed Agents..." replace the
misspelled platform name "Cluade Managed Agents" with the correct "Claude
Managed Agents" so the documentation references the proper managed agent
platform name.
- Line 9: The sentence in the Connect docs contains a missing "to": update the
sentence in content/docs/connect/index.mdx (the string starting "Novu Connect
uses the Agent Communication Infrastructure...") to read "to enable you to
interact with your agents across different messaging platforms" by inserting
"to" between "you" and "interact".

---

Nitpick comments:
In `@content/docs/connect/managed-agent/quickstart.mdx`:
- Around line 64-69: Update the bullet list containing the items "Name",
"Identifier", "System prompt", "Tools", "MCP servers", and "Skills" in
quickstart.mdx so each bullet ends with a period for punctuation consistency
with the Novu style guide; edit the six list lines to append a trailing period
to each item.
🪄 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: 2934a6d1-6def-4dee-ab53-56c6f1b5af2c

📥 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


import { Code2, Sparkles, BrainCircuit, Blocks, MessagesSquare, CircleHelp, Zap } from 'lucide-react';

Novu Connect uses the [Agent Communication Infrastructure (ACI)](/connect/get-started/what-is-aci), which is the infrastructure layer that handles how agents communicate, to enable you interact with your agents across different messaging platforms.

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 grammar: missing "to" in phrase.

The phrase "to enable you interact" is grammatically incorrect.

✏️ Proposed fix
-Novu Connect uses the [Agent Communication Infrastructure (ACI)](/connect/get-started/what-is-aci), which is the infrastructure layer that handles how agents communicate, to enable you interact with your agents across different messaging platforms.
+Novu Connect uses the [Agent Communication Infrastructure (ACI)](/connect/get-started/what-is-aci), which is the infrastructure layer that handles how agents communicate, to enable you to interact with your agents across different messaging platforms.
📝 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
Novu Connect uses the [Agent Communication Infrastructure (ACI)](/connect/get-started/what-is-aci), which is the infrastructure layer that handles how agents communicate, to enable you interact with your agents across different messaging platforms.
Novu Connect uses the [Agent Communication Infrastructure (ACI)](/connect/get-started/what-is-aci), which is the infrastructure layer that handles how agents communicate, to enable you to interact with your agents across different messaging platforms.
🤖 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 9, The sentence in the Connect docs
contains a missing "to": update the sentence in content/docs/connect/index.mdx
(the string starting "Novu Connect uses the Agent Communication
Infrastructure...") to read "to enable you to interact with your agents across
different messaging platforms" by inserting "to" between "you" and "interact".


### 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".

The managed agent platform name is misspelled.

✏️ 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, In the sentence that currently
reads "Delegate the agent logic entirely to a managed platform such as Cluade
Managed Agents..." replace the misspelled platform name "Cluade Managed Agents"
with the correct "Claude Managed Agents" so the documentation references the
proper managed agent platform name.

@DianaHackmamba

Copy link
Copy Markdown
Contributor

This PR is massive. Do you actually want me to review all the files or just a subset?

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