Skip to content

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

11.2 KB
Raw Blame
//
//  Copyright 2026 The InfiniFlow Authors. All Rights Reserved.
//
//  Licensed under the Apache License, Version 2.0 (the "License");
//  you may not use this file except in compliance with the License.
//  You may obtain a copy of the License at
//
//      http://www.apache.org/licenses/LICENSE-2.0
//
//  Unless required by applicable law or agreed to in writing, software
//  distributed under the License is distributed on an "AS IS" BASIS,
//  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
//  See the License for the specific language governing permissions and
//  limitations under the License.
//

package component

import (
	"testing"

	"github.com/cloudwego/eino/schema"

	"ragflow/internal/agent/runtime"
)

// TestPrependHistory_EmptyHistory: no history → no prepend.
func TestPrependHistory_EmptyHistory(t *testing.T) {
	current := []schema.Message{{Role: schema.User, Content: "hi"}}
	out := prependHistory(current, nil, 5)
	if len(out) != 1 {
		t.Errorf("expected 1 message, got %d", len(out))
	}
}

// TestPrependHistory_WindowZero: window=0 → no prepend.
func TestPrependHistory_WindowZero(t *testing.T) {
	current := []schema.Message{{Role: schema.User, Content: "hi"}}
	hist := []map[string]any{
		{"role": "user", "content": "older"},
	}
	out := prependHistory(current, hist, 0)
	if len(out) != 1 {
		t.Errorf("expected 1 message, got %d", len(out))
	}
}

// TestPrependHistory_AllWithinWindow: history shorter than window → all kept.
func TestPrependHistory_AllWithinWindow(t *testing.T) {
	current := []schema.Message{{Role: schema.User, Content: "now"}}
	hist := []map[string]any{
		{"role": "user", "content": "turn 1"},
		{"role": "assistant", "content": "reply 1"},
		{"role": "user", "content": "turn 2"},
	}
	out := prependHistory(current, hist, 10)
	if len(out) != 4 {
		t.Fatalf("expected 4 messages, got %d", len(out))
	}
	if out[0].Content != "turn 1" || out[0].Role != "user" {
		t.Errorf("first history entry wrong: %+v", out[0])
	}
	if out[1].Role != "assistant" {
		t.Errorf("second entry should be assistant: %+v", out[1])
	}
	if out[3].Content != "now" {
		t.Errorf("current message should be last: %+v", out[3])
	}
}

// TestPrependHistory_TruncatesToWindow: history longer than window → keep last N.
func TestPrependHistory_TruncatesToWindow(t *testing.T) {
	current := []schema.Message{{Role: schema.User, Content: "now"}}
	hist := []map[string]any{
		{"role": "user", "content": "turn 1"},
		{"role": "assistant", "content": "reply 1"},
		{"role": "user", "content": "turn 2"},
		{"role": "assistant", "content": "reply 2"},
		{"role": "user", "content": "turn 3"},
	}
	out := prependHistory(current, hist, 2)
	if len(out) != 3 {
		t.Fatalf("expected 3 messages (2 history + current), got %d", len(out))
	}
	// Should keep the last 2: turn 2 (user) and turn 3 (user), plus current.
	if out[0].Content != "reply 2" {
		t.Errorf("expected first kept entry to be 'reply 2' (the 4th of 5 with window=2), got %q", out[0].Content)
	}
	if out[1].Content != "turn 3" {
		t.Errorf("expected second kept entry to be 'turn 3', got %q", out[1].Content)
	}
	if out[2].Content != "now" {
		t.Errorf("current should be last: %+v", out[2])
	}
}

// TestPrependHistory_SkipsInvalidEntries: entries missing role or content are skipped.
func TestPrependHistory_SkipsInvalidEntries(t *testing.T) {
	current := []schema.Message{{Role: schema.User, Content: "now"}}
	hist := []map[string]any{
		{"role": "user"},       // missing content
		{"content": "no role"}, // missing role
		{"role": "user", "content": "valid"},
	}
	out := prependHistory(current, hist, 10)
	if len(out) != 2 {
		t.Fatalf("expected 2 (1 valid history + current), got %d", len(out))
	}
	if out[0].Content != "valid" {
		t.Errorf("expected valid entry to be kept; got %+v", out[0])
	}
}

// TestLLM_Invoke_HistoryWindow_PrependsFromState: end-to-end — when a
// canvas state carries history and the LLM is configured with a
// non-zero window size, the prior turns are prepended.
func TestLLM_Invoke_HistoryWindow_PrependsFromState(t *testing.T) {
	stub := &stubInvoker{resp: &ChatInvokeResponse{Content: "ok", Model: "echo"}}
	withStubInvoker(t, stub)

	state := runtime.NewCanvasState("rid", "tid")
	state.History = []map[string]any{
		{"role": "user", "content": "earlier 1"},
		{"role": "assistant", "content": "earlier reply 1"},
	}
	window := 5
	c := NewLLMComponent(LLMParam{
		ModelID:                  "echo",
		UserPrompt:               "now",
		MessageHistoryWindowSize: window,
	})
	ctx := runtime.WithState(t.Context(), state)
	_, err := c.Invoke(ctx, nil, map[string]any{})
	if err != nil {
		t.Fatalf("Invoke: %v", err)
	}
	if stub.captured == nil {
		t.Fatal("invoker captured no request")
	}
	if len(stub.captured.Messages) != 3 {
		t.Fatalf("expected 3 messages (2 history + 1 current), got %d",
			len(stub.captured.Messages))
	}
	if stub.captured.Messages[0].Content != "earlier 1" {
		t.Errorf("first msg should be 'earlier 1', got %q", stub.captured.Messages[0].Content)
	}
	if stub.captured.Messages[1].Content != "earlier reply 1" {
		t.Errorf("second msg should be 'earlier reply 1', got %q", stub.captured.Messages[1].Content)
	}
	if stub.captured.Messages[2].Content != "now" {
		t.Errorf("last msg should be current 'now', got %q", stub.captured.Messages[2].Content)
	}
}

func TestLLM_Invoke_HistoryWindow_DoesNotDuplicateCurrentUser(t *testing.T) {
	stub := &stubInvoker{resp: &ChatInvokeResponse{Content: "ok", Model: "echo"}}
	withStubInvoker(t, stub)

	state := runtime.NewCanvasState("rid", "tid")
	state.AppendHistory("user", "earlier")
	state.AppendHistory("assistant", map[string]any{"content": "earlier reply"})
	state.AppendCurrentUser("now")
	c := NewLLMComponent(LLMParam{
		ModelID:                  "echo",
		UserPrompt:               "now",
		MessageHistoryWindowSize: 5,
	})
	ctx := runtime.WithState(t.Context(), state)
	if _, err := c.Invoke(ctx, nil, map[string]any{}); err != nil {
		t.Fatalf("Invoke: %v", err)
	}

	if len(stub.captured.Messages) != 3 {
		t.Fatalf("messages = %#v, want two prior turns plus one current user", stub.captured.Messages)
	}
	currentCount := 0
	for _, message := range stub.captured.Messages {
		if message.Content == "now" {
			currentCount++
		}
	}
	if currentCount != 1 {
		t.Fatalf("current user occurrence count = %d, want 1", currentCount)
	}
}

// TestLLM_Invoke_HistoryWindow_ZeroIsNoop: when window is 0, history is
// not prepended even if present in state.
func TestLLM_Invoke_HistoryWindow_ZeroIsNoop(t *testing.T) {
	stub := &stubInvoker{resp: &ChatInvokeResponse{Content: "ok", Model: "echo"}}
	withStubInvoker(t, stub)

	state := runtime.NewCanvasState("rid", "tid")
	state.History = []map[string]any{
		{"role": "user", "content": "should be ignored"},
	}
	c := NewLLMComponent(LLMParam{
		ModelID:    "echo",
		UserPrompt: "now",
		// MessageHistoryWindowSize: 0 (default)
	})
	ctx := runtime.WithState(t.Context(), state)
	_, _ = c.Invoke(ctx, nil, map[string]any{})
	if len(stub.captured.Messages) != 1 {
		t.Errorf("expected only 1 message (no history), got %d", len(stub.captured.Messages))
	}
}

