Skip to content

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

10.6 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 (
	"context"
	"encoding/json"
	"sync"
	"testing"
	"time"

	"ragflow/internal/ingestion/chunkcache"
	"ragflow/internal/ingestion/component/schema"
)

// vecOf reads a float64 vector stored by SetExtraValue back out of the chunk.
func vecOf(t *testing.T, doc schema.ChunkDoc, key string) []float64 {
	t.Helper()
	raw, ok := doc.Extra[key]
	if !ok {
		t.Fatalf("missing extra %s", key)
	}
	var v []float64
	if err := json.Unmarshal(raw, &v); err != nil {
		t.Fatalf("unmarshal %s: %v", key, err)
	}
	return v
}

// memCacheStore is an in-memory chunkcache.Store used to exercise the
// per-chunk embedding cache without Redis.
type memCacheStore struct {
	mu   sync.Mutex
	data map[string]string
	sets map[string]map[string]struct{}
}

func newMemCacheStore() *memCacheStore {
	return &memCacheStore{data: map[string]string{}, sets: map[string]map[string]struct{}{}}
}

func (m *memCacheStore) Get(_ context.Context, key string) (string, error) {
	m.mu.Lock()
	defer m.mu.Unlock()
	return m.data[key], nil
}

func (m *memCacheStore) Set(_ context.Context, key, value string, _ time.Duration) bool {
	m.mu.Lock()
	defer m.mu.Unlock()
	m.data[key] = value
	return true
}

func (m *memCacheStore) SAdd(_ context.Context, key, member string) bool {
	m.mu.Lock()
	defer m.mu.Unlock()
	if m.sets[key] == nil {
		m.sets[key] = map[string]struct{}{}
	}
	m.sets[key][member] = struct{}{}
	return true
}

func (m *memCacheStore) SMembers(_ context.Context, key string) ([]string, error) {
	m.mu.Lock()
	defer m.mu.Unlock()
	out := make([]string, 0, len(m.sets[key]))
	for k := range m.sets[key] {
		out = append(out, k)
	}
	return out, nil
}

func (m *memCacheStore) Delete(_ context.Context, key string) bool {
	m.mu.Lock()
	defer m.mu.Unlock()
	delete(m.data, key)
	delete(m.sets, key)
	return true
}

func (m *memCacheStore) Expire(_ context.Context, key string, _ time.Duration) bool {
	return true
}

func (m *memCacheStore) countEmbKeys() int {
	m.mu.Lock()
	defer m.mu.Unlock()
	n := 0
	for k := range m.data {
		if len(k) >= len("kc:emb:") && k[:len("kc:emb:")] == "kc:emb:" {
			n++
		}
	}
	return n
}

// chunkWithID builds a ChunkDoc carrying a chunk id in Extra (so the cache
// key can be derived) plus the given body text.
func chunkWithID(id, text string) schema.ChunkDoc {
	doc, _ := schema.ChunkDocFromMap(map[string]any{"id": id, "text": text})
	return doc
}

func TestEmbedChunks_PerChunkCacheMissThenHit(t *testing.T) {
	comp, stub := withStubEmbedder(t, 4)
	comp.param.Fields = []string{"text"}

	store := newMemCacheStore()
	chunks := []schema.ChunkDoc{chunkWithID("chunk-1", "hello world")}

	// First pass: cache miss -> embedder is called once.
	out1, _, err := comp.embedChunks(context.Background(), "tenant", "kb", "", chunks, store)
	if err != nil {
		t.Fatalf("embedChunks (miss): %v", err)
	}
	if got := stub.calls.Load(); got != 1 {
		t.Fatalf("expected 1 embedder call on miss, got %d", got)
	}
	vec1 := vecOf(t, out1[0], "q_4_vec")
	if store.countEmbKeys() != 1 {
		t.Fatalf("expected 1 emb cache key after miss, got %d", store.countEmbKeys())
	}

	// Second pass with the same chunk id: cache hit -> embedder NOT called again.
	out2, _, err := comp.embedChunks(context.Background(), "tenant", "kb", "", chunks, store)
	if err != nil {
		t.Fatalf("embedChunks (hit): %v", err)
	}
	if got := stub.calls.Load(); got != 1 {
		t.Fatalf("expected embedder to be skipped on cache hit, but calls=%d", got)
	}
	vec2 := vecOf(t, out2[0], "q_4_vec")
	if len(vec1) != len(vec2) {
		t.Fatalf("cached vector differs from embedded vector: %v vs %v", vec1, vec2)
	}
	for i := range vec1 {
		if vec1[i] != vec2[i] {
			t.Fatalf("cached vector differs from embedded vector: %v vs %v", vec1, vec2)
		}
	}
}

