package assistant import ( "fmt" "path" "strings" "github.com/yaoapp/gou/fs" "github.com/yaoapp/yao/agent/caller" agentContext "github.com/yaoapp/yao/agent/context" "github.com/yaoapp/yao/agent/i18n" "github.com/yaoapp/yao/agent/llm" "github.com/yaoapp/yao/agent/search" searchTypes "github.com/yaoapp/yao/agent/search/types" store "github.com/yaoapp/yao/agent/store/types" "github.com/yaoapp/yao/openapi/utils" sui "github.com/yaoapp/yao/sui/core" ) func init() { // Initialize AgentGetterFunc to allow content and search packages to call agents caller.AgentGetterFunc = func(agentID string) (caller.AgentCaller, error) { ast, err := Get(agentID) if err != nil { return nil, err } // Return a wrapper that implements AgentCaller interface return &agentCallerWrapper{ast: ast}, nil } // Initialize AssistantReloadFunc for hot-reload after deploy caller.AssistantReloadFunc = func(id string) error { p := "/assistants/" + strings.Replace(id, ".", "/", 1) ast, err := LoadPath(p) if err != nil { return err } ast.BuiltIn = true ast.Readonly = true if ast.Tags == nil { ast.Tags = []string{} } if err := ast.Save(); err != nil { return err } if err := ast.initialize(); err != nil { return err } loaded.Put(ast) return nil } // Initialize Agent JSAPI factory for ctx.agent.* methods caller.SetJSAPIFactory() // Initialize LLM JSAPI factory for ctx.llm.* methods llm.SetJSAPIFactory() // Initialize Search JSAPI factory with config getter search.SetJSAPIFactory(func(assistantID string) (*searchTypes.Config, *search.Uses) { ast, err := Get(assistantID) if err != nil || ast == nil { return nil, nil } // Convert assistant.Uses to search.Uses var uses *search.Uses if ast.Uses != nil { uses = &search.Uses{ Search: ast.Uses.Search, Web: ast.Uses.Web, Keyword: ast.Uses.Keyword, QueryDSL: ast.Uses.QueryDSL, Rerank: ast.Uses.Rerank, } } return ast.Search, uses }) } // agentCallerWrapper wraps Assistant to implement AgentCaller interface type agentCallerWrapper struct { ast *Assistant } func (w *agentCallerWrapper) Stream(ctx *agentContext.Context, messages []agentContext.Message, options ...*agentContext.Options) (*agentContext.Response, error) { return w.ast.Stream(ctx, messages, options...) } // Get get the assistant by id func Get(id string) (*Assistant, error) { return LoadStore(id) } // GetPlaceholder returns the placeholder of the assistant func (ast *Assistant) GetPlaceholder(locale string) *store.Placeholder { prompts := []string{} if ast.Placeholder.Prompts != nil { prompts = i18n.Translate(ast.ID, locale, ast.Placeholder.Prompts).([]string) } title := i18n.Translate(ast.ID, locale, ast.Placeholder.Title).(string) description := i18n.Translate(ast.ID, locale, ast.Placeholder.Description).(string) return &store.Placeholder{ Title: title, Description: description, Prompts: prompts, } } // GetName returns the name of the assistant func (ast *Assistant) GetName(locale string) string { return i18n.Translate(ast.ID, locale, ast.Name).(string) } // GetDescription returns the description of the assistant func (ast *Assistant) GetDescription(locale string) string { return i18n.Translate(ast.ID, locale, ast.Description).(string) } // Save save the assistant func (ast *Assistant) Save() error { if storage == nil { return fmt.Errorf("storage is not set") } _, err := storage.SaveAssistant(&ast.AssistantModel) if err != nil { return err } return nil } // Map convert the assistant to a map func (ast *Assistant) Map() map[string]interface{} { if ast == nil { return nil } return map[string]interface{}{ "assistant_id": ast.ID, "type": ast.Type, "name": ast.Name, "readonly": ast.Readonly, "public": ast.Public, "share": ast.Share, "avatar": ast.Avatar, "connector": ast.Connector, "connector_options": ast.ConnectorOptions, "path": ast.Path, "built_in": ast.BuiltIn, "sort": ast.Sort, "description": ast.Description, "options": ast.Options, "prompts": ast.Prompts, "prompt_presets": ast.PromptPresets, "disable_global_prompts": ast.DisableGlobalPrompts, "source": ast.Source, "kb": ast.KB, "db": ast.DB, "mcp": ast.MCP, "workflow": ast.Workflow, "tags": ast.Tags, "modes": ast.Modes, "default_mode": ast.DefaultMode, "mentionable": ast.Mentionable, "automated": ast.Automated, "placeholder": ast.Placeholder, "locales": ast.Locales, "uses": ast.Uses, "search": ast.Search, "dependencies": ast.Dependencies, "created_at": utils.NanoToTime(ast.CreatedAt), "updated_at": utils.NanoToTime(ast.UpdatedAt), } } // Validate validates the assistant configuration func (ast *Assistant) Validate() error { if ast.ID == "" { return fmt.Errorf("assistant_id is required") } if ast.Name == "" { return fmt.Errorf("name is required") } return nil } // Assets get the assets content func (ast *Assistant) Assets(name string, data sui.Data) (string, error) { app, err := fs.Get("app") if err != nil { return "", err } root := path.Join(ast.Path, "assets", name) raw, err := app.ReadFile(root) if err != nil { return "", err } if data != nil { content, _ := data.Replace(string(raw)) return content, nil } return string(raw), nil } // Clone creates a deep copy of the assistant func (ast *Assistant) Clone() *Assistant { if ast == nil { return nil } clone := &Assistant{ AssistantModel: store.AssistantModel{ ID: ast.ID, Type: ast.Type, Name: ast.Name, Avatar: ast.Avatar, Connector: ast.Connector, Path: ast.Path, BuiltIn: ast.BuiltIn, Sort: ast.Sort, Description: ast.Description, Readonly: ast.Readonly, Public: ast.Public, Share: ast.Share, Mentionable: ast.Mentionable, Automated: ast.Automated, DisableGlobalPrompts: ast.DisableGlobalPrompts, Source: ast.Source, CreatedAt: ast.CreatedAt, UpdatedAt: ast.UpdatedAt, }, HookScript: ast.HookScript, } // Deep copy tags if ast.Tags != nil { clone.Tags = make([]string, len(ast.Tags)) copy(clone.Tags, ast.Tags) } // Deep copy modes if ast.Modes != nil { clone.Modes = make([]string, len(ast.Modes)) copy(clone.Modes, ast.Modes) } // Copy default_mode (simple string) clone.DefaultMode = ast.DefaultMode // Deep copy KB if ast.KB != nil { clone.KB = &store.KnowledgeBase{} if ast.KB.Collections != nil { clone.KB.Collections = make([]string, len(ast.KB.Collections)) copy(clone.KB.Collections, ast.KB.Collections) } if ast.KB.Options != nil { clone.KB.Options = make(map[string]interface{}) for k, v := range ast.KB.Options { clone.KB.Options[k] = v } } } // Deep copy DB if ast.DB != nil { clone.DB = &store.Database{} if ast.DB.Models != nil { clone.DB.Models = make([]string, len(ast.DB.Models)) copy(clone.DB.Models, ast.DB.Models) } if ast.DB.Options != nil { clone.DB.Options = make(map[string]interface{}) for k, v := range ast.DB.Options { clone.DB.Options[k] = v } } } // Deep copy MCP if ast.MCP != nil { clone.MCP = &store.MCPServers{} if ast.MCP.Servers != nil { clone.MCP.Servers = make([]store.MCPServerConfig, len(ast.MCP.Servers)) for i, server := range ast.MCP.Servers { clone.MCP.Servers[i] = store.MCPServerConfig{ ServerID: server.ServerID, } // Deep copy Resources slice if server.Resources != nil { clone.MCP.Servers[i].Resources = make([]string, len(server.Resources)) copy(clone.MCP.Servers[i].Resources, server.Resources) } // Deep copy Tools slice if server.Tools != nil { clone.MCP.Servers[i].Tools = make([]string, len(server.Tools)) copy(clone.MCP.Servers[i].Tools, server.Tools) } } } if ast.MCP.Options != nil { clone.MCP.Options = make(map[string]interface{}) for k, v := range ast.MCP.Options { clone.MCP.Options[k] = v } } } // Deep copy options if ast.Options != nil { clone.Options = make(map[string]interface{}) for k, v := range ast.Options { clone.Options[k] = v } } // Deep copy prompts if ast.Prompts != nil { clone.Prompts = make([]store.Prompt, len(ast.Prompts)) copy(clone.Prompts, ast.Prompts) } // Deep copy prompt presets if ast.PromptPresets != nil { clone.PromptPresets = make(map[string][]store.Prompt) for k, v := range ast.PromptPresets { prompts := make([]store.Prompt, len(v)) copy(prompts, v) clone.PromptPresets[k] = prompts } } // Deep copy connector options if ast.ConnectorOptions != nil { clone.ConnectorOptions = &store.ConnectorOptions{ Optional: ast.ConnectorOptions.Optional, } if ast.ConnectorOptions.Connectors != nil { clone.ConnectorOptions.Connectors = make([]string, len(ast.ConnectorOptions.Connectors)) copy(clone.ConnectorOptions.Connectors, ast.ConnectorOptions.Connectors) } if ast.ConnectorOptions.Filters != nil { clone.ConnectorOptions.Filters = make([]store.ModelCapability, len(ast.ConnectorOptions.Filters)) copy(clone.ConnectorOptions.Filters, ast.ConnectorOptions.Filters) } } // Deep copy workflow if ast.Workflow != nil { clone.Workflow = &store.Workflow{} if ast.Workflow.Workflows != nil { clone.Workflow.Workflows = make([]string, len(ast.Workflow.Workflows)) copy(clone.Workflow.Workflows, ast.Workflow.Workflows) } if ast.Workflow.Options != nil { clone.Workflow.Options = make(map[string]interface{}) for k, v := range ast.Workflow.Options { clone.Workflow.Options[k] = v } } } // Deep copy placeholder if ast.Placeholder != nil { clone.Placeholder = &store.Placeholder{ Title: ast.Placeholder.Title, Description: ast.Placeholder.Description, } if ast.Placeholder.Prompts != nil { clone.Placeholder.Prompts = make([]string, len(ast.Placeholder.Prompts)) copy(clone.Placeholder.Prompts, ast.Placeholder.Prompts) } } // Deep copy locales if ast.Locales != nil { clone.Locales = make(i18n.Map) for k, v := range ast.Locales { // Deep copy messages messages := make(map[string]any) if v.Messages != nil { for mk, mv := range v.Messages { messages[mk] = mv } } clone.Locales[k] = i18n.I18n{ Locale: v.Locale, Messages: messages, } } } // Deep copy uses if ast.Uses != nil { clone.Uses = &agentContext.Uses{ Vision: ast.Uses.Vision, Audio: ast.Uses.Audio, Search: ast.Uses.Search, Fetch: ast.Uses.Fetch, Web: ast.Uses.Web, Keyword: ast.Uses.Keyword, QueryDSL: ast.Uses.QueryDSL, Rerank: ast.Uses.Rerank, } } // Deep copy search config if ast.Search != nil { clone.Search = &searchTypes.Config{} if ast.Search.Web != nil { clone.Search.Web = &searchTypes.WebConfig{ Provider: ast.Search.Web.Provider, APIKeyEnv: ast.Search.Web.APIKeyEnv, MaxResults: ast.Search.Web.MaxResults, } } if ast.Search.KB != nil { clone.Search.KB = &searchTypes.KBConfig{ Threshold: ast.Search.KB.Threshold, Graph: ast.Search.KB.Graph, } if ast.Search.KB.Collections != nil { clone.Search.KB.Collections = make([]string, len(ast.Search.KB.Collections)) copy(clone.Search.KB.Collections, ast.Search.KB.Collections) } } if ast.Search.DB != nil { clone.Search.DB = &searchTypes.DBConfig{ MaxResults: ast.Search.DB.MaxResults, } if ast.Search.DB.Models != nil { clone.Search.DB.Models = make([]string, len(ast.Search.DB.Models)) copy(clone.Search.DB.Models, ast.Search.DB.Models) } } if ast.Search.Keyword != nil { clone.Search.Keyword = &searchTypes.KeywordConfig{ MaxKeywords: ast.Search.Keyword.MaxKeywords, Language: ast.Search.Keyword.Language, } } if ast.Search.QueryDSL != nil { clone.Search.QueryDSL = &searchTypes.QueryDSLConfig{ Strict: ast.Search.QueryDSL.Strict, } } if ast.Search.Rerank != nil { clone.Search.Rerank = &searchTypes.RerankConfig{ TopN: ast.Search.Rerank.TopN, } } if ast.Search.Citation != nil { clone.Search.Citation = &searchTypes.CitationConfig{ Format: ast.Search.Citation.Format, AutoInjectPrompt: ast.Search.Citation.AutoInjectPrompt, CustomPrompt: ast.Search.Citation.CustomPrompt, } } if ast.Search.Weights != nil { clone.Search.Weights = &searchTypes.WeightsConfig{ User: ast.Search.Weights.User, Hook: ast.Search.Weights.Hook, Auto: ast.Search.Weights.Auto, } } if ast.Search.Options != nil { clone.Search.Options = &searchTypes.OptionsConfig{ SkipThreshold: ast.Search.Options.SkipThreshold, } } } // Deep copy dependencies if ast.Dependencies != nil { clone.Dependencies = make(map[string]string, len(ast.Dependencies)) for k, v := range ast.Dependencies { clone.Dependencies[k] = v } } return clone } // GetInfo returns the basic info of the assistant with optional locale func (ast *Assistant) GetInfo(locale ...string) *store.AssistantInfo { if ast == nil { return nil } loc := "" if len(locale) > 0 { loc = locale[0] } info := &store.AssistantInfo{ AssistantID: ast.ID, Avatar: ast.Avatar, Connector: ast.Connector, ConnectorOptions: ast.ConnectorOptions, Modes: ast.Modes, DefaultMode: ast.DefaultMode, Sandbox: ast.IsSandbox, ComputerFilter: ast.ComputerFilter, } if loc != "" { info.Name = ast.GetName(loc) info.Description = ast.GetDescription(loc) } else { info.Name = ast.Name info.Description = ast.Description } return info } // GetInfoByIDs retrieves basic info for multiple assistants by their IDs // Returns a map of assistant_id -> AssistantInfo func GetInfoByIDs(ids []string, locale ...string) map[string]*store.AssistantInfo { result := make(map[string]*store.AssistantInfo) if len(ids) == 0 { return result } for _, id := range ids { ast, err := Get(id) if err != nil || ast == nil { continue } result[id] = ast.GetInfo(locale...) } return result } // Update updates the assistant properties func (ast *Assistant) Update(data map[string]interface{}) error { if ast == nil { return fmt.Errorf("assistant is nil") } if v, ok := data["name"].(string); ok { ast.Name = v } if v, ok := data["avatar"].(string); ok { ast.Avatar = v } if v, ok := data["description"].(string); ok { ast.Description = v } if v, ok := data["connector"].(string); ok { ast.Connector = v } // Note: tools field is deprecated, now handled by MCP if v, ok := data["type"].(string); ok { ast.Type = v } if v, ok := data["sort"].(int); ok { ast.Sort = v } if v, ok := data["mentionable"].(bool); ok { ast.Mentionable = v } if v, ok := data["automated"].(bool); ok { ast.Automated = v } if v, ok := data["disable_global_prompts"].(bool); ok { ast.DisableGlobalPrompts = v } if v, ok := data["readonly"].(bool); ok { ast.Readonly = v } if v, ok := data["public"].(bool); ok { ast.Public = v } if v, ok := data["share"].(string); ok { ast.Share = v } if v, ok := data["tags"].([]string); ok { ast.Tags = v } if v, ok := data["modes"].([]string); ok { ast.Modes = v } if v, ok := data["default_mode"].(string); ok { ast.DefaultMode = v } if v, ok := data["options"].(map[string]interface{}); ok { ast.Options = v } if v, ok := data["source"].(string); ok { ast.Source = v } // ConnectorOptions if v, has := data["connector_options"]; has { connOpts, err := store.ToConnectorOptions(v) if err != nil { return err } ast.ConnectorOptions = connOpts } // PromptPresets if v, has := data["prompt_presets"]; has { presets, err := store.ToPromptPresets(v) if err != nil { return err } ast.PromptPresets = presets } // KB if v, has := data["kb"]; has { kb, err := store.ToKnowledgeBase(v) if err != nil { return err } ast.KB = kb } // DB if v, has := data["db"]; has { db, err := store.ToDatabase(v) if err != nil { return err } ast.DB = db } // MCP if v, has := data["mcp"]; has { mcp, err := store.ToMCPServers(v) if err != nil { return err } ast.MCP = mcp } // Workflow if v, has := data["workflow"]; has { workflow, err := store.ToWorkflow(v) if err != nil { return err } ast.Workflow = workflow } // Uses if v, has := data["uses"]; has { uses, err := store.ToUses(v) if err != nil { return err } ast.Uses = uses } // Search if v, has := data["search"]; has { search, err := store.ToSearchConfig(v) if err != nil { return err } ast.Search = search } // Dependencies if v, has := data["dependencies"]; has { if v == nil { ast.Dependencies = nil } else { switch d := v.(type) { case map[string]string: ast.Dependencies = d case map[string]interface{}: deps := make(map[string]string, len(d)) for k, val := range d { if s, ok := val.(string); ok { deps[k] = s } } ast.Dependencies = deps } } } return ast.Validate() } // GetMergedSearchConfig returns the search config for this assistant // Note: The config is already merged with global config during loading (loadMap) func (ast *Assistant) GetMergedSearchConfig() *searchTypes.Config { return ast.Search }