Skip to content

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

14.0 KB
Raw Blame
package tool

import (
	"strings"
	"testing"
)

func TestBuildAll_KnownTools(t *testing.T) {
	tools, err := BuildAll([]string{"retrieval", "wikipedia"}, nil)
	if err != nil {
		t.Fatalf("BuildAll: %v", err)
	}
	if len(tools) != 2 {
		t.Fatalf("len(tools) = %d, want 2", len(tools))
	}
	ctx := t.Context()
	info0, err := tools[0].Info(ctx)
	if err != nil {
		t.Fatalf("tools[0].Info: %v", err)
	}
	if info0.Name != "search_my_dateset" {
		t.Errorf("tools[0].Info().Name = %q, want search_my_dateset", info0.Name)
	}
	info1, err := tools[1].Info(ctx)
	if err != nil {
		t.Fatalf("tools[1].Info: %v", err)
	}
	if info1.Name != "wikipedia_search" {
		t.Errorf("tools[1].Info().Name = %q, want wikipedia_search", info1.Name)
	}
}

func TestBuildAll_UnknownTool(t *testing.T) {
	_, err := BuildAll([]string{"does_not_exist"}, nil)
	if err == nil {
		t.Fatal("expected error for unknown tool")
	}
	if !strings.Contains(err.Error(), `unsupported tool "does_not_exist"`) {
		t.Fatalf("err = %q, want unsupported tool message", err.Error())
	}
}

func TestBuildByName_CanvasComponentNames(t *testing.T) {
	tests := []struct {
		name         string
		wantToolName string
	}{
		{name: "CodeExec", wantToolName: "execute_code"},
		{name: "GoogleScholar", wantToolName: "google_scholar_search"},
		{name: "KeenableSearch", wantToolName: "keenable_search"},
		{name: "QueritContents", wantToolName: "querit_contents"},
		{name: "QueritSearch", wantToolName: "querit_search"},
		{name: "Search1APICrawl", wantToolName: "search1api_crawl"},
		{name: "Search1APISearch", wantToolName: "search1api_search"},
		{name: "SofyaSearch", wantToolName: "sofya_search"},
		{name: "TavilyExtract", wantToolName: "tavily_extract"},
		{name: "TavilySearch", wantToolName: "tavily_search"},
		{name: "YahooFinance", wantToolName: "yahoo_finance"},
		{name: "YouComSearch", wantToolName: "youcom_search"},
	}

	for _, tc := range tests {
		t.Run(tc.name, func(t *testing.T) {
			built, err := BuildByName(tc.name, nil)
			if err != nil {
				t.Fatalf("BuildByName(%q): %v", tc.name, err)
			}
			info, err := built.Info(t.Context())
			if err != nil {
				t.Fatalf("BuildByName(%q).Info: %v", tc.name, err)
			}
			if info.Name != tc.wantToolName {
				t.Errorf("BuildByName(%q).Info().Name = %q, want %q", tc.name, info.Name, tc.wantToolName)
			}
		})
	}
}

func TestBuildAll_CanvasComponentNameUsesCanonicalParams(t *testing.T) {
	for _, tc := range []struct {
		name      string
		paramsKey string
		topN      int
	}{
		{name: "canonical key", paramsKey: "google_scholar", topN: 7},
		{name: "canvas key", paramsKey: "googlescholar", topN: 9},
	} {
		t.Run(tc.name, func(t *testing.T) {
			tools, err := BuildAll(
				[]string{"GoogleScholar"},
				map[string]map[string]any{
					tc.paramsKey: {"top_n": tc.topN},
				},
			)
			if err != nil {
				t.Fatalf("BuildAll: %v", err)
			}
			if len(tools) != 1 {
				t.Fatalf("len(tools) = %d, want 1", len(tools))
			}
			scholar, ok := tools[0].(*GoogleScholarTool)
			if !ok {
				t.Fatalf("tools[0] = %T, want *GoogleScholarTool", tools[0])
			}
			if scholar.defaults.TopN != tc.topN {
				t.Errorf("GoogleScholar defaults.TopN = %d, want %d", scholar.defaults.TopN, tc.topN)
			}
		})
	}
}

// TestBuildByName_FunctionNameCollisionPrefersComponentName asserts that a
// Retrieval node whose DSL function_name happens to match a registered tool
// (e.g., "wikipedia") still builds the retrieval tool, not the registered one.
// The retrieval tool advertises the DSL function_name as its agent-visible name.
func TestBuildByName_FunctionNameCollisionPrefersComponentName(t *testing.T) {
	built, err := BuildByName("wikipedia", map[string]any{
		"component_name": "Retrieval",
		"function_name":  "wikipedia",
	})
	if err != nil {
		t.Fatalf("BuildByName: %v", err)
	}
	info, err := built.Info(t.Context())
	if err != nil {
		t.Fatalf("Info: %v", err)
	}
	if info.Name != "wikipedia" {
		t.Errorf("tool name = %q, want retrieval advertised as the DSL function_name (collision must not build Wikipedia)", info.Name)
	}
}

func TestBuildByName_QueritAliases(t *testing.T) {
	for _, name := range []string{"querit", "querit_search", "queritsearch", "QueritSearch"} {
		built, err := BuildByName(name, map[string]any{
			"api_key":          "stored-key",
			"count":            float64(8),
			"chunks_per_doc":   float64(2),
			"site_include":     []any{"example.com"},
			"site_exclude":     []string{"blocked.example"},
			"time_range":       "d7",
			"country_include":  []any{"CN"},
			"language_include": []any{"zh"},
			"outputs":          map[string]any{"json": map[string]any{}},
		})
		if err != nil {
			t.Fatalf("BuildByName(%q): %v", name, err)
		}
		querit, ok := built.(*QueritTool)
		if !ok {
			t.Fatalf("BuildByName(%q) returned %T, want *QueritTool", name, built)
		}
		if querit.defaults.Count != 8 || querit.defaults.ChunksPerDoc == nil || *querit.defaults.ChunksPerDoc != 2 || len(querit.defaults.SiteInclude) != 1 {
			t.Fatalf("BuildByName(%q) defaults = %#v", name, querit.defaults)
		}
		info, infoErr := built.Info(t.Context())
		if infoErr != nil || info.Name != "querit_search" {
			t.Fatalf("BuildByName(%q).Info() = %#v, %v", name, info, infoErr)
		}
	}
}

func TestBuildByName_QueritContentsAliases(t *testing.T) {
	for _, name := range []string{"querit_contents", "queritcontents", "QueritContents"} {
		built, err := BuildByName(name, map[string]any{
			"api_key":       "stored-key",
			"format":        "html",
			"crawl_timeout": float64(20),
			"extras_meta":   true,
		})
		if err != nil {
			t.Fatalf("BuildByName(%q): %v", name, err)
		}
		contents, ok := built.(*QueritContentsTool)
		if !ok {
			t.Fatalf("BuildByName(%q) returned %T, want *QueritContentsTool", name, built)
		}
		if contents.defaults.Format != "html" || contents.defaults.CrawlTimeout != 20 || !contents.defaults.ExtrasMeta {
			t.Fatalf("BuildByName(%q) defaults = %#v", name, contents.defaults)
		}
	}
}

func TestBuildByName_QueritContentsEmptyTimeoutUsesDefault(t *testing.T) {
	for _, value := range []string{"", "  "} {
		built, err := BuildByName("querit_contents", map[string]any{
			"crawl_timeout": value,
		})
		if err != nil {
			t.Fatalf("BuildByName with empty crawl_timeout %q: %v", value, err)
		}
		contents, ok := built.(*QueritContentsTool)
		if !ok {
			t.Fatalf("BuildByName returned %T, want *QueritContentsTool", built)
		}
		if contents.defaults.CrawlTimeout != 10 {
			t.Fatalf("crawl timeout = %d, want default 10", contents.defaults.CrawlTimeout)
		}
	}
}

