Skip to content

docs: add Flows in Studio documentation#6575

Merged
vinibrsl merged 3 commits into
mainfrom
docs/studio-flows
Jul 16, 2026
Merged

docs: add Flows in Studio documentation#6575
vinibrsl merged 3 commits into
mainfrom
docs/studio-flows

Conversation

@jessemiller

@jessemiller jessemiller commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

What

Adds documentation for the new Flows in Studio feature — the new build mode alongside Crews in Studio.

Contents

  • New page: edge/*/enterprise/features/studio-flows covering:
    • Why Flows: deterministic step-by-step control combined with agentic intelligence within each step
    • The three core node types: Single Agent (with full config panel walkthrough), Crews, and Router
    • Agent Repository sync: publishing agents from a Flow to the repository and pulling repository agents into new Flows, synced org-wide
    • Best practices and related links
  • Rollout banner noting the feature rolls out through the week of July 20th, so readers who don't yet see Flows in product know why
  • Translations: Portuguese (pt-BR), Korean, and Arabic
  • Navigation: added to the edge version in all four languages; the "Crew Studio" nav group is renamed to "Studio" to match the product, which is now one Studio with a Crews/Flows selector
  • Screenshots: six product screenshots added under docs/images/enterprise/studio-flows-*.png, downscaled to match existing docs image sizes

Note: only edge is touched — versioned snapshots (e.g. v1.15.2) are updated by a separate script.

Verification

  • docs.json validates as JSON
  • mint broken-links passes with no broken links
  • Verified in local Mintlify preview

🤖 Generated with Claude Code


Note

Low Risk
Documentation and navigation-only changes with no application or runtime code impact.

Overview
Adds Flows in Studio enterprise docs for the edge docs version in en, pt-BR, ko, and ar, and wires them into Mintlify navigation.

Each new studio-flows page documents the Crews/Flows build mode: rollout notice, why Flows vs Crews, building via Studio Assistant, Single Agent, Crew, and Router nodes, Agent Repository publish/pull, best practices, and related links (with shared studio-flows-*.png screenshots).

In docs.json, the Build nav group Crew Studio is renamed Studio (localized where applicable), and studio-flows is listed alongside crew-studio and merged-step-card in all four locales.

Reviewed by Cursor Bugbot for commit 85b4a06. Bugbot is set up for automated code reviews on this repo. Configure here.

Documents the new Flows build mode in Studio: why deterministic
workflows with agentic steps matter, the three core node types
(Single Agent, Crews, Router), and Agent Repository publish/pull
sync across organizations.

Includes a rollout banner for the week of July 20th, English source
plus pt-BR, Korean, and Arabic translations, and nav entries for
both edge and v1.15.2 (Crew Studio group renamed to Studio).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Jul 16, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

Studio Flows documentation was added in English, Portuguese, Korean, and Arabic. Each locale’s Studio navigation group now includes the new page alongside Crew Studio.

Changes

Studio Flows documentation

Layer / File(s) Summary
Flow page foundation and build workflow
docs/edge/{en,pt-BR,ko,ar}/enterprise/features/studio-flows.mdx
Adds localized metadata, rollout notices, Flow concepts, Crew comparisons, and build, test, deploy, share, and download guidance.
Flow nodes and Agent Repository synchronization
docs/edge/{en,pt-BR,ko,ar}/enterprise/features/studio-flows.mdx
Documents Single Agent, Crew, and Router nodes plus Agent Repository publishing and pulling.
Best practices and documentation navigation
docs/edge/{en,pt-BR,ko,ar}/enterprise/features/studio-flows.mdx, docs/docs.json
Adds best practices and related-document links, and exposes Studio Flows in each locale’s Studio navigation group.

Suggested reviewers: lorenzejay, lucasgomide

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
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.
Title check ✅ Passed The title clearly and concisely summarizes the main change: adding Flows in Studio documentation.
Description check ✅ Passed The description is directly related to the documentation and navigation changes in this pull request.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/studio-flows

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.

@mintlify

mintlify Bot commented Jul 16, 2026

Copy link
Copy Markdown

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

Project Status Preview Updated (UTC)
crewai 🟢 Ready View Preview Jul 16, 2026, 7:04 PM

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

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 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 `@docs/v1.15.2/en/enterprise/features/studio-flows.mdx`:
- Around line 1-3: Remove the manually added studio-flows.mdx files from
docs/v1.15.2/en/enterprise/features/studio-flows.mdx,
docs/v1.15.2/ar/enterprise/features/studio-flows.mdx,
docs/v1.15.2/ko/enterprise/features/studio-flows.mdx, and
docs/v1.15.2/pt-BR/enterprise/features/studio-flows.mdx; no replacement changes
are needed.
🪄 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 Plus

Run ID: c3c30233-cd4f-4e65-93b9-f2d7f6e7757c

📥 Commits

Reviewing files that changed from the base of the PR and between a1021de and 8df1198.

⛔ Files ignored due to path filters (6)
  • docs/images/enterprise/studio-flows-agent-config.png is excluded by !**/*.png
  • docs/images/enterprise/studio-flows-agent-node.png is excluded by !**/*.png
  • docs/images/enterprise/studio-flows-crew-detail.png is excluded by !**/*.png
  • docs/images/enterprise/studio-flows-crew-node.png is excluded by !**/*.png
  • docs/images/enterprise/studio-flows-router-node.png is excluded by !**/*.png
  • docs/images/enterprise/studio-flows-selector.png is excluded by !**/*.png
📒 Files selected for processing (9)
  • docs/docs.json
  • docs/edge/ar/enterprise/features/studio-flows.mdx
  • docs/edge/en/enterprise/features/studio-flows.mdx
  • docs/edge/ko/enterprise/features/studio-flows.mdx
  • docs/edge/pt-BR/enterprise/features/studio-flows.mdx
  • docs/v1.15.2/ar/enterprise/features/studio-flows.mdx
  • docs/v1.15.2/en/enterprise/features/studio-flows.mdx
  • docs/v1.15.2/ko/enterprise/features/studio-flows.mdx
  • docs/v1.15.2/pt-BR/enterprise/features/studio-flows.mdx

Comment thread docs/v1.15.2/en/enterprise/features/studio-flows.mdx Outdated
Versioned snapshots are updated by a separate script, so remove the
v1.15.2 copies and revert its nav changes; the page now lives only
under edge.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@github-actions github-actions Bot added size/L and removed size/XL labels Jul 16, 2026
@vinibrsl
vinibrsl merged commit df2e68f into main Jul 16, 2026
56 of 57 checks passed
@vinibrsl
vinibrsl deleted the docs/studio-flows branch July 16, 2026 20:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants