yao/agent/assistant/assistant.go
Max 1a5e1db2ec refactor(time): enhance timestamp handling with utility functions
- Introduced NanoToTime and TimeToNano functions for converting between UnixNano and time.Time, improving clarity and consistency in timestamp management.
- Updated Assistant model to utilize the new utility functions for created_at and updated_at fields.
- Refactored Xun store methods to ensure UTC compatibility for timestamp serialization across different database drivers.
- Added unit tests for the new conversion functions to validate their correctness and behavior.
2026-04-06 11:21:12 +08:00

684 lines
17 KiB
Go

package assistant
import (
"fmt"
"path"
"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 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")
}
if ast.Connector == "" {
return fmt.Errorf("connector 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
}