func TestAgentFactoryMessageHistoryWindow(t *testing.T) {
	tests := []struct {
		name   string
		params map[string]any
		want   int
	}{
		{
			name:   "python default",
			params: map[string]any{"model_id": "stub", "user_prompt": "now"},
			want:   defaultAgentMessageHistoryWindowSize,
		},
		{
			name: "dsl value",
			params: map[string]any{
				"model_id":                    "stub",
				"user_prompt":                 "now",
				"message_history_window_size": 12,
			},
			want: 12,
		},
		{
			name: "explicitly disabled",
			params: map[string]any{
				"model_id":                    "stub",
				"user_prompt":                 "now",
				"message_history_window_size": 0,
			},
			want: 0,
		},
	}

	for _, tt := range tests {
		t.Run(tt.name, func(t *testing.T) {
			component, err := New("Agent", tt.params)
			if err != nil {
				t.Fatalf("New(Agent): %v", err)
			}
			agent, ok := component.(*AgentComponent)
			if !ok {
				t.Fatalf("component type = %T, want *AgentComponent", component)
			}
			if got := agent.param.MessageHistoryWindowSize; got != tt.want {
				t.Fatalf("message history window = %d, want %d", got, tt.want)
			}
		})
	}
}

func TestBuildAgentInputMessagesIncludesPriorConversation(t *testing.T) {
	state := runtime.NewCanvasState("run-agent-history", "task-agent-history")
	state.AppendHistory("user", "第 8 章下面的第一个副标题是什么?")
	state.AppendHistory("assistant", map[string]any{"content": "第一个是解析器工厂。"})
	state.AppendCurrentUser("第二个呢?")
	ctx := runtime.WithState(t.Context(), state)

	messages := buildAgentInputMessages(ctx, AgentParam{
		SystemPrompt:             "请根据知识库回答。",
		UserPrompt:               "第二个呢?",
		MessageHistoryWindowSize: 12,
	})
	if len(messages) != 3 {
		t.Fatalf("message count = %d, want 3", len(messages))
	}
	wantRoles := []schema.RoleType{schema.User, schema.Assistant, schema.User}
	wantContent := []string{
		"第 8 章下面的第一个副标题是什么?",
		"第一个是解析器工厂。",
		"第二个呢?",
	}
	for i := range messages {
		if messages[i].Role != wantRoles[i] || messages[i].Content != wantContent[i] {
			t.Fatalf("message[%d] = (%q, %q), want (%q, %q)",
				i, messages[i].Role, messages[i].Content, wantRoles[i], wantContent[i])
		}
	}
}

func TestBuildAgentInputMessagesUsesConversationTurnWindow(t *testing.T) {
	state := runtime.NewCanvasState("run-agent-window", "task-agent-window")
	state.AppendHistory("user", "old question")
	state.AppendHistory("assistant", "old answer")
	state.AppendHistory("user", "recent question")
	state.AppendHistory("assistant", "recent answer")
	state.AppendCurrentUser("current question")
	ctx := runtime.WithState(t.Context(), state)

	messages := buildAgentInputMessages(ctx, AgentParam{
		UserPrompt:               "current question",
		MessageHistoryWindowSize: 1,
	})
	if len(messages) != 2 {
		t.Fatalf("message count = %d, want Python's final prior entry plus current user", len(messages))
	}
	if messages[0].Content != "recent answer" || messages[1].Content != "current question" {
		t.Fatalf("messages = %#v", messages)
	}
}

func TestBuildAgentInputMessagesZeroWindowDisablesHistory(t *testing.T) {
	state := runtime.NewCanvasState("run-agent-no-history", "task-agent-no-history")
	state.AppendHistory("user", "ignored question")
	state.AppendHistory("assistant", "ignored answer")
	state.AppendCurrentUser("current question")
	ctx := runtime.WithState(t.Context(), state)

	messages := buildAgentInputMessages(ctx, AgentParam{UserPrompt: "current question"})
	if len(messages) != 1 || messages[0].Content != "current question" {
		t.Fatalf("messages = %#v, want current user only", messages)
	}
}

func TestBuildAgentInputMessagesReplacesTrailingUserLikePython(t *testing.T) {
	state := runtime.NewCanvasState("run-agent-trailing-user", "task-agent-trailing-user")
	state.AppendHistory("user", "unanswered previous input")
	state.AppendCurrentUser("current question")
	ctx := runtime.WithState(t.Context(), state)

	messages := buildAgentInputMessages(ctx, AgentParam{
		UserPrompt:               "current question",
		MessageHistoryWindowSize: 12,
	})
	if len(messages) != 1 || messages[0].Content != "current question" {
		t.Fatalf("messages = %#v, want trailing user replaced by current prompt", messages)
	}
}