func TestEmbedChunks_CacheKeyScopedByChunkAndEmbdID(t *testing.T) {
	embdID := "embd-a"
	comp, stub := withStubEmbedderEmbdID(t, 4, &embdID)
	comp.param.Fields = []string{"text"}

	store := newMemCacheStore()

	// Two distinct chunks -> two embedder calls, two cache keys.
	a := []schema.ChunkDoc{chunkWithID("chunk-a", "alpha"), chunkWithID("chunk-b", "beta")}
	if _, _, err := comp.embedChunks(context.Background(), "tenant", "kb", "", a, store); err != nil {
		t.Fatalf("embedChunks: %v", err)
	}
	if got := stub.calls.Load(); got != 1 {
		t.Fatalf("expected 1 batch call for 2 chunks, got %d", got)
	}
	if n := store.countEmbKeys(); n != 2 {
		t.Fatalf("expected 2 emb cache keys for 2 distinct chunks, got %d", n)
	}

	// Rebinding the dataset to a different embedding model must bypass the
	// cache: the key is derived from the dataset's embd_id, so the entry
	// written under embd-a is not reusable and a stale vector is never served.
	embdID = "embd-b"
	b := []schema.ChunkDoc{chunkWithID("chunk-a", "alpha")}
	if _, _, err := comp.embedChunks(context.Background(), "tenant", "kb", "", b, store); err != nil {
		t.Fatalf("embedChunks (rebound embd_id): %v", err)
	}
	if got := stub.calls.Load(); got != 2 {
		t.Fatalf("expected a new embedder call after the dataset's embd_id changed, got calls=%d", got)
	}
	if n := store.countEmbKeys(); n != 3 {
		t.Fatalf("expected 3 emb cache keys after embd_id change, got %d", n)
	}
}

// The embedding model comes from the dataset, never from the DSL: two components
// configured with different setups.embedding_model but the same dataset embd_id
// must resolve to the same cache entry. This locks in that the DSL cannot
// influence the cache key (and would fail if setups.embedding_model were read
// again), which is what previously let a re-bound dataset serve a stale vector.
func TestEmbedChunks_CacheIgnoresDSLEmbeddingModel(t *testing.T) {
	embdID := "embd-a"
	stub := newStubEmbedder(4)
	build := func(dslModel string) *TokenizerComponent {
		comp, err := NewTokenizerComponentWithResolver(
			map[string]any{"setups": map[string]any{"embedding_model": dslModel}},
			func(_ context.Context, _, _ string) (Embedder, string, error) { return stub, embdID, nil },
		)
		if err != nil {
			t.Fatalf("NewTokenizerComponentWithResolver: %v", err)
		}
		c := comp.(*TokenizerComponent)
		c.param.Fields = []string{"text"}
		return c
	}

	store := newMemCacheStore()
	chunks := []schema.ChunkDoc{chunkWithID("chunk-1", "hello world")}

	if _, _, err := build("dsl-model-a").embedChunks(context.Background(), "tenant", "kb", "", chunks, store); err != nil {
		t.Fatalf("embedChunks (dsl-model-a): %v", err)
	}
	if got := stub.calls.Load(); got != 1 {
		t.Fatalf("expected 1 embedder call on miss, got %d", got)
	}

	// Same dataset embd_id, different DSL model -> must hit the same entry.
	if _, _, err := build("dsl-model-b").embedChunks(context.Background(), "tenant", "kb", "", chunks, store); err != nil {
		t.Fatalf("embedChunks (dsl-model-b): %v", err)
	}
	if got := stub.calls.Load(); got != 1 {
		t.Fatalf("DSL embedding_model must not affect the cache key: expected a hit, got calls=%d", got)
	}
	if n := store.countEmbKeys(); n != 1 {
		t.Fatalf("expected 1 emb cache key across both DSL models, got %d", n)
	}
}

