Flow — multi-step processes
Draw the agent as a graph of steps on a canvas, draft it from a sentence, validate before publishing, and handle a failing step.
The Configuration tab describes an agent that decides for itself which tool to use. The Flow tab is for when you want to fix the order: classify → search → ask a person → send. When a flow exists it replaces the default loop; Discard flow goes back.
Getting started
- Start a flow — an empty canvas with a Start node.
- Draft with a prompt — describe the process in a sentence (classify the email, if it is a complaint look up the refund policy and draft a reply) and click Draft the flow. Ragenta draws a draft graph; you refine it. Drafting again asks for confirmation before replacing the existing flow.
Steps (Add a step)
| Step | What it does |
|---|---|
| Start | Receives the run's input. |
| Model | One model call with its own prompt. |
| Search | Searches the knowledge bases. |
| Agent | Calls another agent as a step. |
| Classify | The model assigns one label from a list you give. |
| Condition | Branches on a value. |
| Ask a person | Pauses, asks the user for fields, then continues. |
| Message | Writes a text block into the output. |
| HTTP | Calls a URL / API. |
| Read document, Look at image, Transcribe, Speak | OCR, vision, STT, TTS. |
| Spreadsheet | Reads/writes xlsx. |
| Browse | Opens a page in a real browser (read only). |
| For each | Repeats a branch over each item. |
References between steps
In a step's parameters, template syntax pulls in earlier results: {{begin.text}} is the original
input, {{id.text}} the output of the step with that id, {{sys.attachment}} the attached file.
The NodeReferences table in the right panel lists the valid references for the selected step.
If this step fails
Every step has an error policy: retries (0–3), a stand-in value (a replacement to carry
on with), or go to another step (up to 4 targets). With none set, the run failed at that
step.
Checks and publishing
The Checks panel lists structural problems (unconnected steps, bad references, missing parameters) — items marked blocking publish must be fixed before Publish new version enables. Publishing creates a new version, as in Configuration.