func TestBuildByName_YouComReadsCanvasParams(t *testing.T) {
	// The canvas stores tool params under the lower-cased component name, and
	// the node form also carries query/outputs keys the tool must ignore.
	tools, err := BuildAll([]string{"YouComSearch"}, map[string]map[string]any{
		"youcomsearch": {
			"api_key":   "stored-key",
			"freshness": "week",
			"top_n":     float64(4),
			"outputs":   map[string]any{"json": map[string]any{}},
		},
	})
	if err != nil {
		t.Fatalf("BuildAll: %v", err)
	}
	if len(tools) != 1 {
		t.Fatalf("len(tools) = %d, want 1", len(tools))
	}
	youcomTool, ok := tools[0].(*YouComTool)
	if !ok {
		t.Fatalf("tools[0] = %T, want *YouComTool", tools[0])
	}
	if youcomTool.apiKey != "stored-key" || youcomTool.defaults.Freshness != "week" || youcomTool.defaults.TopN != 4 {
		t.Fatalf("defaults = %#v, apiKey = %q", youcomTool.defaults, youcomTool.apiKey)
	}
	info, infoErr := youcomTool.Info(t.Context())
	if infoErr != nil || info.Name != "youcom_search" {
		t.Fatalf("Info() = %#v, %v", info, infoErr)
	}
}

func TestBuildAll_AllRegisteredTools(t *testing.T) {
	// Every key in registry.
	names := []string{
		"akshare", "arxiv", "bgpt", "code_exec", "crawler", "deepl",
		"duckduckgo", "email", "exesql", "execute_sql", "github", "google",
		"google_scholar", "google_scholar_search", "jin10", "keenable", "pubmed", "qweather",
		"querit", "querit_contents", "querit_search",
		"retrieval", "search_my_dataset", "search_my_dateset", "search1api", "search1api_crawl", "searxng", "sofya",
		"tavily", "tavily_extract", "tushare", "web_crawler", "wencai", "wikipedia", "wikipedia_search",
		"yahoo_finance", "youcom",
	}
	params := map[string]map[string]any{
		"execute_sql": {
			"db_type":     "mysql",
			"host":        "127.0.0.1",
			"port":        3306,
			"database":    "demo",
			"username":    "u",
			"password":    "p",
			"max_records": 10,
		},
		"exesql": {
			"db_type":     "mysql",
			"host":        "127.0.0.1",
			"port":        3306,
			"database":    "demo",
			"username":    "u",
			"password":    "p",
			"max_records": 10,
		},
		"keenable": {
			"api_key": "key-test",
		},
	}
	tools, err := BuildAll(names, params)
	if err != nil {
		t.Fatalf("BuildAll(all registered): %v", err)
	}
	if len(tools) != len(names) {
		t.Fatalf("len(tools) = %d, want %d", len(tools), len(names))
	}
}

// TestBuildTushareTool_NodeParams pins the node-level credential channel:
// the token comes from tool_params, an empty set still builds (Invoke reports
// the missing configuration), and a non-string token is rejected.
func TestBuildTushareTool_NodeParams(t *testing.T) {
	t.Parallel()

	built, err := BuildByName("tushare", map[string]any{"token": "T-node"})
	if err != nil {
		t.Fatalf("BuildByName(tushare) with token: %v", err)
	}
	tool, ok := built.(*TushareTool)
	if !ok {
		t.Fatalf("tool type = %T, want *TushareTool", built)
	}
	if tool.defaults.Token != "T-node" {
		t.Fatalf("defaults.Token = %q, want T-node", tool.defaults.Token)
	}

	if _, err = BuildByName("tushare", map[string]any{}); err != nil {
		t.Fatalf("BuildByName(tushare) without params: %v", err)
	}

	if _, err = BuildByName("tushare", map[string]any{"token": 1}); err == nil {
		t.Fatal("expected a type error for a non-string token")
	} else if !strings.Contains(err.Error(), "string node-level param token") {
		t.Fatalf("err = %q, want the node-level token type error", err.Error())
	}
}

func TestBuildAll_ExeSQLRequiresNodeParams(t *testing.T) {
	_, err := BuildAll([]string{"execute_sql"}, nil)
	if err == nil {
		t.Fatal("expected execute_sql config error")
	}
	if !strings.Contains(err.Error(), "execute_sql requires node-level params") {
		t.Fatalf("err = %q, want execute_sql config error", err.Error())
	}
}