// TestEmbedChunks_CacheKeyScopedByFields proves the embedding cache key captures
// the text actually embedded — which depends on c.param.Fields — so changing the
// tokenizer field selection forces a fresh embed instead of serving a stale
// vector for up to the cache TTL. The chunk id is unchanged across the two runs,
// isolating the variable to the embedded text.
func TestEmbedChunks_CacheKeyScopedByFields(t *testing.T) {
	embdID := "embd-test"
	stub := newStubEmbedder(4)
	build := func(fields []string) *TokenizerComponent {
		comp, err := NewTokenizerComponentWithResolver(nil, func(_ context.Context, _, _ string) (Embedder, string, error) {
			return stub, embdID, nil
		})
		if err != nil {
			t.Fatalf("NewTokenizerComponentWithResolver: %v", err)
		}
		c := comp.(*TokenizerComponent)
		c.param.Fields = fields
		return c
	}

	store := newMemCacheStore()
	doc := schema.ChunkDoc{Text: "hello", Questions: "q1;q2"}
	doc.Extra = map[string]json.RawMessage{}
	if err := doc.SetExtraValue("id", "chunk-1"); err != nil {
		t.Fatalf("SetExtraValue(id): %v", err)
	}
	chunks := []schema.ChunkDoc{doc}

	// Fields=["text"]: only the body is embedded -> cache miss, 1 call.
	if _, _, err := build([]string{"text"}).embedChunks(context.Background(), "tenant", "kb", "", chunks, store); err != nil {
		t.Fatalf("embedChunks (fields=text): %v", err)
	}
	if got := stub.calls.Load(); got != 1 {
		t.Fatalf("expected 1 embedder call with fields=text, got %d", got)
	}

	// Fields=["text","questions"]: the embedded text now includes the questions,
	// so the key must differ and the cache must be bypassed (another call).
	if _, _, err := build([]string{"text", "questions"}).embedChunks(context.Background(), "tenant", "kb", "", chunks, store); err != nil {
		t.Fatalf("embedChunks (fields=text,questions): %v", err)
	}
	if got := stub.calls.Load(); got != 2 {
		t.Fatalf("expected a fresh embed when Fields change the embedded text, got calls=%d (stale vector would otherwise be served)", got)
	}
	if n := store.countEmbKeys(); n != 2 {
		t.Fatalf("expected 2 emb cache keys (one per embedded-text variant), got %d", n)
	}
}

func TestEmbedChunks_MissingChunkIDSkipsCache(t *testing.T) {
	comp, stub := withStubEmbedder(t, 4)
	comp.param.Fields = []string{"text"}

	store := newMemCacheStore()
	// Chunk without an id: cannot be cached, always embedded.
	noID, _ := schema.ChunkDocFromMap(map[string]any{"text": "no id here"})

	first, _, err := comp.embedChunks(context.Background(), "tenant", "kb", "", []schema.ChunkDoc{noID}, store)
	if err != nil {
		t.Fatalf("embedChunks (no id): %v", err)
	}
	if stub.calls.Load() != 1 {
		t.Fatalf("expected embedder call for uncacheable chunk")
	}
	vecOf(t, first[0], "q_4_vec")
	if n := store.countEmbKeys(); n != 0 {
		t.Fatalf("expected no emb cache key for id-less chunk, got %d", n)
	}

	// Second pass: still no id -> still embedded (calls increment).
	comp.embedChunks(context.Background(), "tenant", "kb", "", []schema.ChunkDoc{noID}, store)
	if stub.calls.Load() != 2 {
		t.Fatalf("expected a second embedder call for id-less chunk (cache not used), got %d", stub.calls.Load())
	}
}

var _ chunkcache.Store = (*memCacheStore)(nil)