Skip to content

docs: add Autonomous Agents documentation tab to AI Builder Portal#151

Open
evoxmusic wants to merge 20 commits into
mainfrom
docs/autonomous-agents
Open

docs: add Autonomous Agents documentation tab to AI Builder Portal#151
evoxmusic wants to merge 20 commits into
mainfrom
docs/autonomous-agents

Conversation

@evoxmusic

Copy link
Copy Markdown
Contributor

Summary

Adds a new Autonomous Agents tab to the AI Builder Portal documentation, covering the full autonomous agent lifecycle - from blueprint creation through Linear integration and run management.

What's Included

New pages (5)

  • docs/rde/agents/overview.mdx - Landing page: concept, supported runtimes, comparison with workspaces
  • docs/rde/agents/getting-started.mdx - End-to-end setup: create agent blueprint wizard, trigger first run
  • docs/rde/agents/agent-blueprints.mdx - Configuration reference: all settings, runtimes, API keys
  • docs/rde/agents/managing-runs.mdx - Runs dashboard, statuses, lifecycle actions, topology graph, manual run creation
  • docs/rde/agents/linear-integration.mdx - Linear setup, issue flow, state mapping, lifecycle comments, concurrency

Updated pages (4)

  • docs/rde/overview.mdx - Added agents to Key Capabilities, blueprint types section, fixed CLI link
  • docs/rde/admin/blueprint-management.mdx - Added Info callout about blueprint type chooser (Workspace vs Agent)
  • docs/rde/reference/architecture.mdx - Added autonomous agent architecture section with sequence diagram
  • docs/rde/reference/troubleshooting.mdx - Added 5 agent-specific troubleshooting accordions

Infrastructure

  • docs/snippets/rde-preview-warning.mdx - Extracted preview warning into reusable snippet
  • docs/docs.json - Added "Autonomous Agents" tab (icon: robot) between "For Admins" and "For Users"

Design Decisions

  • Separate tab, same product: Agents get their own focused tab within the AI Builder Portal product rather than being mixed into "For Admins". Shared concepts (blueprints, security, architecture) are cross-linked, not duplicated.
  • Linear as first tracker: Documentation covers Linear integration with an Info callout noting Jira and GitHub Issues are planned.
  • 5 supported runtimes: Claude Code, OpenCode, Codex, Gemini CLI, Cursor CLI - all documented with CLI commands and API key env vars.

Corresponds to

Portal changes in rde-portal introducing the autonomous agents feature (agent blueprints, Linear integration, runs management, topology graph).

@evoxmusic evoxmusic requested a review from a team June 7, 2026 06:15
@mintlify

mintlify Bot commented Jun 7, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
qovery 🟢 Ready View Preview Jun 7, 2026, 6:17 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jun 7, 2026

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Updated (UTC)
✅ Deployment successful!
View logs
qovery-doc-mintlify-proxy 76caf89 Jun 08 2026, 12:17 PM

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