ragflow/docs/guides/agent/agent_workflow/flow_control_components.md

---
sidebar_position: 2
title: Flow Control Components
sidebar_label: Flow Control Components
slug: /flow_control_components
sidebar_custom_props: {
  categoryIcon: RagAiAgent
}
---

# Flow Control Components
## Await Response Component
Await Response pauses the workflow and waits for users to supplement information. Suitable for multi-turn dialogue, form collection, confirmation operations or file upload requirements.

Configuration:
Define prompt messages to guide users. Input supports the same variable types as Begin: single-line text, paragraph text, dropdown options, file upload, number and boolean.

Recommendations:
- Dropdown options: Select business categories
- Paragraph text: Collect detailed requirement descriptions
- File upload: Receive contracts, reports or screenshots
- Boolean: Confirm continue/cancel operations

![User Input Component](https://raw.githubusercontent.com/infiniflow/ragflow-docs/main/images/user_input_component.jpg)


## Switch (Conditional) Component
Switch executes rule-based judgment and routes workflows to different downstream paths according to results.

Configuration:
At least one Case must be defined. Each Case can contain multiple conditions combined by AND / OR.
Supported operators: Equals, Not equal, Greater than, Greater equal, Less than, Less equal, Contains, Not contains, Starts with, Ends with, Is empty, Not empty.

:::tip NOTE
Switch is rule-based judgment for structured data and clear conditions. Categorize uses LLM-based classification for natural language intent recognition.
:::

![Condition Component](https://raw.githubusercontent.com/infiniflow/ragflow-docs/main/images/condition_component.jpg)

## Iteration Component
Iteration splits text into fragments and executes the same set of internal components for each fragment. Suitable for long-text translation, paragraph-wise summarization, batch generation and item-by-item list processing.

Internal Workflow:
Iteration contains built-in `Loop Item`. Components dragged inside Iteration can only be accessed within the loop. Reference `Loop Item` to obtain current fragment data.

Configuration Parameters:
- **Loop variables**: Variables used during iteration; support read and update inside the loop
- **Loop termination condition**: Exit condition to stop iteration
- **Maximum loop count**: Prevent infinite iteration

:::tip NOTE
Configure both termination condition and maximum loop count to avoid long-running infinite loops.
:::

![Loop Component](https://raw.githubusercontent.com/infiniflow/ragflow-docs/main/images/loop_component.jpg)

## Categorize Component
Categorize uses LLM to judge user intent or input category and branch the workflow based on classification results.

Configuration Steps:
1. Select content to classify in Query variable / Input.
2. Select model and Creativity.
3. Configure message window size (keep default for single-turn classification).
4. Add at least two Categories.
5. Fill clear Name, Description and Examples for each category.
6. Connect downstream components for each classification result on the canvas.

Classification Recommendations:
Use easy-to-understand category names, e.g. Product Consultation, Installation Reservation, After-sales Fault, Other Questions.
Examples improve classification stability; provide 2~3 typical samples for each category.

![Question Classification Component](https://raw.githubusercontent.com/infiniflow/ragflow-docs/main/images/question_classification_component.jpg)