Skip to content

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

fix(web): warn about empty Message component content on agent save (#18993)

euvreb9d97d002679
diff --git a/web/src/pages/agent/hooks/use-save-graph.ts b/web/src/pages/agent/hooks/use-save-graph.ts
index 7eb07643a1..40b50cfc30 100644
--- a/web/src/pages/agent/hooks/use-save-graph.ts
+++ b/web/src/pages/agent/hooks/use-save-graph.ts
@@ -10,12 +10,14 @@ import {
} from '@/interfaces/database/agent';
import { formatDate } from '@/utils/date';
import { useDebounceEffect } from 'ahooks';
+import { t } from 'i18next';
import { useCallback, useEffect, useState } from 'react';
import { useTranslation } from 'react-i18next';
import { useParams } from 'react-router';
import { Operator } from '../constant';
import { FormSchema as ParserFormSchema } from '../form/parser-form';
import useGraphStore from '../store';
+import { getEmptyMessageNodeNames } from '../utils';
import { useBuildDslData } from './use-build-dsl';
/**
@@ -89,6 +91,22 @@ export const useSaveGraph = (
return;
}
+ // Warn about Message components with empty content at save time; the
+ // canvas only fails on them when the agent runs otherwise (backend
+ // MessageParam.check() rejects empty content). Advisory only — the save
+ // itself proceeds. Autosave/publish (showMessage=false) stay silent to
+ // avoid nagging toasts.
+ if (showMessage) {
+ const emptyMessageNodeNames = getEmptyMessageNodeNames(
+ currentNodes ?? useGraphStore.getState().nodes,
+ );
+ if (emptyMessageNodeNames.length > 0) {
+ message.warning(
+ `${emptyMessageNodeNames.join(', ')}: ${t('flow.messageMsg')}`,
+ );
+ }
+ }
+
const params: Record<string, any> = {
id,
title: data.title,
@@ -101,7 +119,7 @@ export const useSaveGraph = (
return setAgent(params);
},
- [id, getInvalidNode, data.title, buildDslData, setAgent],
+ [id, getInvalidNode, showMessage, data.title, buildDslData, setAgent],
);
return { saveGraph, loading };
diff --git a/web/src/pages/agent/utils.test.ts b/web/src/pages/agent/utils.test.ts
index 21b22abd60..a4f550136b 100644
--- a/web/src/pages/agent/utils.test.ts
+++ b/web/src/pages/agent/utils.test.ts
@@ -1,4 +1,16 @@
-import { transformTokenChunkerParams } from './utils';
+import { Operator } from './constant';
+import {
+ getEmptyMessageNodeNames,
+ isEmptyMessageContent,
+ transformTokenChunkerParams,
+} from './utils';
+
+const createMessageNode = (name: string, content: unknown) => ({
+ id: `${Operator.Message}:${name}`,
+ type: 'ragNode',
+ position: { x: 0, y: 0 },
+ data: { label: Operator.Message, name, form: { content } },
+});
describe('transformTokenChunkerParams', () => {
it('keeps overlapped_percent and delimiters when delimiter_mode is one', () => {
@@ -37,3 +49,40 @@ describe('transformTokenChunkerParams', () => {
expect(result.image_context_size).toBe(81);
});
});
+
+describe('Message component content validation', () => {
+ describe('isEmptyMessageContent', () => {
+ it('treats missing, non-array and blank-only content as empty', () => {
+ expect(isEmptyMessageContent()).toBe(true);
+ expect(isEmptyMessageContent(null)).toBe(true);
+ expect(isEmptyMessageContent('hello')).toBe(true);
+ expect(isEmptyMessageContent([])).toBe(true);
+ expect(isEmptyMessageContent(['', ' \t '])).toBe(true);
+ // Non-string entries never satisfy the backend either.
+ expect(isEmptyMessageContent([123])).toBe(true);
+ });
+
+ it('accepts content with at least one non-blank string entry', () => {
+ expect(isEmptyMessageContent(['hi'])).toBe(false);
+ expect(isEmptyMessageContent(['', '{begin@query}'])).toBe(false);
+ expect(isEmptyMessageContent([' text '])).toBe(false);
+ });
+ });
+
+ describe('getEmptyMessageNodeNames', () => {
+ it('flags only Message nodes whose content is empty', () => {
+ const nodes = [
+ createMessageNode('回复消息_0', ['']),
+ createMessageNode('回复消息_1', ['ok']),
+ {
+ id: `${Operator.Agent}:x`,
+ type: 'ragNode',
+ position: { x: 0, y: 0 },
+ data: { label: Operator.Agent, name: '智能体_0', form: {} },
+ },
+ ];
+
+ expect(getEmptyMessageNodeNames(nodes as any)).toEqual(['回复消息_0']);
+ });
+ });
+});
diff --git a/web/src/pages/agent/utils.ts b/web/src/pages/agent/utils.ts
index cb806f8ef4..61d6cd1672 100644
--- a/web/src/pages/agent/utils.ts
+++ b/web/src/pages/agent/utils.ts
@@ -933,6 +933,34 @@ export function convertToObjectArray<T extends string | number | boolean>(
return list.map((x) => ({ value: x }));
}
+/**
+ * Message (回复消息) components keep their texts in form.content (string[]).
+ * The backend rejects the component at canvas run time unless at least one
+ * entry is a non-blank string, so missing/non-array/blank-only content all
+ * count as empty here as well.
+ */
+export function isEmptyMessageContent(content?: unknown): boolean {
+ return (
+ !Array.isArray(content) ||
+ !content.some((item) => typeof item === 'string' && item.trim() !== '')
+ );
+}
+
+/**
+ * Returns the display names of Message nodes whose content is empty, so the
+ * save flow can warn about them up front instead of surfacing the runtime
+ * error only when the user runs the agent.
+ */
+export function getEmptyMessageNodeNames(nodes: RAGFlowNodeType[]): string[] {
+ return nodes
+ .filter(
+ (node) =>
+ node.data?.label === Operator.Message &&
+ isEmptyMessageContent(node.data?.form?.content),
+ )
+ .map((node) => node.data?.name ?? node.id);
+}
+
/**
* convert the following object into a list
*