Skip to content

RAGFlow is an agent-native database: a Retrieval-Augmented Generation (RAG) engine that grew into context infrastructure.

feat(agent): expose Iteration max_concurrency on the canvas (#19066)

天海蒼灆07660a1bb223
diff --git a/agent/component/iteration.py b/agent/component/iteration.py
index 3ccae2c0bb..0159e80b5a 100644
--- a/agent/component/iteration.py
+++ b/agent/component/iteration.py
@@ -34,6 +34,7 @@ class IterationParam(ComponentParamBase):
super().__init__()
self.items_ref = ""
self.variable = {}
+ self.max_concurrency = 0
def get_input_form(self) -> dict[str, dict]:
return {"items": {"type": "json", "name": "Items"}}
diff --git a/web/src/locales/en.ts b/web/src/locales/en.ts
index 159e79bb6e..bf4a7585f4 100644
--- a/web/src/locales/en.ts
+++ b/web/src/locales/en.ts
@@ -2630,6 +2630,9 @@ Best for: Documents with flowing, contextually connected content — such as boo
script: 'Script',
iterationItemDescription:
'It represents the current element in the iteration, which can be referenced and manipulated in subsequent steps.',
+ maxConcurrency: 'Max concurrency',
+ maxConcurrencyTip:
+ '0 or 1 runs items one by one. Values greater than 1 run that many items at once.',
guidingQuestion: 'Guidance question',
onFailure: 'On failure',
userPromptDefaultValue:
diff --git a/web/src/locales/zh.ts b/web/src/locales/zh.ts
index a3f2bf95b2..2608d0783e 100644
--- a/web/src/locales/zh.ts
+++ b/web/src/locales/zh.ts
@@ -2248,6 +2248,8 @@ NER:使用 spaCy NER 和基于规则的关键词提取来抽取 Entities 和 R
script: '脚本',
iterationItemDescription:
'它是迭代过程中的当前元素,可以被后续流程引用和操作。',
+ maxConcurrency: '最大并发数',
+ maxConcurrencyTip: '0 或 1 表示逐项串行。大于 1 时按该数量并行处理。',
guidingQuestion: '引导问题',
onFailure: '异常时',
userPromptDefaultValue:
diff --git a/web/src/pages/agent/constant/index.tsx b/web/src/pages/agent/constant/index.tsx
index 31bf638dcb..4a670aaec6 100644
--- a/web/src/pages/agent/constant/index.tsx
+++ b/web/src/pages/agent/constant/index.tsx
@@ -473,6 +473,7 @@ export const initialEmailValues = {
export const initialIterationValues = {
items_ref: '',
+ max_concurrency: 0,
outputs: {},
};
diff --git a/web/src/pages/agent/form/iteration-form/index.tsx b/web/src/pages/agent/form/iteration-form/index.tsx
index 61e16277df..a0f8d35503 100644
--- a/web/src/pages/agent/form/iteration-form/index.tsx
+++ b/web/src/pages/agent/form/iteration-form/index.tsx
@@ -1,7 +1,10 @@
+import { SliderInputFormField } from '@/components/slider-input-form-field';
import { Form } from '@/components/ui/form';
+import { FormLayout } from '@/constants/form';
import { zodResolver } from '@hookform/resolvers/zod';
import { memo, useMemo } from 'react';
import { useForm, useWatch } from 'react-hook-form';
+import { useTranslation } from 'react-i18next';
import { z } from 'zod';
import { ArrayFields } from '../../constant';
import { INextOperatorForm } from '../../interface';
@@ -23,11 +26,13 @@ const FormSchema = z.object({
mode: z.string(),
}),
),
+ max_concurrency: z.coerce.number().int().min(0),
outputs: z.array(z.object({ name: z.string(), value: z.any() })).optional(),
});
function IterationForm({ node }: INextOperatorForm) {
const defaultValues = useValues(node);
+ const { t } = useTranslation();
const form = useForm({
defaultValues: defaultValues,
@@ -52,6 +57,15 @@ function IterationForm({ node }: INextOperatorForm) {
name="items_ref"
types={ArrayFields as any[]}
></QueryVariable>
+ <SliderInputFormField
+ min={0}
+ max={32}
+ name="max_concurrency"
+ label={t('flow.maxConcurrency')}
+ tooltip={t('flow.maxConcurrencyTip')}
+ layout={FormLayout.Vertical}
+ integer
+ ></SliderInputFormField>
<DynamicOutput node={node}></DynamicOutput>
<Output list={outputList}></Output>
</FormWrapper>
diff --git a/web/src/pages/agent/form/iteration-form/use-values.ts b/web/src/pages/agent/form/iteration-form/use-values.ts
index 0d2bde6ed5..1257d8cba1 100644
--- a/web/src/pages/agent/form/iteration-form/use-values.ts
+++ b/web/src/pages/agent/form/iteration-form/use-values.ts
@@ -20,7 +20,11 @@ export function useValues(node?: RAGFlowNodeType) {
return { ...initialIterationValues, outputs: [] };
}
- return { ...formData, outputs: convertToArray(formData.outputs) };
+ return {
+ ...initialIterationValues,
+ ...formData,
+ outputs: convertToArray(formData.outputs || {}),
+ };
}, [node?.data?.form]);
return values;