RAGFlow is an agent-native database: a Retrieval-Augmented Generation (RAG) engine that grew into context infrastructure.
Go agent-harnessagent-native-databaseagentic-aiagentic-retrievalagentic-searchaiai-agentscontext-enginecontext-engineeringcontext-managementharness-engineeringknowledge-compilationragretrieval-augmented-generationretrieval-harnesssearch-harness
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.tsindex 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.tsindex 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.tsindex 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*