// TestToolRegistry_SchemasAreComplete sweeps every name the public
// registry advertises (including the execute_sql/exesql and
// retrieval/search_my_dateset alias pairs), builds the tool, and
// asserts that its Info() returns a complete schema — non-empty
// Name and Desc, non-nil ParamsOneOf, and a consistent canonical
// name across alias entries. Catches drift like "tool renamed but
// registry not updated", "param added but schema not updated",
// "tool registered with empty description", and "alias points to
// the wrong canonical name".
func TestToolRegistry_SchemasAreComplete(t *testing.T) {
	t.Parallel()

	// Every entry the registry advertises.
	names := []string{
		"akshare", "arxiv", "bgpt", "code_exec", "crawler", "deepl",
		"duckduckgo", "email", "execute_sql", "exesql", "github", "google",
		"google_scholar", "google_scholar_search", "jin10", "keenable", "pubmed", "qweather",
		"querit", "querit_contents", "querit_search",
		"retrieval", "search_my_dataset", "search_my_dateset", "search1api", "search1api_crawl", "searxng", "sofya",
		"tavily", "tavily_extract", "tushare", "web_crawler", "wencai", "wikipedia", "wikipedia_search",
		"yahoo_finance", "youcom",
	}
	params := map[string]map[string]any{
		"execute_sql": {
			"db_type":     "mysql",
			"host":        "127.0.0.1",
			"port":        3306,
			"database":    "demo",
			"username":    "u",
			"password":    "p",
			"max_records": 10,
		},
		"exesql": {
			"db_type":     "mysql",
			"host":        "127.0.0.1",
			"port":        3306,
			"database":    "demo",
			"username":    "u",
			"password":    "p",
			"max_records": 10,
		},
		"keenable": {
			"api_key": "key-xyz",
		},
	}
	tools, err := BuildAll(names, params)
	if err != nil {
		t.Fatalf("BuildAll(%d names): %v", len(names), err)
	}
	if len(tools) != len(names) {
		t.Fatalf("BuildAll returned %d tools for %d names", len(tools), len(names))
	}

	// Schema-level checks per entry.
	for i, name := range names {
		info, err := tools[i].Info(t.Context())
		if err != nil {
			t.Errorf("tools[%d] (registry name %q).Info: %v", i, name, err)
			continue
		}
		if info.Name == "" {
			t.Errorf("tools[%d] (registry name %q).Info().Name is empty", i, name)
		}
		if info.Desc == "" {
			t.Errorf("tools[%d] (registry name %q).Info().Desc is empty", i, name)
		}
		if info.ParamsOneOf == nil {
			t.Errorf("tools[%d] (registry name %q).Info().ParamsOneOf is nil", i, name)
		}
	}

	// Alias consistency: execute_sql and exesql must surface the
	// same canonical Info().Name; same for retrieval/search_my_dataset/
	// search_my_dataset and crawler/web_crawler. A bug here would mean
	// an alias was accidentally pointed at a different tool.
	canonicalByAlias := map[string]string{
		"execute_sql":           "execute_sql",
		"exesql":                "execute_sql",
		"google_scholar":        "google_scholar_search",
		"google_scholar_search": "google_scholar_search",
		"retrieval":             "search_my_dateset",
		"search_my_dataset":     "search_my_dateset",
		"search_my_dateset":     "search_my_dateset",
		"crawler":               "web_crawler",
		"web_crawler":           "web_crawler",
		"wikipedia":             "wikipedia_search",
		"wikipedia_search":      "wikipedia_search",
		"querit":                "querit_search",
		"querit_contents":       "querit_contents",
		"querit_search":         "querit_search",
	}
	for _, name := range names {
		canonical, ok := canonicalByAlias[name]
		if !ok {
			continue
		}
		idx := indexOf(names, name)
		info, err := tools[idx].Info(t.Context())
		if err != nil {
			continue
		}
		if info.Name != canonical {
			t.Errorf("registry name %q: Info().Name = %q, want %q (alias must surface canonical name)",
				name, info.Name, canonical)
		}
	}
}

// indexOf returns the index of s in xs, or -1 if not present.
// Tiny helper to keep the alias loop above free of a slice lookup
// closure; the test's names slice is <30 items so linear scan is
// fine.
func indexOf(xs []string, s string) int {
	for i, x := range xs {
		if x == s {
			return i
		}
	}
	return -1
}