Skip to content

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

fix(web): surface memory-save failure as a toast in agent chat (#19844)

adwsb3f84284144c
diff --git a/web/src/hooks/use-send-message.ts b/web/src/hooks/use-send-message.ts
index 404a72a93f..74d343211a 100644
--- a/web/src/hooks/use-send-message.ts
+++ b/web/src/hooks/use-send-message.ts
@@ -73,6 +73,7 @@ export interface IMessageData {
content: string;
audio_binary: string;
outputs: any;
+ memory_error?: string;
start_to_think?: boolean;
end_to_think?: boolean;
}
diff --git a/web/src/pages/agent/chat/use-send-agent-message.test.tsx b/web/src/pages/agent/chat/use-send-agent-message.test.tsx
index f125d56042..4690e25baf 100644
--- a/web/src/pages/agent/chat/use-send-agent-message.test.tsx
+++ b/web/src/pages/agent/chat/use-send-agent-message.test.tsx
@@ -1,7 +1,10 @@
import { act, renderHook } from '@testing-library/react';
import { MessageEventType } from '@/hooks/use-send-message';
import { MessageType } from '@/constants/chat';
-import { useSendAgentMessage } from './use-send-agent-message';
+import {
+ findMessageFromList,
+ useSendAgentMessage,
+} from './use-send-agent-message';
let mockAnswerList: any[] = [];
let mockDone = true;
@@ -167,3 +170,22 @@ describe('useSendAgentMessage session-scoped stream gating', () => {
expect(result.current.requestedSessionId).toBe('session-new');
});
});
+
+describe('findMessageFromList memory errors', () => {
+ it.each([
+ [
+ MessageEventType.NodeFinished,
+ { outputs: { memory_error: 'failed' } },
+ 'failed',
+ ],
+ [
+ MessageEventType.Message,
+ { content: 'hello', memory_error: 'failed' },
+ 'failed',
+ ],
+ [MessageEventType.Message, { content: 'hello' }, undefined],
+ ])('extracts memory_error from %s with data %j', (event, data, expected) => {
+ mockAnswerList = [{ ...messageFrame('session-a', 'hello'), event, data }];
+ expect(findMessageFromList(mockAnswerList).memory_error).toBe(expected);
+ });
+});
diff --git a/web/src/pages/agent/chat/use-send-agent-message.ts b/web/src/pages/agent/chat/use-send-agent-message.ts
index c93e31b5f1..a2e3ad90a3 100644
--- a/web/src/pages/agent/chat/use-send-agent-message.ts
+++ b/web/src/pages/agent/chat/use-send-agent-message.ts
@@ -51,6 +51,18 @@ export function findMessageFromList(eventList: IEventList) {
let startIndex = -1;
let endIndex = -1;
let audioBinary = undefined;
+ // memory_error is surfaced by the backend in the Message component's
+ // output, which lands in a node_finished frame's `outputs` (and possibly
+ // on a message frame). Scan every event so the toast fires regardless of
+ // which frame carries it.
+ const memoryErrorHit = (eventList as any[]).find(
+ (x) => x.data?.memory_error || x.data?.outputs?.memory_error,
+ )?.data;
+ const memoryError = memoryErrorHit
+ ? ((memoryErrorHit.memory_error || memoryErrorHit.outputs?.memory_error) as
+ | string
+ | undefined)
+ : undefined;
messageEventList.forEach((x, idx) => {
const { data } = x;
const { content, start_to_think, end_to_think, audio_binary } = data;
@@ -89,6 +101,7 @@ export function findMessageFromList(eventList: IEventList) {
id: eventList[0]?.message_id,
content: nextContent,
audio_binary: audioBinary,
+ memory_error: memoryError,
attachment:
workflowFinished?.data?.outputs?.attachment ||
messageEndEvent?.data?.attachment ||
@@ -282,6 +295,9 @@ export const useSendAgentMessage = ({
const messageId = useMemo(() => {
return firstAnswer?.message_id;
}, [firstAnswer]);
+ // Guards the memory-save-failure toast so it fires once per (message, error)
+ // instead of repeatedly on every SSE append.
+ const memoryErrorShownRef = useRef<string | undefined>(undefined);
const isTaskMode = useIsTaskMode(isTask);
@@ -367,6 +383,7 @@ export const useSendAgentMessage = ({
}
try {
+ memoryErrorShownRef.current = undefined;
const res = await send(params);
clearUploadResponseList();
@@ -409,6 +426,7 @@ export const useSendAgentMessage = ({
role: MessageType.User,
});
setRequestedSessionId(sessionId ?? null);
+ memoryErrorShownRef.current = undefined;
await send({
...body,
...(isShared ? {} : { agent_id: agentId }),
@@ -503,8 +521,17 @@ export const useSendAgentMessage = ({
) {
return;
}
- const { content, id, attachment, audio_binary, downloads } =
+ const { content, id, attachment, audio_binary, memory_error, downloads } =
findMessageFromList(answerList);
+ // Surface memory-save failure (e.g. unavailable embedding model) as a
+ // toast, mirroring the prompt style used for LLM-unavailable errors.
+ if (
+ memory_error &&
+ memoryErrorShownRef.current !== `${id}:${memory_error}`
+ ) {
+ sonnerMessage.warning(memory_error);
+ memoryErrorShownRef.current = `${id}:${memory_error}`;
+ }
const inputAnswer = findInputFromList(answerList);
const answer = content || getLatestError(answerList);