A flow builder for visually composing and running multi-agent workflows
Agent Flow lets you build complex AI pipelines by visually connecting agents, models, and knowledge bases.
It is a visual workflow builder similar to n8n or Dify — you can compose multi-agent orchestration entirely by drag and drop.
Three conditions must all be met for the Flows tab to appear in your workspace.
The environment must be licensed for agent_flow
Your account must have Flow permission (workspace.agent_flows) — admins always qualify
The address you connect to must be a preview host — Flows is still a preview feature, so the menu appears only on designated development and demo hosts
Because of the third condition, the menu will not appear on a regular production address even with the license and the permission in place. Contact your administrator if you need access.
Flow vs. Single Agent
Aspect
Single Agent
Agent Flow
Complexity
Simple Q&A
Multi-step pipeline
Agent chaining
Runs standalone
Passes data between agents
Conditional branching
Not available
Branch with Condition / Router nodes
Data transformation
Not available
Jinja2 template in the Transform node
Safety checks
Per agent
Guardrail node inside the flow
Human approval
Not available
Mid-flow approval with the Approval Gate node
Batch processing
Not available
Per-item parallel processing with the Iteration node
Reuse
Individual calls
Nest pipelines with Subflow
External invocation
Chat
Chat + webhook endpoint
A single agent is enough for simple Q&A or RAG retrieval.
Use a flow when you need to chain several agents sequentially or conditionally.
Flow List
Workspace > Flows shows every flow that has been created.
Flow list
Each flow card shows:
Element
Description
Active / Inactive badge
Whether the flow is active
Node count
Number of nodes in the flow
Name
Flow identifier name
Description
What the flow is for
Author
Shown as “By {author name}“
Updated
Time of the last change (relative)
Use All / My Flows at the top to narrow the list, or Search Flows to filter by name.
The ⋯ menu at the top-right of each card offers Duplicate, Delete, and the Active / Inactive toggle.
An inactive flow is blocked both in the chat model list and for webhook calls. For a flow you want to pause rather than lose, switch it to inactive instead of deleting it — the configuration is preserved.
Creating a Flow
1
Create a new flow
In Workspace > Flows, click + New Flow at the top right.
After entering the create screen
Fill in the basics in the left panel.
Field
Description
Example
Enter flow name
Display name of the flow
”Document Analysis Flow”
Flow ID
2–50 character identifier starting with a lowercase letter or digit
doc-analysis
Enter description
What the flow is for
”Summarizes documents and extracts key points”
Stateful
Keep conversation state across runs (on by default)
On
Flow ID availability is checked as you type — a green check when it is free, a red X with “This Flow ID is already in use” when it is taken.
The Flow ID cannot be changed after creation. The on-screen hint mentions lowercase letters, numbers, and hyphens, but underscores (_) are accepted as well (^[a-z0-9][a-z0-9_-]*$).
2
Start from a template, or from an empty canvas
The empty canvas of a new flow opens with the Start from a template gallery. Picking a card starts you off with nodes and edges already laid out.
Template
What it does
Simple LLM Response
Answers the user input with a single model call
Guarded Agent Answer
Screens the input with a guardrail, then lets an agent answer when it passes
Intent Routing
Routes to differently prompted models depending on question / request / other
Parallel Model Compare
Sends the same input to two models in parallel and merges both answers
Knowledge Base Q&A
Retrieves documents from a knowledge base and answers using that context
Summarize Pipeline
Summarizes with a model, then formats the result with a transform template
Click Build from scratch (✕) at the top right of the gallery to dismiss it and build on an empty canvas.
Templates lay out the skeleton only. Resources such as models, agents, and knowledge bases must be selected on each node before the flow will run.
Picking a template turns the Stateful toggle off, because the template replaces the whole flow configuration. If the flow should keep conversation context, switch Stateful back on after choosing a template.
3
Place nodes
Drag a node from the Node panel on the left onto the canvas, or click it to drop it at the center of the canvas.
As the palette grows, filter it with the Search nodes box at the top.
Dragged nodes land where you drop them; clicked nodes land at the center of the canvas
4
Connect nodes
Drag from a node’s output handle (dot on the right) to the next node’s input handle (dot on the left).
Data flows left to right.
Handle positions: left = input, right = output.
Branching nodes — Condition, Router, Guardrail, Approval Gate — stack multiple output handles vertically on the right.
The Start node has no input handle, and the Output node has no output handle.
5
Configure nodes
Clicking a node opens its settings panel on the right.
For an Agent node pick the agent to run; for a Model node pick the LLM and set the system / user prompts.
Drag the panel’s left edge to resize it.
Validate and Save & Create in the top toolbar are separate actions.
Validate — checks for problems and marks failing nodes on the canvas with a red ring
Save & Create — creates the flow and moves to the edit screen. Saving does not run validation automatically
The dot before the flow name in the toolbar shows validation status.
Dot color
Meaning
Gray
Not validated since last edit
Green
Flow is valid
Amber
Validation errors
Editing the canvas turns the dot gray again — this keeps a stale green result from implying the current graph is still valid.
Save Draft and Publish
Once a flow exists, saving happens in two stages. Saving on the edit screen only updates the draft; publishing is what changes the version that actually runs.
Button
What it does
Save Draft
Saves the current canvas as a draft. The live flow is untouched
Publish
Promotes the draft to live. The previous live version is kept as a version snapshot
When an unpublished draft exists, the Publish button carries an amber Unpublished draft dot and a banner appears above the canvas.
Editing draft — the live flow is unchanged until you publish
Discard draft on the right of the banner asks “Discard this draft and return to the live version?” and then restores the canvas to the live version.
If you only save a draft and leave, nothing changes for your users. Chat and webhook calls keep running the previously published version. Press Publish to actually roll the change out.
This does not apply while creating a flow. The create screen has a single Save & Create button; the split into Save Draft / Publish begins on the edit screen.
Reverting to a previous version
Each publish pushes the previous live version onto a snapshot stack (up to 20, oldest dropped beyond that).Open the Versions tab in the test drawer to review the publish history and press Restore — the snapshot comes back as a draft. Review it on the canvas and press Publish to make the rollback final.
Node Types
Agent Flow provides 13 nodes across 4 categories.
Category
Nodes
Description
General
Start, Output
Flow entry / exit
Agents
Agent, Model, Supervisor
Run an agent, call an LLM directly, coordinate worker agents
Use the Validate button in the top toolbar. Failing nodes are marked on the canvas with a red ring.
Errors — must be fixed to run
Check
Description
Missing resource
An Agent / Model / Guardrail / Knowledge / Glossary node with no resource selected
Incomplete supervisor
No supervisor model selected, or zero workers
Incomplete subflow
No flow selected, or the node references itself
Iteration model missing
LLM mode with no model selected
Dangling edge
An edge pointing at a deleted node
Unsupported node type
A type the builder does not handle (imported legacy flows, etc.)
Loop without exit
A cycle with no conditional branch leaving it
Warnings — the flow still runs
Check
Description
No Input node
The first node in the flow is used as the entry point
No Output node
Leaf nodes automatically connect to the flow end
Orphan node
A node connected to nothing (a single-node flow is fine)
Loop detected
The graph contains a cycle
Missing Start / Output nodes are not errors. Implicit entry and exit are supported, so they are reported as warnings only. Adding both is still clearer about intent.
Loops are a supported feature
If a Condition, Router, or Guardrail branch inside the cycle leaves it, the loop is considered safe and only a warning is reported. It is an error only when no branch leaves the cycle at all.Execution is bounded by a superstep limit (50 by default), and loop exits are built by combining {Label.loop_count} with a Greater than condition in a Condition node.
Running a Flow
There are three ways to run a flow.
Test in the editor
Run from Chat
Call by webhook
Test Run in the toolbar opens a test drawer below the canvas. It runs the current canvas as-is, unsaved, so you can check behavior before publishing.The drawer has three tabs.
Tab
Contents
Test Run
Enter test input and press Run. Shows per-node progress and the final output
Run History
Execution history for this flow (owners and admins see all runs; shared users see only their own)
Versions
Publish history and Restore
While running, each node’s status (running / completed / error) appears on the canvas and in the step list at the same time, and clicking a step expands a preview of that node’s output. With a KBSphere agent the number of retrieved sources is shown as well.Drag the top edge of the drawer to resize it.
If the flow contains an Approval Gate, execution stops there and an Approval required card appears. Add a note and press Approve or Reject to resume from that point.
Start a new chat
In the model selector, a Flow connection type filter appears. Select it
Pick the flow, then type your message
Flows appear in the model selector as a connection type filter, not as a separate tab. The filter only shows up when at least one flow is available to you.
Chat runs carry state per conversation, so context is preserved within a chat regardless of the Stateful toggle.
The Webhook endpoint is shown near the bottom of the left panel on the edit screen. Copy URL copies the full address.
POST /api/v1/agent-flows/{flow ID}/invoke
Request field
Description
input
Input passed to the flow (required)
stream
true for an SSE stream; defaults to false
session_id
Conversation session key. Supplying it keeps state per session
The default response is JSON containing flow_id, session_id, and output.
The endpoint also accepts an API key (Bearer sk-...), which makes it usable from external systems. The caller needs read access to the flow, and calls to an inactive flow are rejected.
Stateful
The Stateful toggle in the left panel of the edit screen controls whether conversation state is kept across runs (on by default for new flows).
Chat runs — state is kept per conversation automatically, regardless of the toggle
Non-chat runs (webhook, embed, scheduled tasks) — the toggle must be on and a session_id supplied for state to carry across calls
Building a Flow with AI
The violet AI Assistant button at the bottom right of the editor opens a conversational builder. Describe the flow you want in plain language and the AI generates the nodes and edges directly onto the canvas.
1
Pick a model
Choose the model the builder should use in the selector in the panel header.
2
Describe your intent
Describe the flow you want, e.g. “Build a flow that classifies customer inquiries by department.”
Suggestion chips are shown when the panel first opens — click one to start immediately.
3
Answer the AI's questions
The AI asks follow-ups — whether to use a guardrail, which routing style, and so on — as buttons. Click the option you want.Examples:
“Should we use a guardrail?” → [PII protection][Banned words][None]
Once it has enough information, the nodes and edges are placed on the canvas. Keep the conversation going to refine them.
“Change the router node to a condition”
“Add agent C in the middle”
“Remove the guardrail node”
Being specific up front skips the follow-up questions. For example: “Build a flow with a PII guardrail → sentiment routing → separate agents for positive and negative.”
AI builder features
Conversation history — the transcript is stored with the flow, so you can pick up where you left off
Editing existing flows — opened on an existing flow, it reads the current structure and proposes changes
Live canvas updates — generated nodes appear on the canvas immediately
Resizable panel — drag the handle at the top of the panel
The AI Assistant button is shown only to users with write access to the flow.
Anything the AI generates can still be edited by hand. Sketching the skeleton with AI and tuning each node yourself works well. Results stay a draft until you publish, so there is little risk in experimenting.
Export / Import
Export and import are performed from the flow editor’s top toolbar.
Export
Import
Click Export in the toolbar to download a JSON file.
The file contains the flow name, description, node configuration, and connections.
Click Import in the toolbar and upload a previously exported JSON file.
Only JSON of the form type: "agent_flow" is accepted.
Agents, models, and guardrails referenced by the imported flow must exist in the current environment. Press Validate first to surface any missing-resource errors.
Inputs containing personal information are blocked, and only safe inputs reach the agent.
Setting Block Action to Continue lets you shape the block information in a Transform node and explain it to the user.
A model-written draft only reaches the send step after a person reviews it.
Set On Reject to Take the reject branch to design a rejection path, or Stop the flow to end there.
Given a newline-separated list or a JSON array as input, the Iteration node runs each item through the LLM in parallel and joins the results.
Control the load with Concurrency (1–8) and Max Items.
Access Control
Flows use the same access control as other workspace resources.For flows, both the create and the edit screen open the access control modal from the lock-icon [Access] button in the top toolbar — unlike other resources, there is no inline permission area on the screen itself.Pick the sharing scope with the Access permission selector in the modal.
Option
Description
Everyone
Readable by all users
Selected groups only
Available to members of the groups listed under Accessible groups
A group in the table has read access by that fact alone; check the Editable column to grant write access as well.
A newly created flow is readable by everyone by default. Along with channels, this is one of the few exceptions in the workspace — to narrow it, open the flow after creating it and switch Access permission to Selected groups only yourself.
The Everyone option is shown to admins only. Regular users see just Selected groups only.
You must press Apply in the access control modal. Selecting groups and closing the modal does not save the change. After applying, you still need to press Save & Create (create) or Save Draft · Publish (edit) to persist it.
Organization units cannot be selected on this screen. To open access to an organization unit, an administrator must link the organization unit to a group — users in that organization are then treated as members of the group. See Sharing & Permissions for details.
FAQ
I can't see the Flows menu
The Flows tab requires all three of the following:
An environment licensed for agent_flow
Flow permission on your account (workspace.agent_flows)
A connection address that is a preview host
Flows is still a preview feature, so even with the license and permission the menu will not appear on a regular production address. Ask your administrator to confirm.
I saved, but chat still behaves the old way
Save Draft on the edit screen does not change the live flow. You must press Publish for chat and webhook calls to pick it up.If the “Editing draft” banner is above the canvas, or the Publish button has an amber dot, the change is still unpublished.
Which agents can I use in a flow?
Every agent registered in the workspace.
Standard mode, KBSphere (enhanced RAG), and DBSphere (database) modes are all supported.
What happens when a flow hits an error?
By default, execution stops at the failing node and an error message is shown.To handle it differently per node, open the Error handling & retry section at the bottom of the settings panel and set On error (Stop the flow / Skip and continue / Use default value) along with Max retries, Retry interval, and Timeout. Every node except Start has this section.
There is no separate Error Handler node.
Can I run the same node repeatedly?
Two ways:
Iteration node — for processing many items at once in parallel (concurrency 1–8)
Loop edges — a cycle that returns to an earlier node based on a condition. Fully supported, provided one Condition / Router / Guardrail branch leaves the loop
Loop execution is bounded by a superstep limit (50 by default), and the exit is built by combining {Label.loop_count} with a Greater than condition.
Can one flow connect several agents?
Yes — chain agents sequentially or branch with Condition / Router nodes.
Each agent’s output is passed automatically as the next agent’s input.To have one model split work across several agents and combine the results, use the Supervisor node.
In what order does a flow execute?
Execution starts at the Start node and follows the connected nodes in order.
A Condition node branches to the true or false path based on its evaluation, and a Router node branches to the matching route.
A Merge node is where parallel paths join.Without a Start node the first node becomes the entry point; without an Output node the leaf nodes become the exit.
How do I roll back to an earlier version?
Open the Versions tab in the test drawer, review the publish history, and press Restore.
Restore brings that version back as a draft, so review it on the canvas and press Publish to make the rollback final.Up to 20 snapshots are retained.
How do I move a flow to another environment?
Use Export in the editor toolbar to download a JSON file, then Import it in the target environment’s editor.
The referenced agents, models, and guardrails must exist there too — press Validate after importing to confirm.
Next Steps
Node Reference
Settings and State keys for all 13 nodes
Create an Agent
Configure the agents your flow will use
Configure Guardrails
Set up filters for safe responses inside a flow
Sharing & Permissions
How the access control modal works
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cloosphere Guide","colors":{"primary":"#5f22d0","light":"#7c3aed","dark":"#4c1d95"},"logo":{"light":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","dark":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","href":"/ko/index"},"favicon":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/favicon.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=0e41ff0755aa623d52e26f279f285f71","appearance":{"default":"system","strict":false},"interaction":{"drilldown":true},"styling":{"latex":false},"navigation":{"languages":[{"language":"ko","default":true,"href":"ko"},{"language":"en","href":"en"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cloocus","hasAudioNarration":false,"actualSubdomain":"cloocus","customDomains":["docs.cloosphere.ai"],"gitSource":{"type":"github","owner":"ais-cloocus","repo":"cloosphere-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6a954066df6b735599399868","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"en","tag":"Admin","count":30},{"language":"ko","tag":"관리자","count":30},{"language":"en","tag":"Settings","count":24},{"language":"ko","tag":"설정","count":24},{"language":"en","tag":"Monitoring","count":21},{"language":"ko","tag":"모니터링","count":21},{"language":"en","tag":"Workspace","count":16},{"language":"ko","tag":"워크스페이스","count":16},{"language":"en","tag":"Chat","count":11},{"language":"ko","tag":"채팅","count":11},{"language":"en","tag":"Getting Started","count":10},{"language":"ko","tag":"시작하기","count":10},{"language":"en","tag":"Collaboration","count":8},{"language":"ko","tag":"협업","count":8},{"language":"en","tag":"Data \u0026 Operations","count":6},{"language":"ko","tag":"운영 · 지원","count":6},{"language":"ko","tag":"데이터 및 운영 보안","count":6},{"language":"en","tag":"AI Features \u0026 Safety","count":5},{"language":"en","tag":"UI \u0026 Channels","count":5},{"language":"ko","tag":"AI 기능 및 안전","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--brand-primary: #5f22d0;--brand-light: #7c3aed;--brand-dark: #4c1d95;--brand-subtle: #ede9fe;--brand-glow: rgba(95, 34, 208, 0.15);--page-text: #0f172a;--page-muted: #6b7280}body{font-family:\"DM Sans\", sans-serif;color:var(--page-text);font-size:17px}.prose h1,.prose h2,.prose h3,.prose h4{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;letter-spacing:-0.015em}.prose h1{font-size:44px}.prose h2{font-size:28px;margin-top:36px;margin-bottom:10px}.prose h3{font-size:22px;margin-top:28px;margin-bottom:8px}.prose p,.prose li{color:var(--page-text);line-height:1.75;font-size:1rem}.prose hr{border:0;height:1px;background:linear-gradient(90deg, rgba(148, 163, 184, 0.4), rgba(148, 163, 184, 0.05));margin:28px 0}.dark body{color:#e2e8f0}.dark .prose p,.dark .prose li{color:#e2e8f0}.dark .prose hr{background:linear-gradient(90deg, rgba(148, 163, 184, 0.3), rgba(148, 163, 184, 0.05))}[class*=\"Card\"] svg,.card svg,a[href] svg{color:var(--brand-primary)!important}.card [data-component-part=\"card-icon\"]{margin-bottom:8px}.card [data-component-part=\"card-title\"]{margin-top:12px!important}[class*=\"Card\"],.card{border-radius:16px!important;border-color:rgba(148, 163, 184, 0.25)!important;transition:border-color 0.2s ease, box-shadow 0.2s ease, transform 0.2s ease}[class*=\"Card\"]:hover,.card:hover{transform:translateY(-2px);border-color:var(--brand-light)!important;box-shadow:0 4px 20px var(--brand-glow)!important}a:not([class*=\"Card\"]):hover{color:var(--brand-primary)!important}.stable-scrollbar-gutter.overflow-auto{width:220px!important;min-width:220px!important}.stable-scrollbar-gutter.overflow-auto+div,.stable-scrollbar-gutter.overflow-auto~main{flex:1!important}.flex.flex-row-reverse.gap-12{gap:32px!important}.xl\\:flex.self-start.sticky{max-width:15rem!important}.xl\\:flex.box-border.max-h-full.pl-10{width:14rem!important;padding-left:24px!important}.text-sm.leading-6.w-\\[16\\.5rem\\]{width:100%!important;font-size:13px!important;line-height:1.6!important}#table-of-contents-content a{padding:5px 0!important;display:block}#table-of-contents-content,#table-of-contents-content ul{list-style:none!important;padding-left:0!important;margin-left:0!important}#table-of-contents-content li::marker{content:\"\"!important}#table-of-contents-content>li{border-left:2px solid rgba(148, 163, 184, 0.1);padding-left:12px;transition:border-color 0.15s ease}.dark #table-of-contents-content>li{border-left-color:rgba(148, 163, 184, 0.08)}#table-of-contents-content a{color:var(--page-muted)!important;font-weight:400!important;transition:color 0.15s ease}.dark #table-of-contents-content a{color:#94a3b8!important}#table-of-contents-content>li>a{color:var(--page-text)!important;font-weight:500!important}.dark #table-of-contents-content>li>a{color:#e2e8f0!important}#table-of-contents-content>li>ul{padding-left:12px!important}#table-of-contents-content a:hover{color:var(--brand-dark)!important}.dark #table-of-contents-content a:hover{color:#e2e8f0!important}#table-of-contents-content a.text-primary,#table-of-contents-content a.font-semibold,#table-of-contents-content>li.is-active-item>a{color:var(--brand-primary)!important;font-weight:600!important}.dark #table-of-contents-content a.text-primary,.dark #table-of-contents-content a.font-semibold,.dark #table-of-contents-content a[class*=\"dark:text-primary\"],.dark #table-of-contents-content>li.is-active-item>a{color:var(--brand-light)!important;font-weight:600!important}#table-of-contents-content>li.is-active-item{border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li.is-active-item{border-left-color:var(--brand-light)!important}#table-of-contents-content>li:has(>a.border-primary),#table-of-contents-content>li:has(>a.text-primary){border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li:has(>a.border-primary),.dark #table-of-contents-content>li:has(>a.text-primary),.dark #table-of-contents-content>li:has(>a[class*=\"dark:text-primary\"]),.dark #table-of-contents-content>li:has(>a[class*=\"dark:border-primary\"]){border-left-color:var(--brand-light)!important}.landing-hero{text-align:center;padding:72px 32px 24px;max-width:860px;margin:0 auto}.landing-hero h1{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:52px;font-weight:700;letter-spacing:-0.03em;margin:0 0 20px;background:linear-gradient(135deg, var(--brand-dark), var(--brand-primary), var(--brand-light));-webkit-background-clip:text;-webkit-text-fill-color:transparent;background-clip:text}.dark .landing-hero h1{background:linear-gradient(135deg, var(--brand-light), #a78bfa, #c4b5fd);-webkit-background-clip:text;background-clip:text}.landing-hero p{font-size:19px;line-height:1.7;color:var(--page-muted);margin:0}.dark .landing-hero p{color:#94a3b8}.landing-section{max-width:1280px;margin:0 auto;padding:0 40px 56px}.landing-section h2{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:26px;font-weight:600;letter-spacing:-0.015em;margin:0 0 6px;color:var(--page-text)}.dark .landing-section h2{color:#e2e8f0}.landing-section>p{color:var(--page-muted);font-size:16px;margin:0 0 24px}.dark .landing-section>p{color:#94a3b8}.landing-cta{max-width:1280px;margin:0 auto;padding:0 40px 48px}.landing-divider{max-width:1280px;margin:0 auto 48px;padding:0 40px}.landing-divider hr{border:0;height:1px;background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.3), transparent);margin:0}.dark .landing-divider hr{background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.15), transparent)}.landing-section [role=\"tablist\"]{margin-bottom:12px}.landing-section [role=\"tabpanel\"]>p:first-child{color:var(--page-muted);font-size:15px;margin-bottom:20px}.dark .landing-section [role=\"tabpanel\"]>p:first-child{color:#94a3b8}.group:has(>.mermaid){background:linear-gradient(135deg, #faf8ff 0%, #f3f0ff 100%);border:1px solid rgba(95, 34, 208, 0.08);border-radius:12px;padding:28px 24px;margin:24px 0}.dark .group:has(>.mermaid){background:linear-gradient(135deg, rgba(95, 34, 208, 0.06) 0%, rgba(95, 34, 208, 0.03) 100%);border-color:rgba(124, 58, 237, 0.12)}.mermaid svg .node rect,.mermaid svg .node circle,.mermaid svg .node ellipse,.mermaid svg .node polygon,.mermaid svg .node path{fill:#ede9fe!important;stroke:#7c3aed!important;stroke-width:1.5px!important;rx:8px}.dark .mermaid svg .node rect,.dark .mermaid svg .node circle,.dark .mermaid svg .node ellipse,.dark .mermaid svg .node polygon,.dark .mermaid svg .node path{fill:rgba(124, 58, 237, 0.15)!important;stroke:#a78bfa!important}.mermaid svg .node.rhombus rect,.mermaid svg .node polygon[points]{fill:#ddd6fe!important;stroke:#6d28d9!important}.dark .mermaid svg .node.rhombus rect,.dark .mermaid svg .node polygon[points]{fill:rgba(109, 40, 217, 0.2)!important;stroke:#a78bfa!important}.mermaid svg .cluster rect{fill:rgba(237, 233, 254, 0.4)!important;stroke:rgba(124, 58, 237, 0.25)!important;stroke-width:1.5px!important;rx:10px!important}.dark .mermaid svg .cluster rect{fill:rgba(124, 58, 237, 0.08)!important;stroke:rgba(167, 139, 250, 0.2)!important}.mermaid svg .cluster-label .nodeLabel,.mermaid svg .cluster span{fill:var(--brand-dark)!important;color:var(--brand-dark)!important;font-weight:600!important}.dark .mermaid svg .cluster-label .nodeLabel,.dark .mermaid svg .cluster span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg .edgePath path.path{stroke:#8b5cf6!important;stroke-width:1.5px!important}.dark .mermaid svg .edgePath path.path{stroke:#a78bfa!important}.mermaid svg .marker{fill:#8b5cf6!important;stroke:#8b5cf6!important}.dark .mermaid svg .marker{fill:#a78bfa!important;stroke:#a78bfa!important}.mermaid svg .label,.mermaid svg .nodeLabel,.mermaid svg .label text,.mermaid svg span{fill:#1e1b4b!important;color:#1e1b4b!important;font-family:\"DM Sans\", sans-serif!important}.dark .mermaid svg .label,.dark .mermaid svg .nodeLabel,.dark .mermaid svg .label text,.dark .mermaid svg span{fill:#e2e8f0!important;color:#e2e8f0!important}.mermaid svg .edgeLabel{background-color:#faf8ff!important}.dark .mermaid svg .edgeLabel{background-color:transparent!important}.mermaid svg .edgeLabel span{fill:#6d28d9!important;color:#6d28d9!important;font-size:13px!important}.dark .mermaid svg .edgeLabel span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg{background:transparent!important}#localization-select-trigger>div:first-child{display:none!important}[data-relocated-lang]{gap:0!important}::selection{background:var(--brand-subtle);color:var(--brand-dark)}.dark ::selection{background:var(--brand-dark);color:#ffffff}*:focus-visible{outline-color:var(--brand-primary)!important}::-webkit-scrollbar-thumb{background:var(--brand-light);border-radius:4px}::-webkit-scrollbar-thumb:hover{background:var(--brand-primary)}.cloo-badge{display:inline-block;font-family:\"DM Sans\", sans-serif;font-size:12px;font-weight:600;line-height:1.5;padding:0 8px;border-radius:6px;letter-spacing:-0.01em;vertical-align:middle;white-space:nowrap;margin-right:2px}.cloo-badge--required{background:#fef2f2;color:#b91c1c}.cloo-badge--multiworker{background:#fff7ed;color:#c2410c}.cloo-badge--recommended{background:#eff6ff;color:#1d4ed8}.cloo-badge--optional{background:#f1f5f9;color:#475569}.dark .cloo-badge--required{background:rgba(185, 28, 28, 0.2);color:#fca5a5}.dark .cloo-badge--multiworker{background:rgba(194, 65, 12, 0.2);color:#fdba74}.dark .cloo-badge--recommended{background:rgba(29, 78, 216, 0.22);color:#93c5fd}.dark .cloo-badge--optional{background:rgba(71, 85, 105, 0.28);color:#cbd5e1}"}]}
{"page":{"pagePath":"en/workspace/flows","slug":"/en/workspace/flows","pageMetadata":{"title":"Agent Flow","description":"A flow builder for visually composing and running multi-agent workflows","href":"/en/workspace/flows"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"A flow builder for visually composing and running multi-agent workflows\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,blockquote:`blockquote`,code:`code`,em:`em`,hr:`hr`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,Card,CodeBlock,Columns,Frame,Heading,Info,Mermaid,Note,OptimizedImage,Step,Steps,Tab,Table,Tabs,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Agent Flow lets you build complex AI pipelines by visually connecting agents, models, and knowledge bases.\nIt is a `,_jsx(_components.strong,{children:`visual workflow builder`}),` similar to n8n or Dify — you can compose multi-agent orchestration entirely by drag and drop.`]}),`\n`,_jsx(Mermaid,{chart:`flowchart LR\n A[Start] --> B{Condition}\n B -->|True| C[Agent 1]\n B -->|False| D[Agent 2]\n C --> E[Transform]\n D --> E\n E --> F[Guardrail]\n F -->|Pass| G[Output]`}),`\n`,_jsxs(Warning,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`Three conditions must all be met for the Flows tab to appear in your workspace.`})}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`The environment must be licensed for `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`agent_flow`})})]}),`\n`,_jsxs(_components.li,{children:[`Your account must have `,_jsx(_components.strong,{children:`Flow permission`}),` (`,_jsx(_components.code,{children:`workspace.agent_flows`}),`) — admins always qualify`]}),`\n`,_jsxs(_components.li,{children:[`The address you connect to must be a `,_jsx(_components.strong,{children:`preview host`}),` — Flows is still a preview feature, so the menu appears only on designated development and demo hosts`]}),`\n`]}),_jsxs(_components.p,{children:[`Because of the third condition, `,_jsx(_components.strong,{children:`the menu will not appear on a regular production address`}),` even with the license and the permission in place. Contact your administrator if you need access.`]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`flow-vs-single-agent`,children:`Flow vs. Single Agent`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Aspect`}),_jsx(_components.th,{children:`Single Agent`}),_jsx(_components.th,{children:`Agent Flow`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Complexity`})}),_jsx(_components.td,{children:`Simple Q\u0026A`}),_jsx(_components.td,{children:`Multi-step pipeline`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Agent chaining`})}),_jsx(_components.td,{children:`Runs standalone`}),_jsx(_components.td,{children:`Passes data between agents`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Conditional branching`})}),_jsx(_components.td,{children:`Not available`}),_jsx(_components.td,{children:`Branch with Condition / Router nodes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Data transformation`})}),_jsx(_components.td,{children:`Not available`}),_jsx(_components.td,{children:`Jinja2 template in the Transform node`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Safety checks`})}),_jsx(_components.td,{children:`Per agent`}),_jsx(_components.td,{children:`Guardrail node inside the flow`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Human approval`})}),_jsx(_components.td,{children:`Not available`}),_jsx(_components.td,{children:`Mid-flow approval with the Approval Gate node`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Batch processing`})}),_jsx(_components.td,{children:`Not available`}),_jsx(_components.td,{children:`Per-item parallel processing with the Iteration node`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Reuse`})}),_jsx(_components.td,{children:`Individual calls`}),_jsx(_components.td,{children:`Nest pipelines with Subflow`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`External invocation`})}),_jsx(_components.td,{children:`Chat`}),_jsx(_components.td,{children:`Chat + webhook endpoint`})]})]})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`A single agent is enough for simple Q\u0026A or RAG retrieval.\nUse a flow when you need to chain several agents sequentially or conditionally.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`flow-list`,children:`Flow List`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Workspace > Flows`}),` shows every flow that has been created.`]}),`\n`,_jsx(Frame,{caption:`Flow list`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-list.png?fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=caefc2bf0441c57feab806be105200b1`,alt:`Flow list`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/en/workspace/flows-list.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-list.png?w=280\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=0b3500063a11073c3627053621aaa630 280w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-list.png?w=560\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=4f754cfd4913e8ea1af8e50c62ac2b59 560w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-list.png?w=840\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=4a4ae207ea7e042b51afe8b2b4138814 840w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-list.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=675d18503cc7635ca34617c746cd5808 1100w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-list.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=d16934d6dcb4e22420fca9673fc6fc5d 1650w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-list.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=25626195ffc897dc58a1597c68ecc623 2500w`})}),`\n`,_jsx(_components.p,{children:`Each flow card shows:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Element`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Active / Inactive badge`})}),_jsx(_components.td,{children:`Whether the flow is active`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Node count`})}),_jsx(_components.td,{children:`Number of nodes in the flow`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Name`})}),_jsx(_components.td,{children:`Flow identifier name`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Description`})}),_jsx(_components.td,{children:`What the flow is for`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Author`})}),_jsx(_components.td,{children:`Shown as “By {author name}“`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Updated`})}),_jsx(_components.td,{children:`Time of the last change (relative)`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.strong,{children:`All / My Flows`}),` at the top to narrow the list, or `,_jsx(_components.strong,{children:`Search Flows`}),` to filter by name.\nThe `,_jsx(_components.strong,{children:`⋯`}),` menu at the top-right of each card offers `,_jsx(_components.strong,{children:`Duplicate`}),`, `,_jsx(_components.strong,{children:`Delete`}),`, and the `,_jsx(_components.strong,{children:`Active / Inactive`}),` toggle.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`An inactive flow is blocked both in the chat model list and for webhook calls.`}),` For a flow you want to pause rather than lose, switch it to inactive instead of deleting it — the configuration is preserved.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`creating-a-flow`,children:`Creating a Flow`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Create a new flow`,children:[_jsxs(_components.p,{children:[`In `,_jsx(_components.strong,{children:`Workspace > Flows`}),`, click `,_jsx(_components.strong,{children:`+ New Flow`}),` at the top right.`]}),_jsx(Frame,{caption:`After entering the create screen`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-create-top.png?fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=9d7d7e950928a13f1c3eac41db5d656f`,alt:`Create flow`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/en/workspace/flows-create-top.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-create-top.png?w=280\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=f3fb2178f6b57ad30f8a9458c95debe6 280w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-create-top.png?w=560\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=2cc892fb7bf835c0f211b7e88945e86a 560w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-create-top.png?w=840\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=22bc7c4f12965e677db01b8c7d479a48 840w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-create-top.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=3788a13480ed9299de8fc8af8bf1d97b 1100w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-create-top.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=b48015fe47e2c25cb6da3dca444ed16b 1650w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-create-top.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=b9e24d44b3055bb873f8c056317171e3 2500w`})}),_jsx(_components.p,{children:`Fill in the basics in the left panel.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Example`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Enter flow name`})}),_jsx(_components.td,{children:`Display name of the flow`}),_jsx(_components.td,{children:`”Document Analysis Flow”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Flow ID`})}),_jsx(_components.td,{children:`2–50 character identifier starting with a lowercase letter or digit`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`doc-analysis`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Enter description`})}),_jsx(_components.td,{children:`What the flow is for`}),_jsx(_components.td,{children:`”Summarizes documents and extracts key points”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Stateful`})}),_jsx(_components.td,{children:`Keep conversation state across runs (on by default)`}),_jsx(_components.td,{children:`On`})]})]})]}),_jsxs(_components.p,{children:[`Flow ID availability is `,_jsx(_components.strong,{children:`checked as you type`}),` — a green check when it is free, a red X with “This Flow ID is already in use” when it is taken.`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`The Flow ID cannot be changed after creation. The on-screen hint mentions lowercase letters, numbers, and hyphens, but underscores (`,_jsx(_components.code,{children:`_`}),`) are accepted as well (`,_jsx(_components.code,{children:`^[a-z0-9][a-z0-9_-]*$`}),`).`]})})]}),_jsxs(Step,{title:`Start from a template, or from an empty canvas`,children:[_jsxs(_components.p,{children:[`The empty canvas of a new flow opens with the `,_jsx(_components.strong,{children:`Start from a template`}),` gallery. Picking a card starts you off with nodes and edges already laid out.`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Template`}),_jsx(_components.th,{children:`What it does`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Simple LLM Response`})}),_jsx(_components.td,{children:`Answers the user input with a single model call`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Guarded Agent Answer`})}),_jsx(_components.td,{children:`Screens the input with a guardrail, then lets an agent answer when it passes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Intent Routing`})}),_jsx(_components.td,{children:`Routes to differently prompted models depending on question / request / other`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Parallel Model Compare`})}),_jsx(_components.td,{children:`Sends the same input to two models in parallel and merges both answers`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Knowledge Base Q\u0026A`})}),_jsx(_components.td,{children:`Retrieves documents from a knowledge base and answers using that context`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Summarize Pipeline`})}),_jsx(_components.td,{children:`Summarizes with a model, then formats the result with a transform template`})]})]})]}),_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Build from scratch`}),` (✕) at the top right of the gallery to dismiss it and build on an empty canvas.`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`Templates lay out `,_jsx(_components.strong,{children:`the skeleton only.`}),` Resources such as models, agents, and knowledge bases must be selected on each node before the flow will run.`]})}),_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Picking a template turns the Stateful toggle off`}),`, because the template replaces the whole flow configuration. If the flow should keep conversation context, switch `,_jsx(_components.strong,{children:`Stateful`}),` back on after choosing a template.`]})})]}),_jsxs(Step,{title:`Place nodes`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Drag`}),` a node from the `,_jsx(_components.strong,{children:`Node`}),` panel on the left onto the canvas, or `,_jsx(_components.strong,{children:`click`}),` it to drop it at the center of the canvas.\nAs the palette grows, filter it with the `,_jsx(_components.strong,{children:`Search nodes`}),` box at the top.`]}),_jsx(Frame,{caption:`Dragged nodes land where you drop them; clicked nodes land at the center of the canvas`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-canvas-detail.png?fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=0d092a6e31705a02bc870a1021584bb7`,alt:`Flow canvas`,\"data-og-width\":`2936`,width:`2936`,\"data-og-height\":`1660`,height:`1660`,\"data-path\":`images/en/workspace/flows-canvas-detail.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-canvas-detail.png?w=280\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=50bf09a4c5b38dd836cd0d81375d7694 280w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-canvas-detail.png?w=560\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=d53c4497beca044466ec30b08989eba5 560w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-canvas-detail.png?w=840\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=b4df9e63652d2e94450b5fad8641744b 840w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-canvas-detail.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=0f4f555b6bb8d458f402bb8283c222f6 1100w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-canvas-detail.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=e0c0c7405a42d30b61259736699d6529 1650w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-canvas-detail.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=6f80199937c990be226a835ba408d0e1 2500w`})})]}),_jsxs(Step,{title:`Connect nodes`,children:[_jsxs(_components.p,{children:[`Drag from a node’s `,_jsx(_components.strong,{children:`output handle (dot on the right)`}),` to the next node’s `,_jsx(_components.strong,{children:`input handle (dot on the left)`}),`.\nData flows `,_jsx(_components.strong,{children:`left to right`}),`.`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`Handle positions: `,_jsx(_components.strong,{children:`left`}),` = input, `,_jsx(_components.strong,{children:`right`}),` = output.\nBranching nodes — Condition, Router, Guardrail, Approval Gate — stack `,_jsx(_components.strong,{children:`multiple output handles vertically on the right`}),`.\nThe Start node has no input handle, and the Output node has no output handle.`]})})]}),_jsxs(Step,{title:`Configure nodes`,children:[_jsxs(_components.p,{children:[`Clicking a node opens its `,_jsx(_components.strong,{children:`settings panel`}),` on the right.\nFor an Agent node pick the agent to run; for a Model node pick the LLM and set the system / user prompts.\nDrag the panel’s left edge to resize it.`]}),_jsxs(Columns,{cols:2,children:[_jsx(Frame,{caption:`Agent node settings`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-detail.png?fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=fb490c6b4db8783c6790f01787d3d9df`,alt:`Node settings panel 1`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/en/workspace/flows-detail.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-detail.png?w=280\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=e7eabb46ed4ca22e1d05a7033f6c5181 280w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-detail.png?w=560\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=dbdcfb10ad5c0233dc598cd14c1720a7 560w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-detail.png?w=840\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=58563ab2a947eea7eb03126734234f18 840w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-detail.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=ce04bf0a4e2a53f0d57245bf388214f5 1100w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-detail.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=03cf400da56805f85b859ee2b87d79e1 1650w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-detail.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=ca3412765d3539f270577117c4e69b9c 2500w`})}),_jsx(Frame,{caption:`Model node settings`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-detail-2.png?fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=77a72a61797663ba83b2f97325877fa3`,alt:`Node settings panel 2`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/en/workspace/flows-detail-2.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-detail-2.png?w=280\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=a78caa80d7df21611f00f2f028002300 280w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-detail-2.png?w=560\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=8a46af1177f6c2c1c56a6eb4dbb74b7d 560w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-detail-2.png?w=840\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=e40f203bdb76b64957971395d1c653e7 840w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-detail-2.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=7226e3ccc7362defac6908754c9d95ff 1100w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-detail-2.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=3e9faac13e916df4bcd9db37fcfa1b6a 1650w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/en/workspace/flows-detail-2.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=6502bb268f815c9a8e9c6f98065ccbf8 2500w`})})]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[`See the `,_jsx(_components.a,{href:`/en/workspace/flows-nodes`,children:`Node Reference`}),` for the settings of each node.`]})})]}),_jsxs(Step,{title:`Validate, then save`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Validate`}),` and `,_jsx(_components.strong,{children:`Save \u0026 Create`}),` in the top toolbar are separate actions.`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Validate`}),` — checks for problems and marks failing nodes on the canvas with a red ring`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Save \u0026 Create`}),` — creates the flow and moves to the edit screen. `,_jsx(_components.strong,{children:`Saving does not run validation automatically`})]}),`\n`]}),_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`dot`}),` before the flow name in the toolbar shows validation status.`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Dot color`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Gray`}),_jsx(_components.td,{children:`Not validated since last edit`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Green`}),_jsx(_components.td,{children:`Flow is valid`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Amber`}),_jsx(_components.td,{children:`Validation errors`})]})]})]}),_jsx(Note,{children:_jsx(_components.p,{children:`Editing the canvas turns the dot gray again — this keeps a stale green result from implying the current graph is still valid.`})})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`save-draft-and-publish`,children:`Save Draft and Publish`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Once a flow exists, saving happens in two stages.`}),` Saving on the edit screen only updates the draft; `,_jsx(_components.strong,{children:`publishing is what changes the version that actually runs.`})]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Button`}),_jsx(_components.th,{children:`What it does`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Save Draft`})}),_jsxs(_components.td,{children:[`Saves the current canvas as a draft. `,_jsx(_components.strong,{children:`The live flow is untouched`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Publish`})}),_jsx(_components.td,{children:`Promotes the draft to live. The previous live version is kept as a version snapshot`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`When an unpublished draft exists, the `,_jsx(_components.strong,{children:`Publish`}),` button carries an amber `,_jsx(_components.strong,{children:`Unpublished draft`}),` dot and a banner appears above the canvas.`]}),`\n`,_jsxs(_components.blockquote,{children:[`\n`,_jsx(_components.p,{children:`Editing draft — the live flow is unchanged until you publish`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Discard draft`}),` on the right of the banner asks “Discard this draft and return to the live version?” and then restores the canvas to the live version.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`If you only save a draft and leave, nothing changes for your users.`}),` Chat and webhook calls keep running the previously published version. Press `,_jsx(_components.strong,{children:`Publish`}),` to actually roll the change out.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`This does not apply while creating a flow.`}),` The create screen has a single `,_jsx(_components.strong,{children:`Save \u0026 Create`}),` button; the split into Save Draft / Publish begins on the edit screen.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`reverting-to-a-previous-version`,children:`Reverting to a previous version`}),`\n`,_jsxs(_components.p,{children:[`Each publish pushes the previous live version onto a snapshot stack (`,_jsx(_components.strong,{children:`up to 20`}),`, oldest dropped beyond that).`]}),`\n`,_jsxs(_components.p,{children:[`Open the `,_jsx(_components.strong,{children:`Versions`}),` tab in the test drawer to review the publish history and press `,_jsx(_components.strong,{children:`Restore`}),` — the snapshot comes back `,_jsx(_components.strong,{children:`as a draft`}),`. Review it on the canvas and press `,_jsx(_components.strong,{children:`Publish`}),` to make the rollback final.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`node-types`,children:`Node Types`}),`\n`,_jsxs(_components.p,{children:[`Agent Flow provides `,_jsx(_components.strong,{children:`13 nodes`}),` across 4 categories.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Category`}),_jsx(_components.th,{children:`Nodes`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`General`})}),_jsx(_components.td,{children:`Start, Output`}),_jsx(_components.td,{children:`Flow entry / exit`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Agents`})}),_jsx(_components.td,{children:`Agent, Model, Supervisor`}),_jsx(_components.td,{children:`Run an agent, call an LLM directly, coordinate worker agents`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Logic \u0026 Data`})}),_jsx(_components.td,{children:`Condition, Router, Merge, Transform, Iteration, Subflow`}),_jsx(_components.td,{children:`Branching, routing, combining, transforming, batch processing, flow nesting`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Control \u0026 Safety`})}),_jsx(_components.td,{children:`Approval Gate, Guardrail`}),_jsx(_components.td,{children:`Wait for human approval, safety filter`})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`See the `,_jsx(_components.a,{href:`/en/workspace/flows-nodes`,children:`Node Reference`}),` for the settings of each node.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`validation`,children:`Validation`}),`\n`,_jsxs(_components.p,{children:[`Use the `,_jsx(_components.strong,{children:`Validate`}),` button in the top toolbar. Failing nodes are marked on the canvas with a `,_jsx(_components.strong,{children:`red ring`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`errors-—-must-be-fixed-to-run`,children:`Errors — must be fixed to run`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Check`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Missing resource`})}),_jsx(_components.td,{children:`An Agent / Model / Guardrail / Knowledge / Glossary node with no resource selected`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Incomplete supervisor`})}),_jsx(_components.td,{children:`No supervisor model selected, or zero workers`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Incomplete subflow`})}),_jsxs(_components.td,{children:[`No flow selected, or the node `,_jsx(_components.strong,{children:`references itself`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Iteration model missing`})}),_jsx(_components.td,{children:`LLM mode with no model selected`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Dangling edge`})}),_jsx(_components.td,{children:`An edge pointing at a deleted node`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Unsupported node type`})}),_jsx(_components.td,{children:`A type the builder does not handle (imported legacy flows, etc.)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Loop without exit`})}),_jsx(_components.td,{children:`A cycle with no conditional branch leaving it`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`warnings-—-the-flow-still-runs`,children:`Warnings — the flow still runs`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Check`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`No Input node`})}),_jsx(_components.td,{children:`The first node in the flow is used as the entry point`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`No Output node`})}),_jsx(_components.td,{children:`Leaf nodes automatically connect to the flow end`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Orphan node`})}),_jsx(_components.td,{children:`A node connected to nothing (a single-node flow is fine)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Loop detected`})}),_jsx(_components.td,{children:`The graph contains a cycle`})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Missing Start / Output nodes are not errors.`}),` Implicit entry and exit are supported, so they are reported as warnings only. Adding both is still clearer about intent.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`loops-are-a-supported-feature`,children:`Loops are a supported feature`}),`\n`,_jsxs(_components.p,{children:[`If a Condition, Router, or Guardrail branch inside the cycle leaves it, the loop is considered safe and only a `,_jsx(_components.strong,{children:`warning`}),` is reported. It is an `,_jsx(_components.strong,{children:`error`}),` only when no branch leaves the cycle at all.`]}),`\n`,_jsxs(_components.p,{children:[`Execution is bounded by a superstep limit (50 by default), and loop exits are built by combining `,_jsx(_components.code,{children:`{Label.loop_count}`}),` with a `,_jsx(_components.strong,{children:`Greater than`}),` condition in a Condition node.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`running-a-flow`,children:`Running a Flow`}),`\n`,_jsx(_components.p,{children:`There are three ways to run a flow.`}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`Test in the editor`,id:`test-in-the-editor`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Test Run`}),` in the toolbar opens a test drawer below the canvas. It runs `,_jsx(_components.strong,{children:`the current canvas as-is, unsaved`}),`, so you can check behavior before publishing.`]}),_jsx(_components.p,{children:`The drawer has three tabs.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tab`}),_jsx(_components.th,{children:`Contents`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Test Run`})}),_jsxs(_components.td,{children:[`Enter test input and press `,_jsx(_components.strong,{children:`Run`}),`. Shows per-node progress and the final output`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Run History`})}),_jsx(_components.td,{children:`Execution history for this flow (owners and admins see all runs; shared users see only their own)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Versions`})}),_jsxs(_components.td,{children:[`Publish history and `,_jsx(_components.strong,{children:`Restore`})]})]})]})]}),_jsxs(_components.p,{children:[`While running, each node’s status (running / completed / error) appears `,_jsx(_components.strong,{children:`on the canvas and in the step list at the same time`}),`, and clicking a step expands a preview of that node’s output. With a KBSphere agent the number of retrieved `,_jsx(_components.strong,{children:`sources`}),` is shown as well.`]}),_jsx(_components.p,{children:`Drag the top edge of the drawer to resize it.`}),_jsx(Note,{children:_jsxs(_components.p,{children:[`If the flow contains an `,_jsx(_components.strong,{children:`Approval Gate`}),`, execution stops there and an `,_jsx(_components.strong,{children:`Approval required`}),` card appears. Add a note and press `,_jsx(_components.strong,{children:`Approve`}),` or `,_jsx(_components.strong,{children:`Reject`}),` to resume from that point.`]})})]}),_jsxs(Tab,{title:`Run from Chat`,id:`run-from-chat`,children:[_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Start a new chat`}),`\n`,_jsxs(_components.li,{children:[`In the model selector, a `,_jsx(_components.strong,{children:`Flow`}),` connection type filter appears. Select it`]}),`\n`,_jsx(_components.li,{children:`Pick the flow, then type your message`}),`\n`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`Flows appear in the model selector as a `,_jsx(_components.strong,{children:`connection type filter`}),`, not as a separate tab. The filter only shows up when at least one flow is available to you.`]})}),_jsxs(_components.p,{children:[`Chat runs carry state per conversation, so context is preserved within a chat `,_jsx(_components.strong,{children:`regardless of the Stateful toggle`}),`.`]})]}),_jsxs(Tab,{title:`Call by webhook`,id:`call-by-webhook`,children:[_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`Webhook`}),` endpoint is shown near the bottom of the left panel on the edit screen. `,_jsx(_components.strong,{children:`Copy URL`}),` copies the full address.`]}),_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`POST /api/v1/agent-flows/{flow ID}/invoke`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Request field`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`input`})}),_jsx(_components.td,{children:`Input passed to the flow (required)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`stream`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`true`}),` for an SSE stream; defaults to `,_jsx(_components.code,{children:`false`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`session_id`})}),_jsx(_components.td,{children:`Conversation session key. Supplying it keeps state per session`})]})]})]}),_jsxs(_components.p,{children:[`The default response is JSON containing `,_jsx(_components.code,{children:`flow_id`}),`, `,_jsx(_components.code,{children:`session_id`}),`, and `,_jsx(_components.code,{children:`output`}),`.`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`The endpoint also accepts an API key (`,_jsx(_components.code,{children:`Bearer sk-...`}),`), which makes it usable from external systems. The caller needs `,_jsx(_components.strong,{children:`read access`}),` to the flow, and `,_jsx(_components.strong,{children:`calls to an inactive flow are rejected.`})]})})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`stateful`,children:`Stateful`}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`Stateful`}),` toggle in the left panel of the edit screen controls whether `,_jsx(_components.strong,{children:`conversation state is kept across runs`}),` (on by default for new flows).`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Chat runs`}),` — state is kept per conversation automatically, regardless of the toggle`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Non-chat runs (webhook, embed, scheduled tasks)`}),` — the toggle must be on `,_jsx(_components.em,{children:`and`}),` a `,_jsx(_components.code,{children:`session_id`}),` supplied for state to carry across calls`]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`building-a-flow-with-ai`,children:`Building a Flow with AI`}),`\n`,_jsxs(_components.p,{children:[`The violet `,_jsx(_components.strong,{children:`AI Assistant`}),` button at the bottom right of the editor opens a conversational builder. Describe the flow you want in plain language and the AI generates the nodes and edges directly onto the canvas.`]}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Pick a model`,children:_jsxs(_components.p,{children:[`Choose the `,_jsx(_components.strong,{children:`model`}),` the builder should use in the selector in the panel header.`]})}),_jsx(Step,{title:`Describe your intent`,children:_jsx(_components.p,{children:`Describe the flow you want, e.g. “Build a flow that classifies customer inquiries by department.”\nSuggestion chips are shown when the panel first opens — click one to start immediately.`})}),_jsxs(Step,{title:`Answer the AI's questions`,children:[_jsxs(_components.p,{children:[`The AI asks follow-ups — whether to use a guardrail, which routing style, and so on — `,_jsx(_components.strong,{children:`as buttons`}),`. Click the option you want.`]}),_jsx(_components.p,{children:`Examples:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`“Should we use a guardrail?” → `,_jsx(_components.strong,{children:`[PII protection]`}),` `,_jsx(_components.strong,{children:`[Banned words]`}),` `,_jsx(_components.strong,{children:`[None]`})]}),`\n`,_jsxs(_components.li,{children:[`“Which routing style?” → `,_jsx(_components.strong,{children:`[Router]`}),` `,_jsx(_components.strong,{children:`[Condition]`}),` `,_jsx(_components.strong,{children:`[Direct connection]`})]}),`\n`]})]}),_jsxs(Step,{title:`Generate, then refine`,children:[_jsx(_components.p,{children:`Once it has enough information, the nodes and edges are placed on the canvas. Keep the conversation going to refine them.`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`“Change the router node to a condition”`}),`\n`,_jsx(_components.li,{children:`“Add agent C in the middle”`}),`\n`,_jsx(_components.li,{children:`“Remove the guardrail node”`}),`\n`]})]})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Being specific up front skips the follow-up questions. For example: “Build a flow with a PII guardrail → sentiment routing → separate agents for positive and negative.”`})}),`\n`,_jsx(Heading,{level:`3`,id:`ai-builder-features`,children:`AI builder features`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Conversation history`}),` — the transcript is stored with the flow, so you can pick up where you left off`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Editing existing flows`}),` — opened on an existing flow, it reads the current structure and proposes changes`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Live canvas updates`}),` — generated nodes appear on the canvas immediately`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Resizable panel`}),` — drag the handle at the top of the panel`]}),`\n`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`The AI Assistant button is shown only to users with `,_jsx(_components.strong,{children:`write access`}),` to the flow.`]})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Anything the AI generates can still be edited by hand. Sketching the skeleton with AI and tuning each node yourself works well. Results stay `,_jsx(_components.strong,{children:`a draft until you publish`}),`, so there is little risk in experimenting.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`export-/-import`,children:`Export / Import`}),`\n`,_jsxs(_components.p,{children:[`Export and import are performed from the `,_jsx(_components.strong,{children:`flow editor’s top toolbar`}),`.`]}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`Export`,id:`export`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Export`}),` in the toolbar to download a JSON file.\nThe file contains the flow name, description, node configuration, and connections.`]})}),_jsxs(Tab,{title:`Import`,id:`import`,children:[_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Import`}),` in the toolbar and upload a previously exported JSON file.\nOnly JSON of the form `,_jsx(_components.code,{children:`type: \"agent_flow\"`}),` is accepted.`]}),_jsxs(Note,{children:[`Agents, models, and guardrails referenced by the imported flow must exist in the current environment. Press `,_jsx(_components.strong,{children:`Validate`}),` first to surface any missing-resource errors.`]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`use-cases`,children:`Use Cases`}),`\n`,_jsxs(Accordion,{title:`Example 1: Document analysis flow`,id:`example-1-document-analysis-flow`,children:[_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`[Start] → [Agent: Summarize] → [Agent: Extract key points] → [Output]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(_components.p,{children:`A summarization agent processes the user input, then an extraction agent pulls the main points out of the summary.`})]}),`\n`,_jsxs(Accordion,{title:`Example 2: Conditional customer support`,id:`example-2-conditional-customer-support`,children:[_jsx(CodeBlock,{numberOfLines:`8`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ┌─ True ──→ [Agent: Tech support] ─┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`[Start] → [Condition] ─────────────────────────────────→ [Output]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` └─ False → [Agent: General] ───────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`State Key: input`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Condition Type: Contains`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Value: \"error\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(_components.p,{children:`Inputs containing “error” go to the tech support agent; everything else goes to the general inquiry agent.`})]}),`\n`,_jsxs(Accordion,{title:`Example 3: Data report flow`,id:`example-3-data-report-flow`,children:[_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`[Start] → [Agent: DBSphere] → [Transform] → [Model: Write report] → [Output]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(_components.p,{children:`A DBSphere agent queries the data, the Transform node’s Jinja2 template shapes the result, and a Model node writes the final report.`})]}),`\n`,_jsxs(Accordion,{title:`Example 4: Guardrail flow`,id:`example-4-guardrail-flow`,children:[_jsx(CodeBlock,{numberOfLines:`4`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ┌─ Pass → [Agent: Q\u0026A] → [Output]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`[Start] → [Guardrail: PII check] ─┤`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` └─ Block → [Transform: Notice text] → [Output (Error)]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsxs(_components.p,{children:[`Inputs containing personal information are blocked, and only safe inputs reach the agent.\nSetting `,_jsx(_components.strong,{children:`Block Action`}),` to `,_jsx(_components.code,{children:`Continue`}),` lets you shape the block information in a Transform node and explain it to the user.`]})]}),`\n`,_jsxs(Accordion,{title:`Example 5: Send-with-approval flow`,id:`example-5-send-with-approval-flow`,children:[_jsx(CodeBlock,{numberOfLines:`4`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ┌─ Approve → [Agent: Send] → [Output]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`[Start] → [Model: Draft] → [Approval Gate] ─┤`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` └─ Reject → [Output (Error)]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsxs(_components.p,{children:[`A model-written draft only reaches the send step after a person reviews it.\nSet `,_jsx(_components.strong,{children:`On Reject`}),` to `,_jsx(_components.code,{children:`Take the reject branch`}),` to design a rejection path, or `,_jsx(_components.code,{children:`Stop the flow`}),` to end there.`]})]}),`\n`,_jsxs(Accordion,{title:`Example 6: Per-item parallel processing`,id:`example-6-per-item-parallel-processing`,children:[_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`[Start] → [Iteration: LLM mode] → [Merge] → [Output]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsxs(_components.p,{children:[`Given a newline-separated list or a JSON array as input, the Iteration node runs each item through the LLM in parallel and joins the results.\nControl the load with `,_jsx(_components.strong,{children:`Concurrency`}),` (1–8) and `,_jsx(_components.strong,{children:`Max Items`}),`.`]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`access-control`,children:`Access Control`}),`\n`,_jsx(_components.p,{children:`Flows use the same access control as other workspace resources.`}),`\n`,_jsxs(_components.p,{children:[`For flows, `,_jsx(_components.strong,{children:`both the create and the edit screen`}),` open the access control modal from the lock-icon `,_jsx(_components.strong,{children:`[Access]`}),` button in the top toolbar — unlike other resources, there is no inline permission area on the screen itself.`]}),`\n`,_jsxs(_components.p,{children:[`Pick the sharing scope with the `,_jsx(_components.strong,{children:`Access permission`}),` selector in the modal.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Option`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Everyone`})}),_jsx(_components.td,{children:`Readable by all users`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Selected groups only`})}),_jsxs(_components.td,{children:[`Available to members of the groups listed under `,_jsx(_components.strong,{children:`Accessible groups`})]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`A group in the table has read access by that fact alone; check the `,_jsx(_components.strong,{children:`Editable`}),` column to grant write access as well.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`A newly created flow is readable by everyone by default.`}),` Along with channels, this is one of the few exceptions in the workspace — to narrow it, open the flow after creating it and switch `,_jsx(_components.strong,{children:`Access permission`}),` to `,_jsx(_components.strong,{children:`Selected groups only`}),` yourself.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`Everyone`}),` option is shown `,_jsx(_components.strong,{children:`to admins only`}),`. Regular users see just `,_jsx(_components.strong,{children:`Selected groups only`}),`.`]})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[`You must press `,_jsx(_components.code,{children:`Apply`}),` in the access control modal.`]}),` Selecting groups and closing the modal does not save the change. After applying, you still need to press `,_jsx(_components.strong,{children:`Save \u0026 Create`}),` (create) or `,_jsx(_components.strong,{children:`Save Draft · Publish`}),` (edit) to persist it.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Organization units cannot be selected on this screen.`}),` To open access to an organization unit, an administrator must `,_jsx(_components.strong,{children:`link the organization unit to a group`}),` — users in that organization are then treated as members of the group. See `,_jsx(_components.a,{href:`/en/collaboration/sharing-permissions`,children:`Sharing \u0026 Permissions`}),` for details.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`faq`,children:`FAQ`}),`\n`,_jsxs(Accordion,{title:`I can't see the Flows menu`,id:`i-cant-see-the-flows-menu`,children:[_jsx(_components.p,{children:`The Flows tab requires all three of the following:`}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`An environment licensed for `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`agent_flow`})})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Flow permission`}),` on your account (`,_jsx(_components.code,{children:`workspace.agent_flows`}),`)`]}),`\n`,_jsxs(_components.li,{children:[`A connection address that is a `,_jsx(_components.strong,{children:`preview host`})]}),`\n`]}),_jsx(_components.p,{children:`Flows is still a preview feature, so even with the license and permission the menu will not appear on a regular production address. Ask your administrator to confirm.`})]}),`\n`,_jsxs(Accordion,{title:`I saved, but chat still behaves the old way`,id:`i-saved-but-chat-still-behaves-the-old-way`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Save Draft`}),` on the edit screen does not change the live flow. You must press `,_jsx(_components.strong,{children:`Publish`}),` for chat and webhook calls to pick it up.`]}),_jsxs(_components.p,{children:[`If the “Editing draft” banner is above the canvas, or the `,_jsx(_components.strong,{children:`Publish`}),` button has an amber dot, the change is still unpublished.`]})]}),`\n`,_jsx(Accordion,{title:`Which agents can I use in a flow?`,id:`which-agents-can-i-use-in-a-flow`,children:_jsx(_components.p,{children:`Every agent registered in the workspace.\nStandard mode, KBSphere (enhanced RAG), and DBSphere (database) modes are all supported.`})}),`\n`,_jsxs(Accordion,{title:`What happens when a flow hits an error?`,id:`what-happens-when-a-flow-hits-an-error`,children:[_jsx(_components.p,{children:`By default, execution stops at the failing node and an error message is shown.`}),_jsxs(_components.p,{children:[`To handle it differently per node, open the `,_jsx(_components.strong,{children:`Error handling \u0026 retry`}),` section at the bottom of the settings panel and set `,_jsx(_components.strong,{children:`On error`}),` (`,_jsx(_components.code,{children:`Stop the flow`}),` / `,_jsx(_components.code,{children:`Skip and continue`}),` / `,_jsx(_components.code,{children:`Use default value`}),`) along with `,_jsx(_components.strong,{children:`Max retries`}),`, `,_jsx(_components.strong,{children:`Retry interval`}),`, and `,_jsx(_components.strong,{children:`Timeout`}),`. Every node except Start has this section.`]}),_jsx(Note,{children:`There is no separate Error Handler node.`})]}),`\n`,_jsxs(Accordion,{title:`Can I run the same node repeatedly?`,id:`can-i-run-the-same-node-repeatedly`,children:[_jsx(_components.p,{children:`Two ways:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Iteration node`}),` — for processing many items at once in parallel (concurrency 1–8)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Loop edges`}),` — a cycle that returns to an earlier node based on a condition. Fully supported, provided one Condition / Router / Guardrail branch leaves the loop`]}),`\n`]}),_jsxs(_components.p,{children:[`Loop execution is bounded by a superstep limit (50 by default), and the exit is built by combining `,_jsx(_components.code,{children:`{Label.loop_count}`}),` with a `,_jsx(_components.strong,{children:`Greater than`}),` condition.`]})]}),`\n`,_jsxs(Accordion,{title:`Can one flow connect several agents?`,id:`can-one-flow-connect-several-agents`,children:[_jsx(_components.p,{children:`Yes — chain agents sequentially or branch with Condition / Router nodes.\nEach agent’s output is passed automatically as the next agent’s input.`}),_jsxs(_components.p,{children:[`To have one model split work across several agents and combine the results, use the `,_jsx(_components.strong,{children:`Supervisor`}),` node.`]})]}),`\n`,_jsxs(Accordion,{title:`In what order does a flow execute?`,id:`in-what-order-does-a-flow-execute`,children:[_jsx(_components.p,{children:`Execution starts at the Start node and follows the connected nodes in order.\nA Condition node branches to the true or false path based on its evaluation, and a Router node branches to the matching route.\nA Merge node is where parallel paths join.`}),_jsx(_components.p,{children:`Without a Start node the first node becomes the entry point; without an Output node the leaf nodes become the exit.`})]}),`\n`,_jsxs(Accordion,{title:`How do I roll back to an earlier version?`,id:`how-do-i-roll-back-to-an-earlier-version`,children:[_jsxs(_components.p,{children:[`Open the `,_jsx(_components.strong,{children:`Versions`}),` tab in the test drawer, review the publish history, and press `,_jsx(_components.strong,{children:`Restore`}),`.\nRestore brings that version back `,_jsx(_components.strong,{children:`as a draft`}),`, so review it on the canvas and press `,_jsx(_components.strong,{children:`Publish`}),` to make the rollback final.`]}),_jsx(_components.p,{children:`Up to 20 snapshots are retained.`})]}),`\n`,_jsx(Accordion,{title:`How do I move a flow to another environment?`,id:`how-do-i-move-a-flow-to-another-environment`,children:_jsxs(_components.p,{children:[`Use `,_jsx(_components.strong,{children:`Export`}),` in the editor toolbar to download a JSON file, then `,_jsx(_components.strong,{children:`Import`}),` it in the target environment’s editor.\nThe referenced agents, models, and guardrails must exist there too — press `,_jsx(_components.strong,{children:`Validate`}),` after importing to confirm.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next Steps`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`Node Reference`,icon:`diagram-project`,href:`/en/workspace/flows-nodes`,children:_jsx(_components.p,{children:`Settings and State keys for all 13 nodes`})}),_jsx(Card,{title:`Create an Agent`,icon:`robot`,href:`/en/workspace/agents`,children:_jsx(_components.p,{children:`Configure the agents your flow will use`})}),_jsx(Card,{title:`Configure Guardrails`,icon:`shield`,href:`/en/workspace/guardrails`,children:_jsx(_components.p,{children:`Set up filters for safe responses inside a flow`})}),_jsx(Card,{title:`Sharing \u0026 Permissions`,icon:`users`,href:`/en/collaboration/sharing-permissions`,children:_jsx(_components.p,{children:`How the access control modal works`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Agent Flow","description":"A flow builder for visually composing and running multi-agent workflows","href":"/en/workspace/flows"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Flow vs. Single Agent","slug":"flow-vs-single-agent","depth":2,"children":[]},{"title":"Flow List","slug":"flow-list","depth":2,"children":[]},{"title":"Creating a Flow","slug":"creating-a-flow","depth":2,"children":[]},{"title":"Save Draft and Publish","slug":"save-draft-and-publish","depth":2,"children":[{"title":"Reverting to a previous version","slug":"reverting-to-a-previous-version","depth":3,"children":[]}]},{"title":"Node Types","slug":"node-types","depth":2,"children":[]},{"title":"Validation","slug":"validation","depth":2,"children":[{"title":"Errors — must be fixed to run","slug":"errors-—-must-be-fixed-to-run","depth":3,"children":[]},{"title":"Warnings — the flow still runs","slug":"warnings-—-the-flow-still-runs","depth":3,"children":[]},{"title":"Loops are a supported feature","slug":"loops-are-a-supported-feature","depth":3,"children":[]}]},{"title":"Running a Flow","slug":"running-a-flow","depth":2,"children":[{"title":"Stateful","slug":"stateful","depth":3,"children":[]}]},{"title":"Building a Flow with AI","slug":"building-a-flow-with-ai","depth":2,"children":[{"title":"AI builder features","slug":"ai-builder-features","depth":3,"children":[]}]},{"title":"Export / Import","slug":"export-/-import","depth":2,"children":[]},{"title":"Use Cases","slug":"use-cases","depth":2,"children":[]},{"title":"Access Control","slug":"access-control","depth":2,"children":[]},{"title":"FAQ","slug":"faq","depth":2,"children":[]},{"title":"Next Steps","slug":"next-steps","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/cloocus/45db6ee3c57396cb/toc.js","/_mintlify/custom/cloocus/9670a2c81dc38d5e/tools/playwright-video-mcp/index.js","/_mintlify/custom/cloocus/4540e1c308555295/lang-toggle.js"],"subdomain":"cloocus","siteName":"Cloosphere Guide","title":"Agent Flow - Cloosphere Guide","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"ko":{"href":"/ko/workspace/flows","matchLevel":1},"en":{"href":"/en/workspace/flows","matchLevel":0}}},"lastModified":"2026-08-21T06:01:59.174Z","originalFileLocation":"en/workspace/flows.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"A flow builder for visually composing and running multi-agent workflows\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Agent Flow - Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:description\" content=\"A flow builder for visually composing and running multi-agent workflows\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cloosphere.ai/en/workspace/flows\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=AI+Agents\u0026amp;title=Agent+Flow\u0026amp;description=A+flow+builder+for+visually+composing+and+running+multi-agent+workflows\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=c07b6e513ee657de234f18264bb4daa6fa63dc51b5704e77d1eab0a243564b03\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Agent Flow - Cloosphere Guide\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"A flow builder for visually composing and running multi-agent workflows\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=AI+Agents\u0026amp;title=Agent+Flow\u0026amp;description=A+flow+builder+for+visually+composing+and+running+multi-agent+workflows\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=c07b6e513ee657de234f18264bb4daa6fa63dc51b5704e77d1eab0a243564b03\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5f22d0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cloosphere.ai/en/workspace/flows\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/workspace/flows.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.cloosphere.ai/en/workspace/flows\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.cloosphere.ai/ko/workspace/flows\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.cloosphere.ai/ko/workspace/flows\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cloosphere.ai/#organization\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cloosphere.ai#website\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cloosphere.ai/en/workspace/flows#webpage\",\"url\":\"https://docs.cloosphere.ai/en/workspace/flows\",\"name\":\"Agent Flow\",\"description\":\"A flow builder for visually composing and running multi-agent workflows\",\"dateModified\":\"2026-08-21T06:01:59.174Z\",\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cloosphere.ai/en/workspace/flows#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cloosphere.ai/en/workspace/flows#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"AI Agents\",\"item\":\"https://docs.cloosphere.ai/en/workspace/agents\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Agent Flow\",\"item\":\"https://docs.cloosphere.ai/en/workspace/flows\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cloosphere.ai/en/workspace/flows#article\",\"headline\":\"Agent Flow\",\"name\":\"Agent Flow\",\"description\":\"A flow builder for visually composing and running multi-agent workflows\",\"url\":\"https://docs.cloosphere.ai/en/workspace/flows\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cloosphere.ai/en/workspace/flows#webpage\"},\"dateModified\":\"2026-08-21T06:01:59.174Z\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cloosphere Guide\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Cloosphere Guide\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/en/workspace/flows.md","siteName":"Cloosphere Guide","nav":{"global":null,"languages":[{"language":"ko","default":true,"pages":[{"title":"ko","href":"/ko/workspace/flows"}]},{"language":"en","tabs":[{"tab":"Getting Started","icon":"rocket","pages":[{"title":"Getting Started","href":"/en"}]},{"tab":"Chat","icon":"comments","pages":[{"title":"Chat","href":"/en/chat/overview"}]},{"tab":"Workspace","icon":"briefcase","groups":[{"group":"Workspace","pages":[{"title":"Workspace","href":"/en/workspace/overview"}]},{"group":"AI Agents","pages":[{"title":"Agents","description":"Create and manage custom AI assistants combining Knowledge Bases, Tools, and Guardrails","href":"/en/workspace/agents"},{"title":"Agent Flow","href":"/en/workspace/flows"},{"title":"Flow Node Reference","description":"Reference for the 13 nodes available in the Agent Flow canvas — settings, behavior, and State key conventions","href":"/en/workspace/flows-nodes"}]},{"group":"Knowledge \u0026 Data","pages":[{"title":"Knowledge Base","href":"/en/workspace/knowledge"},{"title":"Dynamic Filters Deep-Dive","href":"/en/workspace/knowledge-filters"},{"title":"Knowledge Graph","href":"/en/workspace/knowledge-graph"},{"title":"Database","href":"/en/workspace/database"},{"title":"Glossary","href":"/en/workspace/glossary"}]},{"group":"Safety","pages":[{"title":"Guardrails","href":"/en/workspace/guardrails"}]},{"group":"Customization","pages":[{"title":"Prompts","href":"/en/workspace/prompts"},{"title":"Skills","href":"/en/workspace/skills"},{"title":"Tools","href":"/en/workspace/tools"},{"title":"Marketplace","href":"/en/workspace/marketplace"},{"title":"Tags","href":"/en/workspace/tags"}]}]},{"tab":"Collaboration","icon":"users","pages":[{"title":"Collaboration","href":"/en/collaboration/overview"}]},{"tab":"Automation","icon":"clock","pages":[{"title":"Automation","href":"/en/automation/overview"}]},{"tab":"Admin","icon":"gear","pages":[{"title":"Admin","href":"/en/admin/overview"}]},{"tab":"Monitoring","icon":"chart-line","pages":[{"title":"Monitoring","href":"/en/monitoring/overview"}]},{"tab":"Resources","icon":"screwdriver-wrench","pages":[{"title":"Resources","href":"/en/admin/deployment-checklist"}]}]}]},"basePath":"","title":"Agent Flow - Cloosphere Guide","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-D0FT0qQs.js","DynamicMarkdown-CQM9Bhbv.js","zoom-image-lightbox-BQ4tbj_9.js","lightbox-handle-r17bVUz3.js"]}