feat: Enhance Kol Generation Service with web search and knowledge group support

- Added `EnableWebSearch` and `KnowledgeGroupIDs` fields to `KolGenerationSubmitRequest`.
- Updated `Submit` method in `KolGenerationService` to handle new request fields.
- Integrated web search and knowledge group validation based on card configuration.
- Introduced caching mechanisms in `KolPackageService`, `KolPromptService`, and `KolSubscriptionAdminService` to improve performance.
- Implemented knowledge context resolution in `KolGenerationWorker` to enrich prompts with relevant knowledge snippets.
- Added utility functions for handling card configuration in both backend and frontend.
- Created tests for knowledge extraction and rendering to ensure accuracy and reliability.

server/internal/tenant/app/kol_generation_service.go

@@ -23,7 +23,9 @@ const (
 var ErrKolGenerationForbidden = response.ErrForbidden(40373, "kol_generation_forbidden", "subscription prompt is not available")
 
 type KolGenerationSubmitRequest struct {
-	Variables map[string]any `json:"variables"`
+	Variables         map[string]any `json:"variables"`
+	EnableWebSearch   bool           `json:"enable_web_search"`
+	KnowledgeGroupIDs []int64        `json:"knowledge_group_ids"`
 }
 
 type KolGenerationSubmitResponse struct {
@@ -48,8 +50,12 @@ type kolGenerationTaskInput struct {
 	SubscriptionID       int64           `json:"subscription_id"`
 	PackageID            int64           `json:"package_id"`
 	PromptID             int64           `json:"prompt_id"`
+	PromptName           string          `json:"prompt_name"`
+	PlatformHint         string          `json:"platform_hint"`
 	PromptRevisionNo     int             `json:"prompt_revision_no"`
 	Variables            map[string]any  `json:"variables"`
+	EnableWebSearch      bool            `json:"enable_web_search"`
+	KnowledgeGroupIDs    []int64         `json:"knowledge_group_ids"`
 	SchemaSnapshot       json.RawMessage `json:"schema_snapshot"`
 	CardConfigSnapshot   json.RawMessage `json:"card_config_snapshot"`
 	RenderedPromptHash   string          `json:"rendered_prompt_hash"`
@@ -125,12 +131,13 @@ func (s *KolGenerationService) GetSchema(ctx context.Context, actor auth.Actor,
 	}, nil
 }
 
-func (s *KolGenerationService) Submit(ctx context.Context, actor auth.Actor, subPromptID int64, variables map[string]any) (*KolGenerationSubmitResponse, error) {
+func (s *KolGenerationService) Submit(ctx context.Context, actor auth.Actor, subPromptID int64, req KolGenerationSubmitRequest) (*KolGenerationSubmitResponse, error) {
 	row, prompt, err := s.loadAuthorizedPrompt(ctx, actor, subPromptID)
 	if err != nil {
 		return nil, err
 	}
 
+	variables := req.Variables
 	if variables == nil {
 		variables = map[string]any{}
 	}
@@ -139,6 +146,10 @@ func (s *KolGenerationService) Submit(ctx context.Context, actor auth.Actor, sub
 	if err != nil {
 		return nil, response.ErrInternal(50096, "kol_generation_schema_decode_failed", err.Error())
 	}
+	cardConfig, err := decodeKolCardConfig(prompt.CardConfigJSON)
+	if err != nil {
+		return nil, response.ErrInternal(50097, "kol_generation_card_config_decode_failed", err.Error())
+	}
 
 	if prompt.PromptAssetKey == nil || *prompt.PromptAssetKey == "" {
 		return nil, response.ErrInternal(50098, "kol_generation_prompt_asset_missing", "published prompt content not found")
@@ -154,6 +165,16 @@ func (s *KolGenerationService) Submit(ctx context.Context, actor auth.Actor, sub
 		return nil, response.ErrBadRequest(40071, "kol_generation_variables_invalid", err.Error())
 	}
 	renderedPromptHash := HashPrompt(renderedPrompt)
+	if req.EnableWebSearch && !kolCardConfigAllowsWebSearch(cardConfig) {
+		return nil, response.ErrBadRequest(40073, "kol_generation_web_search_disabled", "web search is disabled for this prompt")
+	}
+
+	knowledgeGroupIDs := normalizeInt64IDs(req.KnowledgeGroupIDs)
+	if len(knowledgeGroupIDs) > 0 && !kolCardConfigAllowsUserKnowledge(cardConfig) {
+		return nil, response.ErrBadRequest(40074, "kol_generation_knowledge_disabled", "knowledge selection is disabled for this prompt")
+	}
+
+	enableWebSearch := kolCardConfigAllowsWebSearch(cardConfig) && req.EnableWebSearch
 	promptRevisionNo := 1
 	if row.PublishedRevisionNo != nil && *row.PublishedRevisionNo > 0 {
 		promptRevisionNo = *row.PublishedRevisionNo
@@ -169,8 +190,12 @@ func (s *KolGenerationService) Submit(ctx context.Context, actor auth.Actor, sub
 		SubscriptionID:       row.SubscriptionID,
 		PackageID:            row.PackageID,
 		PromptID:             row.PromptID,
+		PromptName:           row.PromptName,
+		PlatformHint:         derefString(row.PlatformHint),
 		PromptRevisionNo:     promptRevisionNo,
 		Variables:            variables,
+		EnableWebSearch:      enableWebSearch,
+		KnowledgeGroupIDs:    knowledgeGroupIDs,
 		SchemaSnapshot:       json.RawMessage(prompt.SchemaJSON),
 		CardConfigSnapshot:   json.RawMessage(prompt.CardConfigJSON),
 		RenderedPromptHash:   renderedPromptHash,