-
-
- 参考片段:
- {{ data.chunk_id }}
-
-
- 关系类型:
- {{ relationTypeLabel }}
-
-
- 相关片段数:
- {{ data.count }} 个
-
-
-
-
@@ -53,29 +39,12 @@
+
diff --git a/frontend/src/views/chat/components/tool-results/tool-results.less b/frontend/src/views/chat/components/tool-results/tool-results.less
index 7188fcef..de2e535e 100644
--- a/frontend/src/views/chat/components/tool-results/tool-results.less
+++ b/frontend/src/views/chat/components/tool-results/tool-results.less
@@ -70,16 +70,17 @@
// Result card
.result-card {
- background: @card-bg;
+ background: #ffffff;
border: 1px solid @card-border;
border-radius: @card-radius;
- margin-bottom: 8px;
+ margin-bottom: 0;
overflow: hidden;
transition: all @transition-time ease;
+ box-shadow: 0 1px 2px rgba(0, 0, 0, 0.04);
&:hover {
border-color: @card-hover-border;
- box-shadow: @card-shadow-hover;
+ box-shadow: 0 2px 8px rgba(7, 192, 95, 0.12);
}
}
@@ -91,10 +92,16 @@
align-items: center;
justify-content: space-between;
gap: 8px;
+ position: relative;
+ z-index: 1;
&:hover {
background: rgba(7, 192, 95, 0.05);
}
+
+ * {
+ pointer-events: none;
+ }
}
.result-title {
diff --git a/frontend/src/views/chat/index.vue b/frontend/src/views/chat/index.vue
index 24ba5a41..4c1394bd 100644
--- a/frontend/src/views/chat/index.vue
+++ b/frontend/src/views/chat/index.vue
@@ -19,7 +19,7 @@
sendMsg(query, modelId)"
@stop-generation="handleStopGeneration"
:isReplying="isReplying"
:sessionId="session_id"
@@ -259,7 +259,7 @@ const handleStopGeneration = () => {
// API 调用成功后,后端的 stop 事件会清空它
};
-const sendMsg = async (value) => {
+const sendMsg = async (value, modelId = '') => {
userquery.value = value;
isReplying.value = true;
loading.value = true;
@@ -291,6 +291,7 @@ const sendMsg = async (value) => {
session_id: session_id.value,
knowledge_base_ids: kbIds,
agent_enabled: agentEnabled,
+ summary_model_id: modelId,
query: value,
method: 'POST',
url: endpoint
@@ -431,7 +432,7 @@ onChunk((data) => {
})
// 处理 Agent 流式数据 (Cursor-style UI)
const handleAgentChunk = (data) => {
- const message = messagesList.findLast((item) => item.request_id === data.id || item.id === data.id);
+ let message = messagesList.findLast((item) => item.request_id === data.id || item.id === data.id);
if (!message) {
// 创建新的 Assistant 消息 - 此时开始显示内容,关闭 loading
@@ -450,7 +451,8 @@ const handleAgentChunk = (data) => {
messagesList.push(newMsg);
loading.value = false; // 消息已创建,关闭 loading
scrollToBottom();
- return;
+ // Don't return - continue to process the current event data
+ message = newMsg;
}
message.isAgentMode = true;
diff --git a/internal/agent/tools/todo_write.go b/internal/agent/tools/todo_write.go
index 648f38a3..daa5b331 100644
--- a/internal/agent/tools/todo_write.go
+++ b/internal/agent/tools/todo_write.go
@@ -4,6 +4,7 @@ import (
"context"
"encoding/json"
"fmt"
+ "strings"
"github.com/Tencent/WeKnora/internal/types"
)
@@ -16,10 +17,10 @@ type TodoWriteTool struct {
// PlanStep represents a single step in the research plan
type PlanStep struct {
- ID string `json:"id"`
- Description string `json:"description"`
- ToolsToUse string `json:"tools_to_use"`
- Status string `json:"status"` // pending, in_progress, completed, skipped
+ ID string `json:"id"`
+ Description string `json:"description"`
+ ToolsToUse []string `json:"tools_to_use"`
+ Status string `json:"status"` // pending, in_progress, completed, skipped
}
// NewTodoWriteTool creates a new todo_write tool instance
@@ -220,8 +221,11 @@ func (t *TodoWriteTool) Parameters() map[string]interface{} {
"description": "Clear description of what to investigate or accomplish in this step",
},
"tools_to_use": map[string]interface{}{
- "type": "string",
- "description": "Suggested tools for this step (e.g., 'knowledge_search', 'get_related_chunks')",
+ "type": "array",
+ "description": "Suggested tools for this step (e.g., ['knowledge_search', 'get_related_chunks'])",
+ "items": map[string]interface{}{
+ "type": "string",
+ },
},
"status": map[string]interface{}{
"type": "string",
@@ -252,7 +256,7 @@ func (t *TodoWriteTool) Execute(ctx context.Context, args map[string]interface{}
step := PlanStep{
ID: getStringField(stepMap, "id"),
Description: getStringField(stepMap, "description"),
- ToolsToUse: getStringField(stepMap, "tools_to_use"),
+ ToolsToUse: getStringArrayField(stepMap, "tools_to_use"),
Status: getStringField(stepMap, "status"),
}
planSteps = append(planSteps, step)
@@ -288,6 +292,24 @@ func getStringField(m map[string]interface{}, key string) string {
return ""
}
+// Helper function to safely get string array field from map
+func getStringArrayField(m map[string]interface{}, key string) []string {
+ if val, ok := m[key].([]interface{}); ok {
+ result := make([]string, 0, len(val))
+ for _, item := range val {
+ if str, ok := item.(string); ok {
+ result = append(result, str)
+ }
+ }
+ return result
+ }
+ // Handle legacy string format for backward compatibility
+ if val, ok := m[key].(string); ok && val != "" {
+ return []string{val}
+ }
+ return []string{}
+}
+
// generatePlanOutput generates a formatted plan output
func generatePlanOutput(task string, steps []PlanStep) string {
output := "计划已创建\n\n"
@@ -336,8 +358,8 @@ func formatPlanStep(index int, step PlanStep) string {
output := fmt.Sprintf(" %d. %s [%s] %s\n", index, emoji, step.Status, step.Description)
- if step.ToolsToUse != "" {
- output += fmt.Sprintf(" 工具: %s\n", step.ToolsToUse)
+ if len(step.ToolsToUse) > 0 {
+ output += fmt.Sprintf(" 工具: %s\n", strings.Join(step.ToolsToUse, ", "))
}
return output
diff --git a/internal/application/service/session.go b/internal/application/service/session.go
index 2d064deb..39a070b0 100644
--- a/internal/application/service/session.go
+++ b/internal/application/service/session.go
@@ -400,7 +400,7 @@ func (s *sessionService) GenerateTitleAsync(ctx context.Context, session *types.
// KnowledgeQA performs knowledge base question answering with LLM summarization
// Events are emitted through eventBus (references, answer chunks, completion)
-func (s *sessionService) KnowledgeQA(ctx context.Context, session *types.Session, query string, knowledgeBaseIDs []string, assistantMessageID string, eventBus *event.EventBus) error {
+func (s *sessionService) KnowledgeQA(ctx context.Context, session *types.Session, query string, knowledgeBaseIDs []string, assistantMessageID string, summaryModelID string, eventBus *event.EventBus) error {
logger.Infof(ctx, "Knowledge base question answering parameters, session ID: %s, query: %s", session.ID, query)
// If no knowledge base IDs provided, fall back to session's default
@@ -416,8 +416,8 @@ func (s *sessionService) KnowledgeQA(ctx context.Context, session *types.Session
logger.Infof(ctx, "Using knowledge bases: %v", knowledgeBaseIDs)
- // Determine chat model ID: prioritize Remote models
- chatModelID, err := s.selectChatModelID(ctx, session, knowledgeBaseIDs)
+ // Determine chat model ID: prioritize request's summaryModelID, then Remote models
+ chatModelID, err := s.selectChatModelIDWithOverride(ctx, session, knowledgeBaseIDs, summaryModelID)
if err != nil {
return err
}
@@ -491,6 +491,30 @@ func (s *sessionService) KnowledgeQA(ctx context.Context, session *types.Session
return nil
}
+// selectChatModelIDWithOverride selects the appropriate chat model ID with priority for request override
+// Priority order:
+// 1. Request's summaryModelID (if provided and valid)
+// 2. Session's SummaryModelID if it's a Remote model
+// 3. First knowledge base with a Remote model
+// 4. Session's SummaryModelID (if not Remote)
+// 5. First knowledge base's SummaryModelID
+func (s *sessionService) selectChatModelIDWithOverride(ctx context.Context, session *types.Session, knowledgeBaseIDs []string, summaryModelID string) (string, error) {
+ // First, check if request has summaryModelID override
+ if summaryModelID != "" {
+ // Validate that the model exists
+ model, err := s.modelService.GetModelByID(ctx, summaryModelID)
+ if err != nil {
+ logger.Warnf(ctx, "Request provided invalid summary model ID %s: %v, falling back to default selection", summaryModelID, err)
+ } else if model != nil {
+ logger.Infof(ctx, "Using request's summary model override: %s", summaryModelID)
+ return summaryModelID, nil
+ }
+ }
+
+ // If no valid override, use default selection logic
+ return s.selectChatModelID(ctx, session, knowledgeBaseIDs)
+}
+
// selectChatModelID selects the appropriate chat model ID with priority for Remote models
// Priority order:
// 1. Session's SummaryModelID if it's a Remote model
diff --git a/internal/container/container.go b/internal/container/container.go
index 6e347d9a..c2d30f60 100644
--- a/internal/container/container.go
+++ b/internal/container/container.go
@@ -34,6 +34,7 @@ import (
"github.com/Tencent/WeKnora/internal/config"
"github.com/Tencent/WeKnora/internal/event"
"github.com/Tencent/WeKnora/internal/handler"
+ "github.com/Tencent/WeKnora/internal/handler/session"
"github.com/Tencent/WeKnora/internal/logger"
"github.com/Tencent/WeKnora/internal/models/embedding"
"github.com/Tencent/WeKnora/internal/models/utils/ollama"
@@ -131,7 +132,7 @@ func BuildContainer(container *dig.Container) *dig.Container {
must(container.Provide(handler.NewKnowledgeBaseHandler))
must(container.Provide(handler.NewKnowledgeHandler))
must(container.Provide(handler.NewChunkHandler))
- must(container.Provide(handler.NewSessionHandler))
+ must(container.Provide(session.NewHandler))
must(container.Provide(handler.NewMessageHandler))
must(container.Provide(handler.NewModelHandler))
must(container.Provide(handler.NewEvaluationHandler))
diff --git a/internal/handler/session.go b/internal/handler/session.go
deleted file mode 100644
index f88bba4c..00000000
--- a/internal/handler/session.go
+++ /dev/null
@@ -1,1413 +0,0 @@
-package handler
-
-import (
- "context"
- "fmt"
- "net/http"
- "time"
-
- "github.com/Tencent/WeKnora/internal/config"
- "github.com/Tencent/WeKnora/internal/errors"
- "github.com/Tencent/WeKnora/internal/event"
- "github.com/Tencent/WeKnora/internal/logger"
- "github.com/Tencent/WeKnora/internal/types"
- "github.com/Tencent/WeKnora/internal/types/interfaces"
- "github.com/gin-gonic/gin"
-)
-
-// SessionHandler handles all HTTP requests related to conversation sessions
-type SessionHandler struct {
- messageService interfaces.MessageService // Service for managing messages
- sessionService interfaces.SessionService // Service for managing sessions
- streamManager interfaces.StreamManager // Manager for handling streaming responses
- config *config.Config // Application configuration
- knowledgebaseService interfaces.KnowledgeBaseService
-}
-
-// NewSessionHandler creates a new instance of SessionHandler with all necessary dependencies
-func NewSessionHandler(
- sessionService interfaces.SessionService,
- messageService interfaces.MessageService,
- streamManager interfaces.StreamManager,
- config *config.Config,
- knowledgebaseService interfaces.KnowledgeBaseService,
-) *SessionHandler {
- handler := &SessionHandler{
- sessionService: sessionService,
- messageService: messageService,
- streamManager: streamManager,
- config: config,
- knowledgebaseService: knowledgebaseService,
- }
- return handler
-}
-
-// SessionStrategy defines the configuration for a conversation session strategy
-type SessionStrategy struct {
- // Maximum number of conversation rounds to maintain
- MaxRounds int `json:"max_rounds"`
- // Whether to enable query rewrite for multi-round conversations
- EnableRewrite bool `json:"enable_rewrite"`
- // Strategy to use when no relevant knowledge is found
- FallbackStrategy types.FallbackStrategy `json:"fallback_strategy"`
- // Fixed response content for fallback
- FallbackResponse string `json:"fallback_response"`
- // Number of top results to retrieve from vector search
- EmbeddingTopK int `json:"embedding_top_k"`
- // Threshold for keyword-based retrieval
- KeywordThreshold float64 `json:"keyword_threshold"`
- // Threshold for vector-based retrieval
- VectorThreshold float64 `json:"vector_threshold"`
- // ID of the model used for reranking results
- RerankModelID string `json:"rerank_model_id"`
- // Number of top results after reranking
- RerankTopK int `json:"rerank_top_k"`
- // Threshold for reranking results
- RerankThreshold float64 `json:"rerank_threshold"`
- // ID of the model used for summarization
- SummaryModelID string `json:"summary_model_id"`
- // Parameters for the summary model
- SummaryParameters *types.SummaryConfig `json:"summary_parameters" gorm:"type:json"`
- // Prefix for responses when no match is found
- NoMatchPrefix string `json:"no_match_prefix"`
-}
-
-// CreateSessionRequest represents a request to create a new session
-// Sessions are now knowledge-base-independent and serve as conversation containers.
-// Knowledge bases can be specified dynamically in each query request (AgentQA/KnowledgeQA).
-type CreateSessionRequest struct {
- // ID of the associated knowledge base (optional, can be set/changed during queries)
- KnowledgeBaseID string `json:"knowledge_base_id"`
- // Session strategy configuration
- SessionStrategy *SessionStrategy `json:"session_strategy"`
- // Agent configuration (optional, session-level config only: enabled and knowledge_bases)
- AgentConfig *types.SessionAgentConfig `json:"agent_config"`
-}
-
-// CreateSession handles the creation of a new conversation session
-func (h *SessionHandler) CreateSession(c *gin.Context) {
- ctx := c.Request.Context()
- // Parse and validate the request body
- var request CreateSessionRequest
- if err := c.ShouldBindJSON(&request); err != nil {
- logger.Error(ctx, "Failed to validate session creation parameters", err)
- c.Error(errors.NewBadRequestError(err.Error()))
- return
- }
-
- // Get tenant ID from context
- tenantID, exists := c.Get(types.TenantIDContextKey.String())
- if !exists {
- logger.Error(ctx, "Failed to get tenant ID")
- c.Error(errors.NewUnauthorizedError("Unauthorized"))
- return
- }
-
- // Validate session creation request
- // Sessions are now knowledge-base-independent:
- // - KnowledgeBaseID is optional during session creation
- // - Knowledge base can be specified in each query request (AgentQA/KnowledgeQA)
- // - Agent mode can access multiple knowledge bases via AgentConfig.KnowledgeBases
- // - Knowledge base can be switched during conversation
- isAgentMode := request.AgentConfig != nil && request.AgentConfig.Enabled
- hasAgentKnowledgeBases := request.AgentConfig != nil && len(request.AgentConfig.KnowledgeBases) > 0
-
- logger.Infof(
- ctx,
- "Processing session creation request, tenant ID: %d, knowledge base ID: %s, agent mode: %v, agent KBs: %v",
- tenantID.(uint),
- request.KnowledgeBaseID,
- isAgentMode,
- hasAgentKnowledgeBases,
- )
-
- // Create session object with base properties
- createdSession := &types.Session{
- TenantID: tenantID.(uint),
- KnowledgeBaseID: request.KnowledgeBaseID,
- AgentConfig: request.AgentConfig, // Set agent config if provided
- }
-
- // If summary model parameters are empty, set defaults
- if request.SessionStrategy != nil {
- createdSession.RerankModelID = request.SessionStrategy.RerankModelID
- createdSession.SummaryModelID = request.SessionStrategy.SummaryModelID
- createdSession.MaxRounds = request.SessionStrategy.MaxRounds
- createdSession.EnableRewrite = request.SessionStrategy.EnableRewrite
- createdSession.FallbackStrategy = request.SessionStrategy.FallbackStrategy
- createdSession.FallbackResponse = request.SessionStrategy.FallbackResponse
- createdSession.EmbeddingTopK = request.SessionStrategy.EmbeddingTopK
- createdSession.KeywordThreshold = request.SessionStrategy.KeywordThreshold
- createdSession.VectorThreshold = request.SessionStrategy.VectorThreshold
- createdSession.RerankTopK = request.SessionStrategy.RerankTopK
- createdSession.RerankThreshold = request.SessionStrategy.RerankThreshold
- if request.SessionStrategy.SummaryParameters != nil {
- createdSession.SummaryParameters = request.SessionStrategy.SummaryParameters
- } else {
- createdSession.SummaryParameters = &types.SummaryConfig{
- MaxTokens: h.config.Conversation.Summary.MaxTokens,
- TopP: h.config.Conversation.Summary.TopP,
- TopK: h.config.Conversation.Summary.TopK,
- FrequencyPenalty: h.config.Conversation.Summary.FrequencyPenalty,
- PresencePenalty: h.config.Conversation.Summary.PresencePenalty,
- RepeatPenalty: h.config.Conversation.Summary.RepeatPenalty,
- NoMatchPrefix: h.config.Conversation.Summary.NoMatchPrefix,
- Temperature: h.config.Conversation.Summary.Temperature,
- Seed: h.config.Conversation.Summary.Seed,
- MaxCompletionTokens: h.config.Conversation.Summary.MaxCompletionTokens,
- }
- }
- if createdSession.SummaryParameters.Prompt == "" {
- createdSession.SummaryParameters.Prompt = h.config.Conversation.Summary.Prompt
- }
- if createdSession.SummaryParameters.ContextTemplate == "" {
- createdSession.SummaryParameters.ContextTemplate = h.config.Conversation.Summary.ContextTemplate
- }
- if createdSession.SummaryParameters.NoMatchPrefix == "" {
- createdSession.SummaryParameters.NoMatchPrefix = h.config.Conversation.Summary.NoMatchPrefix
- }
-
- logger.Debug(ctx, "Custom session strategy set")
- } else {
- // Use default configuration from global config
- createdSession.MaxRounds = h.config.Conversation.MaxRounds
- createdSession.EnableRewrite = h.config.Conversation.EnableRewrite
- createdSession.FallbackStrategy = types.FallbackStrategy(h.config.Conversation.FallbackStrategy)
- createdSession.FallbackResponse = h.config.Conversation.FallbackResponse
- createdSession.EmbeddingTopK = h.config.Conversation.EmbeddingTopK
- createdSession.KeywordThreshold = h.config.Conversation.KeywordThreshold
- createdSession.VectorThreshold = h.config.Conversation.VectorThreshold
- createdSession.RerankThreshold = h.config.Conversation.RerankThreshold
- createdSession.RerankTopK = h.config.Conversation.RerankTopK
- createdSession.SummaryParameters = &types.SummaryConfig{
- MaxTokens: h.config.Conversation.Summary.MaxTokens,
- TopP: h.config.Conversation.Summary.TopP,
- TopK: h.config.Conversation.Summary.TopK,
- FrequencyPenalty: h.config.Conversation.Summary.FrequencyPenalty,
- PresencePenalty: h.config.Conversation.Summary.PresencePenalty,
- RepeatPenalty: h.config.Conversation.Summary.RepeatPenalty,
- Prompt: h.config.Conversation.Summary.Prompt,
- ContextTemplate: h.config.Conversation.Summary.ContextTemplate,
- NoMatchPrefix: h.config.Conversation.Summary.NoMatchPrefix,
- Temperature: h.config.Conversation.Summary.Temperature,
- Seed: h.config.Conversation.Summary.Seed,
- MaxCompletionTokens: h.config.Conversation.Summary.MaxCompletionTokens,
- }
-
- logger.Debug(ctx, "Using default session strategy")
- }
-
- // Fetch knowledge base if KnowledgeBaseID is provided to inherit its model configurations
- // If no KB is provided, models will be determined at query time or use tenant/system defaults
- if request.KnowledgeBaseID != "" {
- kb, err := h.knowledgebaseService.GetKnowledgeBaseByID(ctx, request.KnowledgeBaseID)
- if err != nil {
- logger.Error(ctx, "Failed to get knowledge base", err)
- c.Error(errors.NewInternalServerError(err.Error()))
- return
- }
-
- // Use knowledge base's models if session doesn't specify them
- if createdSession.RerankModelID == "" {
- createdSession.RerankModelID = kb.RerankModelID
- }
- if createdSession.SummaryModelID == "" {
- createdSession.SummaryModelID = kb.SummaryModelID
- }
-
- logger.Debugf(ctx, "Knowledge base fetched: %s, rerank model: %s, summary model: %s",
- kb.ID, kb.RerankModelID, kb.SummaryModelID)
- } else {
- logger.Debug(ctx, "No knowledge base ID provided, models will use session strategy or be determined at query time")
- }
-
- // Call service to create session
- logger.Infof(ctx, "Calling session service to create session")
- createdSession, err := h.sessionService.CreateSession(ctx, createdSession)
- if err != nil {
- logger.ErrorWithFields(ctx, err, nil)
- c.Error(errors.NewInternalServerError(err.Error()))
- return
- }
-
- // Return created session
- logger.Infof(ctx, "Session created successfully, ID: %s", createdSession.ID)
- c.JSON(http.StatusCreated, gin.H{
- "success": true,
- "data": createdSession,
- })
-}
-
-// GetSession retrieves a session by its ID
-func (h *SessionHandler) GetSession(c *gin.Context) {
- ctx := c.Request.Context()
-
- logger.Info(ctx, "Start retrieving session")
-
- // Get session ID from URL parameter
- id := c.Param("id")
- if id == "" {
- logger.Error(ctx, "Session ID is empty")
- c.Error(errors.NewBadRequestError(errors.ErrInvalidSessionID.Error()))
- return
- }
-
- // Call service to get session details
- logger.Infof(ctx, "Retrieving session, ID: %s", id)
- session, err := h.sessionService.GetSession(ctx, id)
- if err != nil {
- if err == errors.ErrSessionNotFound {
- logger.Warnf(ctx, "Session not found, ID: %s", id)
- c.Error(errors.NewNotFoundError(err.Error()))
- return
- }
- logger.ErrorWithFields(ctx, err, nil)
- c.Error(errors.NewInternalServerError(err.Error()))
- return
- }
-
- // Return session data
- logger.Infof(ctx, "Session retrieved successfully, ID: %s", id)
- c.JSON(http.StatusOK, gin.H{
- "success": true,
- "data": session,
- })
-}
-
-// GetSessionsByTenant retrieves all sessions for the current tenant with pagination
-func (h *SessionHandler) GetSessionsByTenant(c *gin.Context) {
- ctx := c.Request.Context()
-
- logger.Info(ctx, "Start retrieving all sessions for tenant")
-
- // Parse pagination parameters from query
- var pagination types.Pagination
- if err := c.ShouldBindQuery(&pagination); err != nil {
- logger.Error(ctx, "Failed to parse pagination parameters", err)
- c.Error(errors.NewBadRequestError(err.Error()))
- return
- }
-
- logger.Debugf(ctx, "Using pagination parameters: page=%d, page_size=%d", pagination.Page, pagination.PageSize)
-
- // Use paginated query to get sessions
- result, err := h.sessionService.GetPagedSessionsByTenant(ctx, &pagination)
- if err != nil {
- logger.ErrorWithFields(ctx, err, nil)
- c.Error(errors.NewInternalServerError(err.Error()))
- return
- }
-
- // Return sessions with pagination data
- logger.Infof(ctx, "Successfully retrieved tenant sessions, total: %d", result.Total)
- c.JSON(http.StatusOK, gin.H{
- "success": true,
- "data": result.Data,
- "total": result.Total,
- "page": result.Page,
- "page_size": result.PageSize,
- })
-}
-
-// UpdateSession updates an existing session's properties
-func (h *SessionHandler) UpdateSession(c *gin.Context) {
- ctx := c.Request.Context()
-
- logger.Info(ctx, "Start updating session")
-
- // Get session ID from URL parameter
- id := c.Param("id")
- if id == "" {
- logger.Error(ctx, "Session ID is empty")
- c.Error(errors.NewBadRequestError(errors.ErrInvalidSessionID.Error()))
- return
- }
-
- // Verify tenant ID from context for authorization
- tenantID, exists := c.Get(types.TenantIDContextKey.String())
- if !exists {
- logger.Error(ctx, "Failed to get tenant ID")
- c.Error(errors.NewUnauthorizedError("Unauthorized"))
- return
- }
-
- // Parse request body to session object
- var session types.Session
- if err := c.ShouldBindJSON(&session); err != nil {
- logger.Error(ctx, "Failed to parse session data", err)
- c.Error(errors.NewBadRequestError(err.Error()))
- return
- }
-
- // Set session ID and tenant ID
- logger.Infof(ctx, "Updating session, ID: %s, tenant ID: %d", id, tenantID.(uint))
- session.ID = id
- session.TenantID = tenantID.(uint)
-
- // Call service to update session
- if err := h.sessionService.UpdateSession(ctx, &session); err != nil {
- if err == errors.ErrSessionNotFound {
- logger.Warnf(ctx, "Session not found, ID: %s", id)
- c.Error(errors.NewNotFoundError(err.Error()))
- return
- }
- logger.ErrorWithFields(ctx, err, nil)
- c.Error(errors.NewInternalServerError(err.Error()))
- return
- }
-
- // Return updated session
- logger.Infof(ctx, "Session updated successfully, ID: %s", id)
- c.JSON(http.StatusOK, gin.H{
- "success": true,
- "data": session,
- })
-}
-
-// DeleteSession deletes a session by its ID
-func (h *SessionHandler) DeleteSession(c *gin.Context) {
- ctx := c.Request.Context()
-
- logger.Info(ctx, "Start deleting session")
-
- // Get session ID from URL parameter
- id := c.Param("id")
- if id == "" {
- logger.Error(ctx, "Session ID is empty")
- c.Error(errors.NewBadRequestError(errors.ErrInvalidSessionID.Error()))
- return
- }
-
- // Call service to delete session
- logger.Infof(ctx, "Deleting session, ID: %s", id)
- if err := h.sessionService.DeleteSession(ctx, id); err != nil {
- if err == errors.ErrSessionNotFound {
- logger.Warnf(ctx, "Session not found, ID: %s", id)
- c.Error(errors.NewNotFoundError(err.Error()))
- return
- }
- logger.ErrorWithFields(ctx, err, nil)
- c.Error(errors.NewInternalServerError(err.Error()))
- return
- }
-
- // Return success message
- logger.Infof(ctx, "Session deleted successfully, ID: %s", id)
- c.JSON(http.StatusOK, gin.H{
- "success": true,
- "message": "Session deleted successfully",
- })
-}
-
-// GenerateTitleRequest defines the request structure for generating a session title
-type GenerateTitleRequest struct {
- Messages []types.Message `json:"messages" binding:"required"` // Messages to use as context for title generation
-}
-
-// GenerateTitle generates a title for a session based on message content
-func (h *SessionHandler) GenerateTitle(c *gin.Context) {
- ctx := c.Request.Context()
-
- logger.Info(ctx, "Start generating session title")
-
- // Get session ID from URL parameter
- sessionID := c.Param("session_id")
- if sessionID == "" {
- logger.Error(ctx, "Session ID is empty")
- c.Error(errors.NewBadRequestError(errors.ErrInvalidSessionID.Error()))
- return
- }
-
- // Parse request body
- var request GenerateTitleRequest
- if err := c.ShouldBindJSON(&request); err != nil {
- logger.Error(ctx, "Failed to parse request data", err)
- c.Error(errors.NewBadRequestError(err.Error()))
- return
- }
-
- // Get session from database
- session, err := h.sessionService.GetSession(ctx, sessionID)
- if err != nil {
- logger.ErrorWithFields(ctx, err, nil)
- c.Error(errors.NewInternalServerError(err.Error()))
- return
- }
-
- // Call service to generate title
- logger.Infof(ctx, "Generating session title, session ID: %s, message count: %d", sessionID, len(request.Messages))
- title, err := h.sessionService.GenerateTitle(ctx, session, request.Messages)
- if err != nil {
- logger.ErrorWithFields(ctx, err, nil)
- c.Error(errors.NewInternalServerError(err.Error()))
- return
- }
-
- // Return generated title
- logger.Infof(ctx, "Session title generated successfully, session ID: %s, title: %s", sessionID, title)
- c.JSON(http.StatusOK, gin.H{
- "success": true,
- "data": title,
- })
-}
-
-// CreateKnowledgeQARequest defines the request structure for knowledge QA
-type CreateKnowledgeQARequest struct {
- Query string `json:"query" binding:"required"` // Query text for knowledge base search
- KnowledgeBaseIDs []string `json:"knowledge_base_ids"` // Selected knowledge base ID for this request
- AgentEnabled bool `json:"agent_enabled"` // Whether agent mode is enabled for this request
-}
-
-// SearchKnowledgeRequest defines the request structure for searching knowledge without LLM summarization
-type SearchKnowledgeRequest struct {
- Query string `json:"query" binding:"required"` // Query text to search for
- KnowledgeBaseID string `json:"knowledge_base_id" binding:"required"` // ID of the knowledge base to search
-}
-
-// SearchKnowledge performs knowledge base search without LLM summarization
-func (h *SessionHandler) SearchKnowledge(c *gin.Context) {
- ctx := logger.CloneContext(c.Request.Context())
-
- logger.Info(ctx, "Start processing knowledge search request")
-
- // Parse request body
- var request SearchKnowledgeRequest
- if err := c.ShouldBindJSON(&request); err != nil {
- logger.Error(ctx, "Failed to parse request data", err)
- c.Error(errors.NewBadRequestError(err.Error()))
- return
- }
-
- // Validate request parameters
- if request.Query == "" {
- logger.Error(ctx, "Query content is empty")
- c.Error(errors.NewBadRequestError("Query content cannot be empty"))
- return
- }
-
- if request.KnowledgeBaseID == "" {
- logger.Error(ctx, "Knowledge base ID is empty")
- c.Error(errors.NewBadRequestError("Knowledge base ID cannot be empty"))
- return
- }
-
- logger.Infof(
- ctx,
- "Knowledge search request, knowledge base ID: %s, query: %s",
- request.KnowledgeBaseID,
- request.Query,
- )
-
- // Directly call knowledge retrieval service without LLM summarization
- searchResults, err := h.sessionService.SearchKnowledge(ctx, request.KnowledgeBaseID, request.Query)
- if err != nil {
- logger.ErrorWithFields(ctx, err, nil)
- c.Error(errors.NewInternalServerError(err.Error()))
- return
- }
-
- logger.Infof(ctx, "Knowledge search completed, found %d results", len(searchResults))
-
- // Return search results
- c.JSON(http.StatusOK, gin.H{
- "success": true,
- "data": searchResults,
- })
-}
-
-// ContinueStream handles continued streaming of an active response stream
-func (h *SessionHandler) ContinueStream(c *gin.Context) {
- ctx := c.Request.Context()
-
- logger.Info(ctx, "Start continuing stream response processing")
-
- // Get session ID from URL parameter
- sessionID := c.Param("session_id")
- if sessionID == "" {
- logger.Error(ctx, "Session ID is empty")
- c.Error(errors.NewBadRequestError(errors.ErrInvalidSessionID.Error()))
- return
- }
-
- // Get message ID from query parameter
- messageID := c.Query("message_id")
- if messageID == "" {
- logger.Error(ctx, "Message ID is empty")
- c.Error(errors.NewBadRequestError("Missing message ID"))
- return
- }
-
- logger.Infof(ctx, "Continuing stream, session ID: %s, message ID: %s", sessionID, messageID)
-
- // Verify that the session exists and belongs to this tenant
- _, err := h.sessionService.GetSession(ctx, sessionID)
- if err != nil {
- if err == errors.ErrSessionNotFound {
- logger.Warnf(ctx, "Session not found, ID: %s", sessionID)
- c.Error(errors.NewNotFoundError(err.Error()))
- } else {
- logger.ErrorWithFields(ctx, err, nil)
- c.Error(errors.NewInternalServerError(err.Error()))
- }
- return
- }
-
- // Get the incomplete message
- message, err := h.messageService.GetMessage(ctx, sessionID, messageID)
- if err != nil {
- logger.ErrorWithFields(ctx, err, nil)
- c.Error(errors.NewInternalServerError(err.Error()))
- return
- }
-
- if message == nil {
- logger.Warnf(ctx, "Incomplete message not found, session ID: %s, message ID: %s", sessionID, messageID)
- c.JSON(http.StatusNotFound, gin.H{
- "success": false,
- "error": "Incomplete message not found",
- })
- return
- }
-
- // Get initial events from stream (offset 0)
- events, currentOffset, err := h.streamManager.GetEvents(ctx, sessionID, messageID, 0)
- if err != nil {
- logger.ErrorWithFields(ctx, err, nil)
- c.Error(errors.NewInternalServerError(fmt.Sprintf("Failed to get stream data: %s", err.Error())))
- return
- }
-
- if len(events) == 0 {
- logger.Warnf(ctx, "No events found in stream, session ID: %s, message ID: %s", sessionID, messageID)
- c.JSON(http.StatusNotFound, gin.H{
- "success": false,
- "error": "No stream events found",
- })
- return
- }
-
- logger.Infof(
- ctx, "Preparing to replay %d events and continue streaming, session ID: %s, message ID: %s",
- len(events), sessionID, messageID,
- )
-
- // Set headers for SSE
- c.Header("Content-Type", "text/event-stream")
- c.Header("Cache-Control", "no-cache")
- c.Header("Connection", "keep-alive")
- c.Header("X-Accel-Buffering", "no")
-
- // Check if stream is already completed
- streamCompleted := false
- for _, evt := range events {
- if evt.Type == "complete" {
- streamCompleted = true
- break
- }
- }
-
- // Replay existing events
- logger.Debugf(ctx, "Replaying %d existing events", len(events))
- for _, evt := range events {
- response := &types.StreamResponse{
- ID: message.RequestID,
- ResponseType: evt.Type,
- Content: evt.Content,
- Done: evt.Done,
- Data: evt.Data,
- }
-
- // Special handling for references event
- if evt.Type == types.ResponseTypeReferences {
- if refs, ok := evt.Data["references"].(types.References); ok {
- response.KnowledgeReferences = refs
- }
- }
-
- c.SSEvent("message", response)
- c.Writer.Flush()
- }
-
- // If stream is already completed, send final event and return
- if streamCompleted {
- logger.Infof(ctx, "Stream already completed, session ID: %s, message ID: %s", sessionID, messageID)
- c.SSEvent("message", &types.StreamResponse{
- ID: message.RequestID,
- ResponseType: types.ResponseTypeAnswer,
- Content: "",
- Done: true,
- })
- c.Writer.Flush()
- return
- }
-
- // Continue polling for new events
- logger.Debug(ctx, "Starting event update monitoring")
- ticker := time.NewTicker(100 * time.Millisecond)
- defer ticker.Stop()
-
- for {
- select {
- case <-c.Request.Context().Done():
- logger.Debug(ctx, "Client connection closed")
- return
-
- case <-ticker.C:
- // Get new events from current offset
- newEvents, newOffset, err := h.streamManager.GetEvents(ctx, sessionID, messageID, currentOffset)
- if err != nil {
- logger.Errorf(ctx, "Failed to get new events: %v", err)
- return
- }
-
- // Send new events
- streamCompletedNow := false
- for _, evt := range newEvents {
- response := &types.StreamResponse{
- ID: message.RequestID,
- ResponseType: evt.Type,
- Content: evt.Content,
- Done: evt.Done,
- Data: evt.Data,
- }
-
- // Special handling for references event
- if evt.Type == types.ResponseTypeReferences {
- if refs, ok := evt.Data["references"].(types.References); ok {
- response.KnowledgeReferences = refs
- }
- }
-
- // Check for completion event
- if evt.Type == "complete" {
- streamCompletedNow = true
- }
-
- c.SSEvent("message", response)
- c.Writer.Flush()
- }
-
- // Update offset
- currentOffset = newOffset
-
- // If stream completed, send final event and exit
- if streamCompletedNow {
- logger.Infof(ctx, "Stream completed, session ID: %s, message ID: %s", sessionID, messageID)
- c.SSEvent("message", &types.StreamResponse{
- ID: message.RequestID,
- ResponseType: types.ResponseTypeAnswer,
- Content: "",
- Done: true,
- })
- c.Writer.Flush()
- return
- }
- }
- }
-}
-
-// KnowledgeQA handles knowledge base question answering requests with LLM summarization
-func (h *SessionHandler) KnowledgeQA(c *gin.Context) {
- ctx := logger.CloneContext(c.Request.Context())
-
- logger.Info(ctx, "Start processing knowledge QA request")
-
- // Get session ID from URL parameter
- sessionID := c.Param("session_id")
- if sessionID == "" {
- logger.Error(ctx, "Session ID is empty")
- c.Error(errors.NewBadRequestError(errors.ErrInvalidSessionID.Error()))
- return
- }
-
- // Parse request body
- var request CreateKnowledgeQARequest
- if err := c.ShouldBindJSON(&request); err != nil {
- logger.Error(ctx, "Failed to parse request data", err)
- c.Error(errors.NewBadRequestError(err.Error()))
- return
- }
-
- // Create assistant message
- assistantMessage := &types.Message{
- SessionID: sessionID,
- Role: "assistant",
- RequestID: c.GetString(types.RequestIDContextKey.String()),
- IsCompleted: false,
- }
-
- // Validate query content
- if request.Query == "" {
- logger.Error(ctx, "Query content is empty")
- c.Error(errors.NewBadRequestError("Query content cannot be empty"))
- return
- }
-
- logger.Infof(ctx, "Knowledge QA request, session ID: %s, query: %s", sessionID, request.Query)
-
- // Get session to prepare knowledge base IDs
- session, err := h.sessionService.GetSession(ctx, sessionID)
- if err != nil {
- logger.Errorf(ctx, "Failed to get session, session ID: %s, error: %v", sessionID, err)
- c.Error(errors.NewInternalServerError(err.Error()))
- return
- }
-
- // Prepare knowledge base IDs
- knowledgeBaseIDs := request.KnowledgeBaseIDs
- if len(knowledgeBaseIDs) == 0 && session.KnowledgeBaseID != "" {
- knowledgeBaseIDs = []string{session.KnowledgeBaseID}
- logger.Infof(ctx, "No knowledge base IDs in request, using session default: %s", session.KnowledgeBaseID)
- }
-
- // Use shared function to handle KnowledgeQA request
- h.handleKnowledgeQARequest(ctx, c, session, request.Query, knowledgeBaseIDs, assistantMessage, true)
-}
-
-// completeAssistantMessage marks an assistant message as complete and updates it
-func (h *SessionHandler) completeAssistantMessage(ctx context.Context, assistantMessage *types.Message) {
- assistantMessage.UpdatedAt = time.Now()
- assistantMessage.IsCompleted = true
- _ = h.messageService.UpdateMessage(ctx, assistantMessage)
-}
-
-// handleKnowledgeQARequest handles a KnowledgeQA request with the given parameters
-// This is a shared function used by both KnowledgeQA endpoint and AgentQA fallback
-func (h *SessionHandler) handleKnowledgeQARequest(
- ctx context.Context,
- c *gin.Context,
- session *types.Session,
- query string,
- knowledgeBaseIDs []string,
- assistantMessage *types.Message,
- generateTitle bool, // Whether to generate title if session has no title
-) {
- sessionID := session.ID
- requestID := c.GetString(types.RequestIDContextKey.String())
-
- // Create user message
- if _, err := h.messageService.CreateMessage(ctx, &types.Message{
- SessionID: sessionID,
- Role: "user",
- Content: query,
- RequestID: requestID,
- CreatedAt: time.Now(),
- IsCompleted: true,
- }); err != nil {
- c.Error(errors.NewInternalServerError(err.Error()))
- return
- }
-
- // Create assistant message (response)
- assistantMessage.CreatedAt = time.Now()
- if _, err := h.messageService.CreateMessage(ctx, assistantMessage); err != nil {
- c.Error(errors.NewInternalServerError(err.Error()))
- return
- }
-
- // Validate knowledge bases
- if len(knowledgeBaseIDs) == 0 {
- logger.Error(ctx, "No knowledge base ID available")
- c.Error(errors.NewBadRequestError("At least one knowledge base ID is required"))
- return
- }
-
- logger.Infof(ctx, "Using knowledge bases: %v", knowledgeBaseIDs)
-
- // Set headers for SSE
- c.Header("Content-Type", "text/event-stream")
- c.Header("Cache-Control", "no-cache")
- c.Header("Connection", "keep-alive")
- c.Header("X-Accel-Buffering", "no")
-
- // Write initial agent_query event to StreamManager
- agentQueryEvent := interfaces.StreamEvent{
- ID: fmt.Sprintf("query-%d", time.Now().UnixNano()),
- Type: types.ResponseTypeAgentQuery,
- Content: "",
- Done: true,
- Timestamp: time.Now(),
- Data: map[string]interface{}{
- "session_id": sessionID,
- "assistant_message_id": assistantMessage.ID,
- },
- }
- if err := h.streamManager.AppendEvent(ctx, sessionID, assistantMessage.ID, agentQueryEvent); err != nil {
- logger.ErrorWithFields(ctx, err, map[string]interface{}{
- "session_id": sessionID,
- "message_id": assistantMessage.ID,
- })
- // Non-fatal error, continue
- }
-
- // Create dedicated EventBus for this request
- eventBus := event.NewEventBus()
- // Create cancellable context for async operations
- asyncCtx, cancel := context.WithCancel(logger.CloneContext(ctx))
-
- // Register stop event handler to cancel the context
- eventBus.On(event.EventStop, func(ctx context.Context, evt event.Event) error {
- logger.Infof(ctx, "Received stop event, cancelling async operations for session: %s", sessionID)
- cancel()
- assistantMessage.Content = "用户停止了本次对话"
- h.completeAssistantMessage(ctx, assistantMessage)
- return nil
- })
-
- // Create stream handler with dedicated EventBus
- streamHandler := NewAgentStreamHandler(
- asyncCtx, sessionID, assistantMessage.ID, requestID,
- assistantMessage, h.streamManager, eventBus,
- )
-
- // Subscribe to events on the dedicated EventBus
- streamHandler.Subscribe()
-
- // Generate title if needed
- if generateTitle && session.Title == "" {
- logger.Infof(ctx, "Session has no title, starting async title generation, session ID: %s", sessionID)
- h.sessionService.GenerateTitleAsync(asyncCtx, session, query, eventBus)
- }
-
- eventBus.On(event.EventAgentFinalAnswer, func(ctx context.Context, evt event.Event) error {
- data, ok := evt.Data.(event.AgentFinalAnswerData)
- if !ok {
- return nil
- }
- assistantMessage.Content += data.Content
- if data.Done {
- logger.Infof(asyncCtx, "Knowledge QA service completed for session: %s", sessionID)
- h.completeAssistantMessage(asyncCtx, assistantMessage)
- cancel() // Clean up context
- return nil
- }
- return nil
- })
-
- // Call service to perform knowledge QA (async, emits events)
- go func() {
- defer func() {
- if r := recover(); r != nil {
- logger.ErrorWithFields(asyncCtx, errors.NewInternalServerError("Knowledge QA service panicked"), nil)
- }
- }()
- err := h.sessionService.KnowledgeQA(asyncCtx, session, query, knowledgeBaseIDs, assistantMessage.ID, eventBus)
- if err != nil {
- logger.ErrorWithFields(asyncCtx, err, nil)
- // Emit error event to dedicated EventBus
- eventBus.Emit(asyncCtx, event.Event{
- Type: event.EventError,
- SessionID: sessionID,
- Data: event.ErrorData{
- Error: err.Error(),
- Stage: "knowledge_qa_execution",
- SessionID: sessionID,
- },
- })
- return
- }
- }()
-
- // Handle events for SSE (blocking until connection is done)
- h.handleAgentEventsForSSEWithHandler(ctx, c, sessionID, assistantMessage.ID, requestID, eventBus)
-}
-
-// AgentQA handles agent-based question answering with conversation history and streaming
-func (h *SessionHandler) AgentQA(c *gin.Context) {
- ctx := logger.CloneContext(c.Request.Context())
- logger.Info(ctx, "Start processing agent QA request")
-
- // Get session ID from URL parameter
- sessionID := c.Param("session_id")
- if sessionID == "" {
- logger.Error(ctx, "Session ID is empty")
- c.Error(errors.NewBadRequestError(errors.ErrInvalidSessionID.Error()))
- return
- }
-
- // Parse request body
- var request CreateKnowledgeQARequest
- if err := c.ShouldBindJSON(&request); err != nil {
- logger.Error(ctx, "Failed to parse request data", err)
- c.Error(errors.NewBadRequestError(err.Error()))
- return
- }
-
- // Validate query content
- if request.Query == "" {
- logger.Error(ctx, "Query content is empty")
- c.Error(errors.NewBadRequestError("Query content cannot be empty"))
- return
- }
-
- logger.Infof(ctx, "Agent QA request, session ID: %s, query: %s", sessionID, request.Query)
-
- // Get session information first
- session, err := h.sessionService.GetSession(ctx, sessionID)
- if err != nil {
- logger.Errorf(ctx, "Failed to get session, session ID: %s, error: %v", sessionID, err)
- c.Error(errors.NewNotFoundError("Session not found"))
- return
- }
-
- // Create assistant message
- assistantMessage := &types.Message{
- SessionID: sessionID,
- Role: "assistant",
- RequestID: c.GetString(types.RequestIDContextKey.String()),
- IsCompleted: false,
- }
-
- // Initialize AgentConfig if it doesn't exist
- if session.AgentConfig == nil {
- session.AgentConfig = &types.SessionAgentConfig{}
- }
-
- // Detect if knowledge bases or agent mode has changed
- knowledgeBasesChanged := false
- configChanged := false
-
- // Check if knowledge bases array has changed
- if len(request.KnowledgeBaseIDs) > 0 {
- // Compare arrays to detect changes
- currentKBs := session.AgentConfig.KnowledgeBases
- if len(currentKBs) != len(request.KnowledgeBaseIDs) {
- knowledgeBasesChanged = true
- configChanged = true
- } else {
- // Check if contents are different
- kbMap := make(map[string]bool)
- for _, kb := range currentKBs {
- kbMap[kb] = true
- }
- for _, kb := range request.KnowledgeBaseIDs {
- if !kbMap[kb] {
- knowledgeBasesChanged = true
- configChanged = true
- break
- }
- }
- }
- if knowledgeBasesChanged {
- logger.Infof(ctx, "Knowledge bases changed from %v to %v", session.AgentConfig.KnowledgeBases, request.KnowledgeBaseIDs)
- }
- }
-
- // Check if agent mode has changed
- currentAgentEnabled := session.AgentConfig.Enabled
- if request.AgentEnabled != currentAgentEnabled {
- logger.Infof(ctx, "Agent mode changed from %v to %v", currentAgentEnabled, request.AgentEnabled)
- configChanged = true
- }
-
- // If configuration changed, clear context and update session
- if configChanged {
- logger.Infof(ctx, "Configuration changed, clearing context for session: %s", sessionID)
- if knowledgeBasesChanged {
- // Clear the LLM context to prevent contamination
- if err := h.sessionService.ClearContext(ctx, sessionID); err != nil {
- logger.Errorf(ctx, "Failed to clear context for session %s: %v", sessionID, err)
- // Continue anyway - this is not a fatal error
- }
- }
- session.AgentConfig.KnowledgeBases = request.KnowledgeBaseIDs
- session.AgentConfig.Enabled = request.AgentEnabled
- // Persist the session changes
- if err := h.sessionService.UpdateSession(ctx, session); err != nil {
- logger.Errorf(ctx, "Failed to update session %s: %v", sessionID, err)
- c.Error(errors.NewInternalServerError("Failed to update session configuration"))
- return
- }
- logger.Infof(ctx, "Session configuration updated successfully for session: %s", sessionID)
- }
-
- // If Agent mode is disabled, delegate to KnowledgeQA
- if !request.AgentEnabled {
- logger.Infof(ctx, "Agent mode disabled, delegating to KnowledgeQA for session: %s", sessionID)
-
- // Use knowledge bases from request or session config
- knowledgeBaseIDs := request.KnowledgeBaseIDs
- if len(knowledgeBaseIDs) == 0 {
- knowledgeBaseIDs = session.AgentConfig.KnowledgeBases
- }
-
- // If still empty, use session default knowledge base
- if len(knowledgeBaseIDs) == 0 && session.KnowledgeBaseID != "" {
- knowledgeBaseIDs = []string{session.KnowledgeBaseID}
- logger.Infof(ctx, "Using session default knowledge base: %s", session.KnowledgeBaseID)
- }
-
- // Validate at least one knowledge base is available
- if len(knowledgeBaseIDs) == 0 {
- logger.Error(ctx, "No knowledge base available for delegation")
- c.Error(errors.NewBadRequestError("No knowledge base available. Please configure at least one knowledge base."))
- return
- }
-
- logger.Infof(ctx, "Delegating to KnowledgeQA with knowledge bases: %v", knowledgeBaseIDs)
-
- // Use shared function to handle KnowledgeQA request (no title generation for AgentQA fallback)
- h.handleKnowledgeQARequest(ctx, c, session, request.Query, knowledgeBaseIDs, assistantMessage, false)
- return
- }
-
- // Emit agent query event to create user message
- requestID := c.GetString(types.RequestIDContextKey.String())
- if err := event.Emit(ctx, event.Event{
- Type: event.EventAgentQuery,
- SessionID: sessionID,
- RequestID: requestID,
- Data: event.AgentQueryData{
- SessionID: sessionID,
- Query: request.Query,
- RequestID: requestID,
- },
- }); err != nil {
- logger.Errorf(ctx, "Failed to emit agent query event: %v", err)
- return
- }
-
- // Set headers for SSE immediately
- c.Header("Content-Type", "text/event-stream")
- c.Header("Cache-Control", "no-cache")
- c.Header("Connection", "keep-alive")
- c.Header("X-Accel-Buffering", "no")
-
- // Create user message
- if _, err := h.messageService.CreateMessage(ctx, &types.Message{
- SessionID: sessionID,
- Role: "user",
- Content: request.Query,
- RequestID: requestID,
- CreatedAt: time.Now(),
- IsCompleted: true,
- }); err != nil {
- c.Error(errors.NewInternalServerError(err.Error()))
- return
- }
-
- // Create assistant message (response)
- assistantMessage.CreatedAt = time.Now()
- assistantMessagePtr, err := h.messageService.CreateMessage(ctx, assistantMessage)
- if err != nil {
- c.Error(errors.NewInternalServerError(err.Error()))
- return
- }
- assistantMessage = assistantMessagePtr
-
- logger.Infof(ctx, "Calling agent QA service, session ID: %s", sessionID)
-
- // SSE headers already set earlier when sending agent_query event
- // Write initial agent_query event to StreamManager
- agentQueryEvent := interfaces.StreamEvent{
- ID: fmt.Sprintf("query-%d", time.Now().UnixNano()),
- Type: types.ResponseTypeAgentQuery,
- Content: "",
- Done: true,
- Timestamp: time.Now(),
- Data: map[string]interface{}{
- "session_id": sessionID,
- "assistant_message_id": assistantMessage.ID,
- },
- }
- if err := h.streamManager.AppendEvent(ctx, sessionID, assistantMessage.ID, agentQueryEvent); err != nil {
- logger.ErrorWithFields(ctx, err, map[string]interface{}{
- "session_id": sessionID,
- "message_id": assistantMessage.ID,
- })
- // Non-fatal error, continue
- }
-
- eventBus := event.NewEventBus()
- // Create cancellable context for async operations
- asyncCtx, cancel := context.WithCancel(logger.CloneContext(ctx))
- // Create stream handler with dedicated EventBus BEFORE calling AgentQA
- streamHandler := NewAgentStreamHandler(
- asyncCtx, sessionID, assistantMessage.ID, requestID,
- assistantMessage, h.streamManager, eventBus,
- )
-
- // Subscribe to events on the dedicated EventBus
- streamHandler.Subscribe()
-
- // Start async title generation if session has no title
- if session.Title == "" {
- logger.Infof(ctx, "Session has no title, starting async title generation, session ID: %s", sessionID)
- h.sessionService.GenerateTitleAsync(asyncCtx, session, request.Query, eventBus)
- }
-
- // Register stop event handler to cancel the context
- eventBus.On(event.EventStop, func(ctx context.Context, evt event.Event) error {
- logger.Warnf(asyncCtx, "Received stop event, cancelling async operations for session: %s", sessionID)
- cancel()
- assistantMessage.Content = "用户停止了本次对话"
- h.completeAssistantMessage(ctx, assistantMessage)
- return nil
- })
-
- go func() {
- defer func() {
- if r := recover(); r != nil {
- logger.ErrorWithFields(asyncCtx, errors.NewInternalServerError("Agent QA service panicked"), nil)
- }
- h.completeAssistantMessage(asyncCtx, assistantMessage)
- logger.Infof(asyncCtx, "Agent QA service completed for session: %s", sessionID)
- }()
- err := h.sessionService.AgentQA(asyncCtx, session, request.Query, assistantMessage.ID, eventBus)
- if err != nil {
- logger.ErrorWithFields(asyncCtx, err, nil)
- // Emit error event to dedicated EventBus
- eventBus.Emit(asyncCtx, event.Event{
- Type: event.EventError,
- SessionID: sessionID,
- Data: event.ErrorData{
- Error: err.Error(),
- Stage: "agent_execution",
- SessionID: sessionID,
- },
- })
- return
- }
- }()
-
- // Handle events for SSE (blocking until connection is done)
- h.handleAgentEventsForSSEWithHandler(ctx, c, sessionID, assistantMessage.ID, requestID, eventBus)
-}
-
-// handleAgentEventsForSSEWithHandler handles agent events for SSE streaming using an existing handler
-// The handler is already subscribed to events and AgentQA is already running
-// This function polls StreamManager and pushes events to SSE, allowing graceful handling of disconnections
-func (h *SessionHandler) handleAgentEventsForSSEWithHandler(
- ctx context.Context,
- c *gin.Context,
- sessionID, assistantMessageID, requestID string,
- eventBus *event.EventBus,
-) {
- ticker := time.NewTicker(100 * time.Millisecond)
- defer ticker.Stop()
-
- lastOffset := 0
- log := logger.GetLogger(ctx)
-
- log.Infof("Starting pull-based SSE streaming for session=%s, message=%s", sessionID, assistantMessageID)
-
- for {
- select {
- case <-c.Request.Context().Done():
- // Connection closed, exit gracefully without panic
- log.Infof("Client disconnected, stopping SSE streaming for session=%s, message=%s", sessionID, assistantMessageID)
- return
-
- case <-ticker.C:
- // Get new events from StreamManager using offset
- events, newOffset, err := h.streamManager.GetEvents(ctx, sessionID, assistantMessageID, lastOffset)
- if err != nil {
- log.Warnf("Failed to get events from stream: %v", err)
- continue
- }
-
- // Send any new events
- streamCompleted := false
- for _, evt := range events {
- // Check for stop event
- if evt.Type == types.ResponseType(event.EventStop) {
- log.Infof("Detected stop event, triggering stop via EventBus for session=%s", sessionID)
-
- // Emit stop event to the EventBus to trigger context cancellation
- if eventBus != nil {
- eventBus.Emit(ctx, event.Event{
- Type: event.EventStop,
- SessionID: sessionID,
- Data: event.StopData{
- SessionID: sessionID,
- MessageID: assistantMessageID,
- Reason: "user_requested",
- },
- })
- }
-
- // Send stop notification to frontend
- c.SSEvent("message", &types.StreamResponse{
- ID: requestID,
- ResponseType: "stop",
- Content: "Generation stopped by user",
- Done: true,
- })
- c.Writer.Flush()
- return
- }
-
- // Build StreamResponse from StreamEvent
- // For agent_query event, extract session_id and assistant_message_id from Data
- var sessionIDFromEvent, assistantMessageIDFromEvent string
- if evt.Type == types.ResponseTypeAgentQuery {
- if sid, ok := evt.Data["session_id"].(string); ok {
- sessionIDFromEvent = sid
- }
- if amid, ok := evt.Data["assistant_message_id"].(string); ok {
- assistantMessageIDFromEvent = amid
- }
- }
- response := &types.StreamResponse{
- ID: requestID,
- ResponseType: evt.Type,
- Content: evt.Content,
- Done: evt.Done,
- Data: evt.Data,
- SessionID: sessionIDFromEvent,
- AssistantMessageID: assistantMessageIDFromEvent,
- }
-
- // Special handling for references event
- if evt.Type == types.ResponseTypeReferences {
- if refs, ok := evt.Data["references"].(types.References); ok {
- response.KnowledgeReferences = refs
- }
- }
-
- // Check for completion event
- if evt.Type == "complete" {
- streamCompleted = true
- }
-
- // Check if connection is still alive before writing
- if c.Request.Context().Err() != nil {
- log.Info("Connection closed during event sending, stopping")
- return
- }
-
- c.SSEvent("message", response)
- c.Writer.Flush()
- }
-
- // Update offset
- lastOffset = newOffset
-
- // Check if stream is completed
- if streamCompleted {
- log.Infof("Stream completed for session=%s, message=%s", sessionID, assistantMessageID)
-
- // Send final completion signal
- c.SSEvent("message", &types.StreamResponse{
- ID: requestID,
- ResponseType: types.ResponseTypeAnswer,
- Content: "",
- Done: true,
- })
- c.Writer.Flush()
- return
- }
- }
- }
-}
-
-// StopSessionRequest represents the stop session request
-type StopSessionRequest struct {
- MessageID string `json:"message_id" binding:"required"`
-}
-
-// StopSession handles the stop generation request
-func (h *SessionHandler) StopSession(c *gin.Context) {
- ctx := logger.CloneContext(c.Request.Context())
- sessionID := c.Param("session_id")
-
- if sessionID == "" {
- c.JSON(400, gin.H{"error": "Session ID is required"})
- return
- }
-
- // Parse request body to get message_id
- var req StopSessionRequest
- if err := c.ShouldBindJSON(&req); err != nil {
- logger.ErrorWithFields(ctx, err, map[string]interface{}{
- "session_id": sessionID,
- })
- c.JSON(400, gin.H{"error": "message_id is required"})
- return
- }
-
- assistantMessageID := req.MessageID
- logger.Infof(ctx, "Stop generation request for session: %s, message: %s", sessionID, assistantMessageID)
-
- // Get tenant ID from context
- tenantID, exists := c.Get(types.TenantIDContextKey.String())
- if !exists {
- logger.Error(ctx, "Failed to get tenant ID")
- c.JSON(401, gin.H{"error": "Unauthorized"})
- return
- }
- tenantIDUint := tenantID.(uint)
-
- // Verify message ownership and status
- message, err := h.messageService.GetMessage(ctx, sessionID, assistantMessageID)
- if err != nil {
- logger.ErrorWithFields(ctx, err, map[string]interface{}{
- "session_id": sessionID,
- "message_id": assistantMessageID,
- })
- c.JSON(404, gin.H{"error": "Message not found"})
- return
- }
-
- // Verify message belongs to this session (double check)
- if message.SessionID != sessionID {
- logger.Warnf(ctx, "Message %s does not belong to session %s", assistantMessageID, sessionID)
- c.JSON(403, gin.H{"error": "Message does not belong to this session"})
- return
- }
-
- // Verify message belongs to the current tenant
- session, err := h.sessionService.GetSession(ctx, sessionID)
- if err != nil {
- logger.ErrorWithFields(ctx, err, map[string]interface{}{
- "session_id": sessionID,
- })
- c.JSON(404, gin.H{"error": "Session not found"})
- return
- }
-
- if session.TenantID != tenantIDUint {
- logger.Warnf(ctx, "Session %s does not belong to tenant %d", sessionID, tenantIDUint)
- c.JSON(403, gin.H{"error": "Access denied"})
- return
- }
-
- // Check if message is already completed (stopped)
- if message.IsCompleted {
- logger.Infof(ctx, "Message %s is already completed, no need to stop", assistantMessageID)
- c.JSON(200, gin.H{
- "success": true,
- "message": "Message already completed",
- })
- return
- }
-
- // Write stop event to StreamManager for distributed support
- stopEvent := interfaces.StreamEvent{
- ID: fmt.Sprintf("stop-%d", time.Now().UnixNano()),
- Type: types.ResponseType(event.EventStop),
- Content: "",
- Done: true,
- Timestamp: time.Now(),
- Data: map[string]interface{}{
- "session_id": sessionID,
- "message_id": assistantMessageID,
- "reason": "user_requested",
- },
- }
-
- if err := h.streamManager.AppendEvent(ctx, sessionID, assistantMessageID, stopEvent); err != nil {
- logger.ErrorWithFields(ctx, err, map[string]interface{}{
- "session_id": sessionID,
- "message_id": assistantMessageID,
- })
- c.JSON(500, gin.H{"error": "Failed to write stop event"})
- return
- }
-
- logger.Infof(ctx, "Stop event written successfully for session: %s, message: %s", sessionID, assistantMessageID)
- c.JSON(200, gin.H{
- "success": true,
- "message": "Generation stopped",
- })
-}
diff --git a/internal/handler/session/REFACTORING_SUMMARY.md b/internal/handler/session/REFACTORING_SUMMARY.md
new file mode 100644
index 00000000..948ba413
--- /dev/null
+++ b/internal/handler/session/REFACTORING_SUMMARY.md
@@ -0,0 +1,179 @@
+# Session Handler 重构总结
+
+## 📋 优化概述
+
+本次重构主要通过提取公共辅助函数来简化代码,消除重复逻辑,提高代码的可维护性和可读性。
+
+## 🆕 新增文件
+
+### `helpers.go` - 辅助函数集合
+
+创建了一个专门的辅助函数文件,包含以下功能:
+
+#### SSE 相关
+- **`setSSEHeaders(c *gin.Context)`** - 设置 SSE 标准头部
+- **`sendCompletionEvent(c, requestID)`** - 发送完成事件
+- **`buildStreamResponse(evt, requestID)`** - 从 StreamEvent 构建 StreamResponse
+
+#### 事件和流处理
+- **`createAgentQueryEvent(sessionID, assistantMessageID)`** - 创建 agent query 事件
+- **`writeAgentQueryEvent(ctx, sessionID, assistantMessageID)`** - 写入 agent query 事件到流管理器
+
+#### 消息处理
+- **`createUserMessage(ctx, sessionID, query, requestID)`** - 创建用户消息
+- **`createAssistantMessage(ctx, assistantMessage)`** - 创建助手消息
+
+#### StreamHandler 设置
+- **`setupStreamHandler(...)`** - 创建并订阅流处理器
+- **`setupStopEventHandler(...)`** - 注册停止事件处理器
+
+#### 配置相关
+- **`createDefaultSummaryConfig()`** - 创建默认摘要配置
+- **`fillSummaryConfigDefaults(config)`** - 填充摘要配置默认值
+
+#### 工具函数
+- **`validateSessionID(c)`** - 验证并提取 session ID
+- **`getRequestID(c)`** - 获取 request ID
+- **`getString(m, key)`** - 安全获取字符串值
+- **`getFloat64(m, key)`** - 安全获取浮点数值
+
+## 🔄 优化的文件
+
+### 1. `agent_stream_handler.go`
+**减少行数**: 428 → 410 行 (-18 行)
+
+**优化内容**:
+- 移除了重复的辅助函数 `getString` 和 `getFloat64`(现在在 `helpers.go` 中)
+
+### 2. `stream.go`
+**减少行数**: 440 → 364 行 (-76 行, **-17.3%**)
+
+**优化内容**:
+- 使用 `setSSEHeaders()` 替代重复的 4 行头部设置代码
+- 使用 `buildStreamResponse()` 替代 10+ 行的响应构建逻辑(3 处)
+- 使用 `sendCompletionEvent()` 替代重复的完成事件发送代码(3 处)
+
+**优化示例**:
+```go
+// Before (10+ lines)
+response := &types.StreamResponse{
+ ID: message.RequestID,
+ ResponseType: evt.Type,
+ Content: evt.Content,
+ Done: evt.Done,
+ Data: evt.Data,
+}
+if evt.Type == types.ResponseTypeReferences {
+ if refs, ok := evt.Data["references"].(types.References); ok {
+ response.KnowledgeReferences = refs
+ }
+}
+
+// After (1 line)
+response := buildStreamResponse(evt, message.RequestID)
+```
+
+### 3. `qa.go`
+**减少行数**: 536 → 485 行 (-51 行, **-9.5%**)
+
+**优化内容**:
+- 使用 `setSSEHeaders()` 替代重复的头部设置(2 处)
+- 使用 `createUserMessage()` 替代 9 行的用户消息创建(3 处)
+- 使用 `createAssistantMessage()` 替代 3 行的助手消息创建(3 处)
+- 使用 `writeAgentQueryEvent()` 替代 15+ 行的事件写入代码(2 处)
+- 使用 `setupStreamHandler()` 替代 7 行的处理器设置(2 处)
+- 使用 `setupStopEventHandler()` 替代 7 行的停止事件处理器设置(2 处)
+- 使用 `getRequestID()` 简化请求 ID 获取(1 处)
+
+### 4. `handler.go`
+**减少行数**: 354 → 312 行 (-42 行, **-11.9%**)
+
+**优化内容**:
+- 使用 `createDefaultSummaryConfig()` 替代 12 行的配置创建(2 处)
+- 使用 `fillSummaryConfigDefaults()` 替代 9 行的默认值填充(1 处)
+
+**优化示例**:
+```go
+// Before (21 lines)
+if request.SessionStrategy.SummaryParameters != nil {
+ createdSession.SummaryParameters = request.SessionStrategy.SummaryParameters
+} else {
+ createdSession.SummaryParameters = &types.SummaryConfig{
+ MaxTokens: h.config.Conversation.Summary.MaxTokens,
+ TopP: h.config.Conversation.Summary.TopP,
+ // ... 8 more fields
+ }
+}
+if createdSession.SummaryParameters.Prompt == "" {
+ createdSession.SummaryParameters.Prompt = h.config.Conversation.Summary.Prompt
+}
+// ... 2 more field checks
+
+// After (5 lines)
+if request.SessionStrategy.SummaryParameters != nil {
+ createdSession.SummaryParameters = request.SessionStrategy.SummaryParameters
+} else {
+ createdSession.SummaryParameters = h.createDefaultSummaryConfig()
+}
+h.fillSummaryConfigDefaults(createdSession.SummaryParameters)
+```
+
+## 📊 总体统计
+
+| 文件 | 优化前 | 优化后 | 减少 | 比例 |
+|------|-------|-------|------|------|
+| agent_stream_handler.go | 428 | 410 | -18 | -4.2% |
+| stream.go | 440 | 364 | -76 | -17.3% |
+| qa.go | 536 | 485 | -51 | -9.5% |
+| handler.go | 354 | 312 | -42 | -11.9% |
+| **总计** | **1,758** | **1,571** | **-187** | **-10.6%** |
+| helpers.go (新增) | 0 | 204 | +204 | - |
+| **净变化** | **1,758** | **1,775** | **+17** | **+1.0%** |
+
+虽然总行数略有增加(+17 行),但代码质量显著提升:
+- ✅ 消除了大量重复代码
+- ✅ 提高了代码复用性
+- ✅ 增强了可维护性
+- ✅ 统一了代码风格
+- ✅ 便于未来扩展
+
+## 🎯 关键改进
+
+### 1. **代码复用性**
+通过提取公共函数,同样的逻辑只需维护一处,修改时更新一个地方即可。
+
+### 2. **可读性提升**
+```go
+// Before: 需要阅读 10+ 行才能理解
+response := &types.StreamResponse{ /* 10 lines */ }
+
+// After: 一行就能明白意图
+response := buildStreamResponse(evt, requestID)
+```
+
+### 3. **一致性**
+所有 SSE 头部设置、消息创建、事件处理都使用统一的方法,降低出错风险。
+
+### 4. **易于测试**
+辅助函数可以独立测试,提高单元测试的覆盖率。
+
+### 5. **便于维护**
+如果需要修改 SSE 头部或事件格式,只需修改辅助函数,不需要搜索整个代码库。
+
+## ✅ 验证结果
+
+- ✅ 无 linter 错误
+- ✅ 编译成功
+- ✅ 保持原有功能不变
+- ✅ 代码结构更清晰
+
+## 🔮 未来建议
+
+1. **测试覆盖**: 为 `helpers.go` 中的辅助函数添加单元测试
+2. **文档完善**: 为复杂的辅助函数添加使用示例
+3. **持续优化**: 定期审查是否有新的重复代码可以提取
+
+## 📝 总结
+
+本次重构成功地消除了代码重复,提高了代码质量。虽然增加了一个新文件,但整体代码结构更加清晰,维护成本大幅降低。重构遵循了 DRY(Don't Repeat Yourself)原则,为未来的开发和维护打下了良好的基础。
+
diff --git a/internal/handler/agent_stream_handler.go b/internal/handler/session/agent_stream_handler.go
similarity index 97%
rename from internal/handler/agent_stream_handler.go
rename to internal/handler/session/agent_stream_handler.go
index 462ed2c7..bcf7eddc 100644
--- a/internal/handler/agent_stream_handler.go
+++ b/internal/handler/session/agent_stream_handler.go
@@ -1,4 +1,4 @@
-package handler
+package session
import (
"context"
@@ -407,21 +407,3 @@ func (h *AgentStreamHandler) handleComplete(ctx context.Context, evt event.Event
return nil
}
-
-// Helper functions
-func getString(m map[string]interface{}, key string) string {
- if val, ok := m[key].(string); ok {
- return val
- }
- return ""
-}
-
-func getFloat64(m map[string]interface{}, key string) float64 {
- if val, ok := m[key].(float64); ok {
- return val
- }
- if val, ok := m[key].(int); ok {
- return float64(val)
- }
- return 0.0
-}
diff --git a/internal/handler/session/handler.go b/internal/handler/session/handler.go
new file mode 100644
index 00000000..bff6ab2b
--- /dev/null
+++ b/internal/handler/session/handler.go
@@ -0,0 +1,321 @@
+package session
+
+import (
+ "net/http"
+
+ "github.com/Tencent/WeKnora/internal/config"
+ "github.com/Tencent/WeKnora/internal/errors"
+ "github.com/Tencent/WeKnora/internal/logger"
+ "github.com/Tencent/WeKnora/internal/types"
+ "github.com/Tencent/WeKnora/internal/types/interfaces"
+ "github.com/gin-gonic/gin"
+)
+
+// Handler handles all HTTP requests related to conversation sessions
+type Handler struct {
+ messageService interfaces.MessageService // Service for managing messages
+ sessionService interfaces.SessionService // Service for managing sessions
+ streamManager interfaces.StreamManager // Manager for handling streaming responses
+ config *config.Config // Application configuration
+ knowledgebaseService interfaces.KnowledgeBaseService // Service for managing knowledge bases
+}
+
+// NewHandler creates a new instance of Handler with all necessary dependencies
+func NewHandler(
+ sessionService interfaces.SessionService,
+ messageService interfaces.MessageService,
+ streamManager interfaces.StreamManager,
+ config *config.Config,
+ knowledgebaseService interfaces.KnowledgeBaseService,
+) *Handler {
+ return &Handler{
+ sessionService: sessionService,
+ messageService: messageService,
+ streamManager: streamManager,
+ config: config,
+ knowledgebaseService: knowledgebaseService,
+ }
+}
+
+// CreateSession handles the creation of a new conversation session
+func (h *Handler) CreateSession(c *gin.Context) {
+ ctx := c.Request.Context()
+ // Parse and validate the request body
+ var request CreateSessionRequest
+ if err := c.ShouldBindJSON(&request); err != nil {
+ logger.Error(ctx, "Failed to validate session creation parameters", err)
+ c.Error(errors.NewBadRequestError(err.Error()))
+ return
+ }
+
+ // Get tenant ID from context
+ tenantID, exists := c.Get(types.TenantIDContextKey.String())
+ if !exists {
+ logger.Error(ctx, "Failed to get tenant ID")
+ c.Error(errors.NewUnauthorizedError("Unauthorized"))
+ return
+ }
+
+ // Validate session creation request
+ // Sessions are now knowledge-base-independent:
+ // - KnowledgeBaseID is optional during session creation
+ // - Knowledge base can be specified in each query request (AgentQA/KnowledgeQA)
+ // - Agent mode can access multiple knowledge bases via AgentConfig.KnowledgeBases
+ // - Knowledge base can be switched during conversation
+ isAgentMode := request.AgentConfig != nil && request.AgentConfig.Enabled
+ hasAgentKnowledgeBases := request.AgentConfig != nil && len(request.AgentConfig.KnowledgeBases) > 0
+
+ logger.Infof(
+ ctx,
+ "Processing session creation request, tenant ID: %d, knowledge base ID: %s, agent mode: %v, agent KBs: %v",
+ tenantID.(uint),
+ request.KnowledgeBaseID,
+ isAgentMode,
+ hasAgentKnowledgeBases,
+ )
+
+ // Create session object with base properties
+ createdSession := &types.Session{
+ TenantID: tenantID.(uint),
+ KnowledgeBaseID: request.KnowledgeBaseID,
+ AgentConfig: request.AgentConfig, // Set agent config if provided
+ }
+
+ // If summary model parameters are empty, set defaults
+ if request.SessionStrategy != nil {
+ createdSession.RerankModelID = request.SessionStrategy.RerankModelID
+ createdSession.SummaryModelID = request.SessionStrategy.SummaryModelID
+ createdSession.MaxRounds = request.SessionStrategy.MaxRounds
+ createdSession.EnableRewrite = request.SessionStrategy.EnableRewrite
+ createdSession.FallbackStrategy = request.SessionStrategy.FallbackStrategy
+ createdSession.FallbackResponse = request.SessionStrategy.FallbackResponse
+ createdSession.EmbeddingTopK = request.SessionStrategy.EmbeddingTopK
+ createdSession.KeywordThreshold = request.SessionStrategy.KeywordThreshold
+ createdSession.VectorThreshold = request.SessionStrategy.VectorThreshold
+ createdSession.RerankTopK = request.SessionStrategy.RerankTopK
+ createdSession.RerankThreshold = request.SessionStrategy.RerankThreshold
+ if request.SessionStrategy.SummaryParameters != nil {
+ createdSession.SummaryParameters = request.SessionStrategy.SummaryParameters
+ } else {
+ createdSession.SummaryParameters = h.createDefaultSummaryConfig()
+ }
+ h.fillSummaryConfigDefaults(createdSession.SummaryParameters)
+
+ logger.Debug(ctx, "Custom session strategy set")
+ } else {
+ // Use default configuration from global config
+ createdSession.MaxRounds = h.config.Conversation.MaxRounds
+ createdSession.EnableRewrite = h.config.Conversation.EnableRewrite
+ createdSession.FallbackStrategy = types.FallbackStrategy(h.config.Conversation.FallbackStrategy)
+ createdSession.FallbackResponse = h.config.Conversation.FallbackResponse
+ createdSession.EmbeddingTopK = h.config.Conversation.EmbeddingTopK
+ createdSession.KeywordThreshold = h.config.Conversation.KeywordThreshold
+ createdSession.VectorThreshold = h.config.Conversation.VectorThreshold
+ createdSession.RerankThreshold = h.config.Conversation.RerankThreshold
+ createdSession.RerankTopK = h.config.Conversation.RerankTopK
+ createdSession.SummaryParameters = h.createDefaultSummaryConfig()
+
+ logger.Debug(ctx, "Using default session strategy")
+ }
+
+ // Fetch knowledge base if KnowledgeBaseID is provided to inherit its model configurations
+ // If no KB is provided, models will be determined at query time or use tenant/system defaults
+ if request.KnowledgeBaseID != "" {
+ kb, err := h.knowledgebaseService.GetKnowledgeBaseByID(ctx, request.KnowledgeBaseID)
+ if err != nil {
+ logger.Error(ctx, "Failed to get knowledge base", err)
+ c.Error(errors.NewInternalServerError(err.Error()))
+ return
+ }
+
+ // Use knowledge base's models if session doesn't specify them
+ if createdSession.RerankModelID == "" {
+ createdSession.RerankModelID = kb.RerankModelID
+ }
+ if createdSession.SummaryModelID == "" {
+ createdSession.SummaryModelID = kb.SummaryModelID
+ }
+
+ logger.Debugf(ctx, "Knowledge base fetched: %s, rerank model: %s, summary model: %s",
+ kb.ID, kb.RerankModelID, kb.SummaryModelID)
+ } else {
+ logger.Debug(ctx, "No knowledge base ID provided, models will use session strategy or be determined at query time")
+ }
+
+ // Call service to create session
+ logger.Infof(ctx, "Calling session service to create session")
+ createdSession, err := h.sessionService.CreateSession(ctx, createdSession)
+ if err != nil {
+ logger.ErrorWithFields(ctx, err, nil)
+ c.Error(errors.NewInternalServerError(err.Error()))
+ return
+ }
+
+ // Return created session
+ logger.Infof(ctx, "Session created successfully, ID: %s", createdSession.ID)
+ c.JSON(http.StatusCreated, gin.H{
+ "success": true,
+ "data": createdSession,
+ })
+}
+
+// GetSession retrieves a session by its ID
+func (h *Handler) GetSession(c *gin.Context) {
+ ctx := c.Request.Context()
+
+ logger.Info(ctx, "Start retrieving session")
+
+ // Get session ID from URL parameter
+ id := c.Param("id")
+ if id == "" {
+ logger.Error(ctx, "Session ID is empty")
+ c.Error(errors.NewBadRequestError(errors.ErrInvalidSessionID.Error()))
+ return
+ }
+
+ // Call service to get session details
+ logger.Infof(ctx, "Retrieving session, ID: %s", id)
+ session, err := h.sessionService.GetSession(ctx, id)
+ if err != nil {
+ if err == errors.ErrSessionNotFound {
+ logger.Warnf(ctx, "Session not found, ID: %s", id)
+ c.Error(errors.NewNotFoundError(err.Error()))
+ return
+ }
+ logger.ErrorWithFields(ctx, err, nil)
+ c.Error(errors.NewInternalServerError(err.Error()))
+ return
+ }
+
+ // Return session data
+ logger.Infof(ctx, "Session retrieved successfully, ID: %s", id)
+ c.JSON(http.StatusOK, gin.H{
+ "success": true,
+ "data": session,
+ })
+}
+
+// GetSessionsByTenant retrieves all sessions for the current tenant with pagination
+func (h *Handler) GetSessionsByTenant(c *gin.Context) {
+ ctx := c.Request.Context()
+
+ logger.Info(ctx, "Start retrieving all sessions for tenant")
+
+ // Parse pagination parameters from query
+ var pagination types.Pagination
+ if err := c.ShouldBindQuery(&pagination); err != nil {
+ logger.Error(ctx, "Failed to parse pagination parameters", err)
+ c.Error(errors.NewBadRequestError(err.Error()))
+ return
+ }
+
+ logger.Debugf(ctx, "Using pagination parameters: page=%d, page_size=%d", pagination.Page, pagination.PageSize)
+
+ // Use paginated query to get sessions
+ result, err := h.sessionService.GetPagedSessionsByTenant(ctx, &pagination)
+ if err != nil {
+ logger.ErrorWithFields(ctx, err, nil)
+ c.Error(errors.NewInternalServerError(err.Error()))
+ return
+ }
+
+ // Return sessions with pagination data
+ logger.Infof(ctx, "Successfully retrieved tenant sessions, total: %d", result.Total)
+ c.JSON(http.StatusOK, gin.H{
+ "success": true,
+ "data": result.Data,
+ "total": result.Total,
+ "page": result.Page,
+ "page_size": result.PageSize,
+ })
+}
+
+// UpdateSession updates an existing session's properties
+func (h *Handler) UpdateSession(c *gin.Context) {
+ ctx := c.Request.Context()
+
+ logger.Info(ctx, "Start updating session")
+
+ // Get session ID from URL parameter
+ id := c.Param("id")
+ if id == "" {
+ logger.Error(ctx, "Session ID is empty")
+ c.Error(errors.NewBadRequestError(errors.ErrInvalidSessionID.Error()))
+ return
+ }
+
+ // Verify tenant ID from context for authorization
+ tenantID, exists := c.Get(types.TenantIDContextKey.String())
+ if !exists {
+ logger.Error(ctx, "Failed to get tenant ID")
+ c.Error(errors.NewUnauthorizedError("Unauthorized"))
+ return
+ }
+
+ // Parse request body to session object
+ var session types.Session
+ if err := c.ShouldBindJSON(&session); err != nil {
+ logger.Error(ctx, "Failed to parse session data", err)
+ c.Error(errors.NewBadRequestError(err.Error()))
+ return
+ }
+
+ // Set session ID and tenant ID
+ logger.Infof(ctx, "Updating session, ID: %s, tenant ID: %d", id, tenantID.(uint))
+ session.ID = id
+ session.TenantID = tenantID.(uint)
+
+ // Call service to update session
+ if err := h.sessionService.UpdateSession(ctx, &session); err != nil {
+ if err == errors.ErrSessionNotFound {
+ logger.Warnf(ctx, "Session not found, ID: %s", id)
+ c.Error(errors.NewNotFoundError(err.Error()))
+ return
+ }
+ logger.ErrorWithFields(ctx, err, nil)
+ c.Error(errors.NewInternalServerError(err.Error()))
+ return
+ }
+
+ // Return updated session
+ logger.Infof(ctx, "Session updated successfully, ID: %s", id)
+ c.JSON(http.StatusOK, gin.H{
+ "success": true,
+ "data": session,
+ })
+}
+
+// DeleteSession deletes a session by its ID
+func (h *Handler) DeleteSession(c *gin.Context) {
+ ctx := c.Request.Context()
+
+ logger.Info(ctx, "Start deleting session")
+
+ // Get session ID from URL parameter
+ id := c.Param("id")
+ if id == "" {
+ logger.Error(ctx, "Session ID is empty")
+ c.Error(errors.NewBadRequestError(errors.ErrInvalidSessionID.Error()))
+ return
+ }
+
+ // Call service to delete session
+ logger.Infof(ctx, "Deleting session, ID: %s", id)
+ if err := h.sessionService.DeleteSession(ctx, id); err != nil {
+ if err == errors.ErrSessionNotFound {
+ logger.Warnf(ctx, "Session not found, ID: %s", id)
+ c.Error(errors.NewNotFoundError(err.Error()))
+ return
+ }
+ logger.ErrorWithFields(ctx, err, nil)
+ c.Error(errors.NewInternalServerError(err.Error()))
+ return
+ }
+
+ // Return success message
+ logger.Infof(ctx, "Session deleted successfully, ID: %s", id)
+ c.JSON(http.StatusOK, gin.H{
+ "success": true,
+ "message": "Session deleted successfully",
+ })
+}
diff --git a/internal/handler/session/helpers.go b/internal/handler/session/helpers.go
new file mode 100644
index 00000000..e5fa8c8e
--- /dev/null
+++ b/internal/handler/session/helpers.go
@@ -0,0 +1,203 @@
+package session
+
+import (
+ "context"
+ "fmt"
+ "time"
+
+ "github.com/Tencent/WeKnora/internal/errors"
+ "github.com/Tencent/WeKnora/internal/event"
+ "github.com/Tencent/WeKnora/internal/logger"
+ "github.com/Tencent/WeKnora/internal/types"
+ "github.com/Tencent/WeKnora/internal/types/interfaces"
+ "github.com/gin-gonic/gin"
+)
+
+// setSSEHeaders sets the standard Server-Sent Events headers
+func setSSEHeaders(c *gin.Context) {
+ c.Header("Content-Type", "text/event-stream")
+ c.Header("Cache-Control", "no-cache")
+ c.Header("Connection", "keep-alive")
+ c.Header("X-Accel-Buffering", "no")
+}
+
+// buildStreamResponse constructs a StreamResponse from a StreamEvent
+func buildStreamResponse(evt interfaces.StreamEvent, requestID string) *types.StreamResponse {
+ response := &types.StreamResponse{
+ ID: requestID,
+ ResponseType: evt.Type,
+ Content: evt.Content,
+ Done: evt.Done,
+ Data: evt.Data,
+ }
+
+ // Extract session_id and assistant_message_id for agent_query events
+ if evt.Type == types.ResponseTypeAgentQuery {
+ if sid, ok := evt.Data["session_id"].(string); ok {
+ response.SessionID = sid
+ }
+ if amid, ok := evt.Data["assistant_message_id"].(string); ok {
+ response.AssistantMessageID = amid
+ }
+ }
+
+ // Special handling for references event
+ if evt.Type == types.ResponseTypeReferences {
+ if refs, ok := evt.Data["references"].(types.References); ok {
+ response.KnowledgeReferences = refs
+ }
+ }
+
+ return response
+}
+
+// sendCompletionEvent sends a final completion event to the client
+func sendCompletionEvent(c *gin.Context, requestID string) {
+ c.SSEvent("message", &types.StreamResponse{
+ ID: requestID,
+ ResponseType: types.ResponseTypeAnswer,
+ Content: "",
+ Done: true,
+ })
+ c.Writer.Flush()
+}
+
+// createAgentQueryEvent creates a standard agent query event
+func createAgentQueryEvent(sessionID, assistantMessageID string) interfaces.StreamEvent {
+ return interfaces.StreamEvent{
+ ID: fmt.Sprintf("query-%d", time.Now().UnixNano()),
+ Type: types.ResponseTypeAgentQuery,
+ Content: "",
+ Done: true,
+ Timestamp: time.Now(),
+ Data: map[string]interface{}{
+ "session_id": sessionID,
+ "assistant_message_id": assistantMessageID,
+ },
+ }
+}
+
+// createUserMessage creates a user message
+func (h *Handler) createUserMessage(ctx context.Context, sessionID, query, requestID string) error {
+ _, err := h.messageService.CreateMessage(ctx, &types.Message{
+ SessionID: sessionID,
+ Role: "user",
+ Content: query,
+ RequestID: requestID,
+ CreatedAt: time.Now(),
+ IsCompleted: true,
+ })
+ return err
+}
+
+// createAssistantMessage creates an assistant message
+func (h *Handler) createAssistantMessage(ctx context.Context, assistantMessage *types.Message) (*types.Message, error) {
+ assistantMessage.CreatedAt = time.Now()
+ return h.messageService.CreateMessage(ctx, assistantMessage)
+}
+
+// setupStreamHandler creates and subscribes a stream handler
+func (h *Handler) setupStreamHandler(
+ ctx context.Context,
+ sessionID, assistantMessageID, requestID string,
+ assistantMessage *types.Message,
+ eventBus *event.EventBus,
+) *AgentStreamHandler {
+ streamHandler := NewAgentStreamHandler(
+ ctx, sessionID, assistantMessageID, requestID,
+ assistantMessage, h.streamManager, eventBus,
+ )
+ streamHandler.Subscribe()
+ return streamHandler
+}
+
+// setupStopEventHandler registers a stop event handler
+func (h *Handler) setupStopEventHandler(
+ eventBus *event.EventBus,
+ sessionID string,
+ assistantMessage *types.Message,
+ cancel context.CancelFunc,
+) {
+ eventBus.On(event.EventStop, func(ctx context.Context, evt event.Event) error {
+ logger.Infof(ctx, "Received stop event, cancelling async operations for session: %s", sessionID)
+ cancel()
+ assistantMessage.Content = "用户停止了本次对话"
+ h.completeAssistantMessage(ctx, assistantMessage)
+ return nil
+ })
+}
+
+// writeAgentQueryEvent writes an agent query event to the stream manager
+func (h *Handler) writeAgentQueryEvent(ctx context.Context, sessionID, assistantMessageID string) {
+ agentQueryEvent := createAgentQueryEvent(sessionID, assistantMessageID)
+ if err := h.streamManager.AppendEvent(ctx, sessionID, assistantMessageID, agentQueryEvent); err != nil {
+ logger.ErrorWithFields(ctx, err, map[string]interface{}{
+ "session_id": sessionID,
+ "message_id": assistantMessageID,
+ })
+ // Non-fatal error, continue
+ }
+}
+
+// validateSessionAndGetID validates and extracts session ID from URL parameter
+func validateSessionID(c *gin.Context) (string, error) {
+ sessionID := c.Param("session_id")
+ if sessionID == "" {
+ return "", errors.NewBadRequestError(errors.ErrInvalidSessionID.Error())
+ }
+ return sessionID, nil
+}
+
+// getRequestID gets the request ID from gin context
+func getRequestID(c *gin.Context) string {
+ return c.GetString(types.RequestIDContextKey.String())
+}
+
+// Helper function for type assertion with default value
+func getString(m map[string]interface{}, key string) string {
+ if val, ok := m[key].(string); ok {
+ return val
+ }
+ return ""
+}
+
+func getFloat64(m map[string]interface{}, key string) float64 {
+ if val, ok := m[key].(float64); ok {
+ return val
+ }
+ if val, ok := m[key].(int); ok {
+ return float64(val)
+ }
+ return 0.0
+}
+
+// createDefaultSummaryConfig creates a default summary configuration from config
+func (h *Handler) createDefaultSummaryConfig() *types.SummaryConfig {
+ return &types.SummaryConfig{
+ MaxTokens: h.config.Conversation.Summary.MaxTokens,
+ TopP: h.config.Conversation.Summary.TopP,
+ TopK: h.config.Conversation.Summary.TopK,
+ FrequencyPenalty: h.config.Conversation.Summary.FrequencyPenalty,
+ PresencePenalty: h.config.Conversation.Summary.PresencePenalty,
+ RepeatPenalty: h.config.Conversation.Summary.RepeatPenalty,
+ Prompt: h.config.Conversation.Summary.Prompt,
+ ContextTemplate: h.config.Conversation.Summary.ContextTemplate,
+ NoMatchPrefix: h.config.Conversation.Summary.NoMatchPrefix,
+ Temperature: h.config.Conversation.Summary.Temperature,
+ Seed: h.config.Conversation.Summary.Seed,
+ MaxCompletionTokens: h.config.Conversation.Summary.MaxCompletionTokens,
+ }
+}
+
+// fillSummaryConfigDefaults fills missing fields in summary config with defaults
+func (h *Handler) fillSummaryConfigDefaults(config *types.SummaryConfig) {
+ if config.Prompt == "" {
+ config.Prompt = h.config.Conversation.Summary.Prompt
+ }
+ if config.ContextTemplate == "" {
+ config.ContextTemplate = h.config.Conversation.Summary.ContextTemplate
+ }
+ if config.NoMatchPrefix == "" {
+ config.NoMatchPrefix = h.config.Conversation.Summary.NoMatchPrefix
+ }
+}
diff --git a/internal/handler/session/qa.go b/internal/handler/session/qa.go
new file mode 100644
index 00000000..449ed72a
--- /dev/null
+++ b/internal/handler/session/qa.go
@@ -0,0 +1,450 @@
+package session
+
+import (
+ "context"
+ "net/http"
+ "time"
+
+ "github.com/Tencent/WeKnora/internal/errors"
+ "github.com/Tencent/WeKnora/internal/event"
+ "github.com/Tencent/WeKnora/internal/logger"
+ "github.com/Tencent/WeKnora/internal/types"
+ "github.com/gin-gonic/gin"
+)
+
+// SearchKnowledge performs knowledge base search without LLM summarization
+func (h *Handler) SearchKnowledge(c *gin.Context) {
+ ctx := logger.CloneContext(c.Request.Context())
+
+ logger.Info(ctx, "Start processing knowledge search request")
+
+ // Parse request body
+ var request SearchKnowledgeRequest
+ if err := c.ShouldBindJSON(&request); err != nil {
+ logger.Error(ctx, "Failed to parse request data", err)
+ c.Error(errors.NewBadRequestError(err.Error()))
+ return
+ }
+
+ // Validate request parameters
+ if request.Query == "" {
+ logger.Error(ctx, "Query content is empty")
+ c.Error(errors.NewBadRequestError("Query content cannot be empty"))
+ return
+ }
+
+ if request.KnowledgeBaseID == "" {
+ logger.Error(ctx, "Knowledge base ID is empty")
+ c.Error(errors.NewBadRequestError("Knowledge base ID cannot be empty"))
+ return
+ }
+
+ logger.Infof(
+ ctx,
+ "Knowledge search request, knowledge base ID: %s, query: %s",
+ request.KnowledgeBaseID,
+ request.Query,
+ )
+
+ // Directly call knowledge retrieval service without LLM summarization
+ searchResults, err := h.sessionService.SearchKnowledge(ctx, request.KnowledgeBaseID, request.Query)
+ if err != nil {
+ logger.ErrorWithFields(ctx, err, nil)
+ c.Error(errors.NewInternalServerError(err.Error()))
+ return
+ }
+
+ logger.Infof(ctx, "Knowledge search completed, found %d results", len(searchResults))
+
+ // Return search results
+ c.JSON(http.StatusOK, gin.H{
+ "success": true,
+ "data": searchResults,
+ })
+}
+
+// KnowledgeQA handles knowledge base question answering requests with LLM summarization
+func (h *Handler) KnowledgeQA(c *gin.Context) {
+ ctx := logger.CloneContext(c.Request.Context())
+
+ logger.Info(ctx, "Start processing knowledge QA request")
+
+ // Get session ID from URL parameter
+ sessionID := c.Param("session_id")
+ if sessionID == "" {
+ logger.Error(ctx, "Session ID is empty")
+ c.Error(errors.NewBadRequestError(errors.ErrInvalidSessionID.Error()))
+ return
+ }
+
+ // Parse request body
+ var request CreateKnowledgeQARequest
+ if err := c.ShouldBindJSON(&request); err != nil {
+ logger.Error(ctx, "Failed to parse request data", err)
+ c.Error(errors.NewBadRequestError(err.Error()))
+ return
+ }
+
+ // Create assistant message
+ assistantMessage := &types.Message{
+ SessionID: sessionID,
+ Role: "assistant",
+ RequestID: c.GetString(types.RequestIDContextKey.String()),
+ IsCompleted: false,
+ }
+
+ // Validate query content
+ if request.Query == "" {
+ logger.Error(ctx, "Query content is empty")
+ c.Error(errors.NewBadRequestError("Query content cannot be empty"))
+ return
+ }
+
+ logger.Infof(ctx, "Knowledge QA request, session ID: %s, query: %s", sessionID, request.Query)
+
+ // Get session to prepare knowledge base IDs
+ session, err := h.sessionService.GetSession(ctx, sessionID)
+ if err != nil {
+ logger.Errorf(ctx, "Failed to get session, session ID: %s, error: %v", sessionID, err)
+ c.Error(errors.NewInternalServerError(err.Error()))
+ return
+ }
+
+ // Prepare knowledge base IDs
+ knowledgeBaseIDs := request.KnowledgeBaseIDs
+ if len(knowledgeBaseIDs) == 0 && session.KnowledgeBaseID != "" {
+ knowledgeBaseIDs = []string{session.KnowledgeBaseID}
+ logger.Infof(ctx, "No knowledge base IDs in request, using session default: %s", session.KnowledgeBaseID)
+ }
+
+ // Use shared function to handle KnowledgeQA request
+ h.handleKnowledgeQARequest(ctx, c, session, request.Query, knowledgeBaseIDs, assistantMessage, true, request.SummaryModelID)
+}
+
+// AgentQA handles agent-based question answering with conversation history and streaming
+func (h *Handler) AgentQA(c *gin.Context) {
+ ctx := logger.CloneContext(c.Request.Context())
+ logger.Info(ctx, "Start processing agent QA request")
+
+ // Get session ID from URL parameter
+ sessionID := c.Param("session_id")
+ if sessionID == "" {
+ logger.Error(ctx, "Session ID is empty")
+ c.Error(errors.NewBadRequestError(errors.ErrInvalidSessionID.Error()))
+ return
+ }
+
+ // Parse request body
+ var request CreateKnowledgeQARequest
+ if err := c.ShouldBindJSON(&request); err != nil {
+ logger.Error(ctx, "Failed to parse request data", err)
+ c.Error(errors.NewBadRequestError(err.Error()))
+ return
+ }
+
+ // Validate query content
+ if request.Query == "" {
+ logger.Error(ctx, "Query content is empty")
+ c.Error(errors.NewBadRequestError("Query content cannot be empty"))
+ return
+ }
+
+ logger.Infof(ctx, "Agent QA request, session ID: %s, query: %s", sessionID, request.Query)
+
+ // Get session information first
+ session, err := h.sessionService.GetSession(ctx, sessionID)
+ if err != nil {
+ logger.Errorf(ctx, "Failed to get session, session ID: %s, error: %v", sessionID, err)
+ c.Error(errors.NewNotFoundError("Session not found"))
+ return
+ }
+
+ // Create assistant message
+ assistantMessage := &types.Message{
+ SessionID: sessionID,
+ Role: "assistant",
+ RequestID: c.GetString(types.RequestIDContextKey.String()),
+ IsCompleted: false,
+ }
+
+ // Initialize AgentConfig if it doesn't exist
+ if session.AgentConfig == nil {
+ session.AgentConfig = &types.SessionAgentConfig{}
+ }
+
+ // Detect if knowledge bases or agent mode has changed
+ knowledgeBasesChanged := false
+ configChanged := false
+
+ // Check if knowledge bases array has changed
+ if len(request.KnowledgeBaseIDs) > 0 {
+ // Compare arrays to detect changes
+ currentKBs := session.AgentConfig.KnowledgeBases
+ if len(currentKBs) != len(request.KnowledgeBaseIDs) {
+ knowledgeBasesChanged = true
+ configChanged = true
+ } else {
+ // Check if contents are different
+ kbMap := make(map[string]bool)
+ for _, kb := range currentKBs {
+ kbMap[kb] = true
+ }
+ for _, kb := range request.KnowledgeBaseIDs {
+ if !kbMap[kb] {
+ knowledgeBasesChanged = true
+ configChanged = true
+ break
+ }
+ }
+ }
+ if knowledgeBasesChanged {
+ logger.Infof(ctx, "Knowledge bases changed from %v to %v", session.AgentConfig.KnowledgeBases, request.KnowledgeBaseIDs)
+ }
+ }
+
+ // Check if agent mode has changed
+ currentAgentEnabled := session.AgentConfig.Enabled
+ if request.AgentEnabled != currentAgentEnabled {
+ logger.Infof(ctx, "Agent mode changed from %v to %v", currentAgentEnabled, request.AgentEnabled)
+ configChanged = true
+ }
+
+ // If configuration changed, clear context and update session
+ if configChanged {
+ logger.Infof(ctx, "Configuration changed, clearing context for session: %s", sessionID)
+ if knowledgeBasesChanged {
+ // Clear the LLM context to prevent contamination
+ if err := h.sessionService.ClearContext(ctx, sessionID); err != nil {
+ logger.Errorf(ctx, "Failed to clear context for session %s: %v", sessionID, err)
+ // Continue anyway - this is not a fatal error
+ }
+ }
+ session.AgentConfig.KnowledgeBases = request.KnowledgeBaseIDs
+ session.AgentConfig.Enabled = request.AgentEnabled
+ // Persist the session changes
+ if err := h.sessionService.UpdateSession(ctx, session); err != nil {
+ logger.Errorf(ctx, "Failed to update session %s: %v", sessionID, err)
+ c.Error(errors.NewInternalServerError("Failed to update session configuration"))
+ return
+ }
+ logger.Infof(ctx, "Session configuration updated successfully for session: %s", sessionID)
+ }
+
+ // If Agent mode is disabled, delegate to KnowledgeQA
+ if !request.AgentEnabled {
+ logger.Infof(ctx, "Agent mode disabled, delegating to KnowledgeQA for session: %s", sessionID)
+
+ // Use knowledge bases from request or session config
+ knowledgeBaseIDs := request.KnowledgeBaseIDs
+ if len(knowledgeBaseIDs) == 0 {
+ knowledgeBaseIDs = session.AgentConfig.KnowledgeBases
+ }
+
+ // If still empty, use session default knowledge base
+ if len(knowledgeBaseIDs) == 0 && session.KnowledgeBaseID != "" {
+ knowledgeBaseIDs = []string{session.KnowledgeBaseID}
+ logger.Infof(ctx, "Using session default knowledge base: %s", session.KnowledgeBaseID)
+ }
+
+ // Validate at least one knowledge base is available
+ if len(knowledgeBaseIDs) == 0 {
+ logger.Error(ctx, "No knowledge base available for delegation")
+ c.Error(errors.NewBadRequestError("No knowledge base available. Please configure at least one knowledge base."))
+ return
+ }
+
+ logger.Infof(ctx, "Delegating to KnowledgeQA with knowledge bases: %v", knowledgeBaseIDs)
+
+ // Use shared function to handle KnowledgeQA request (no title generation for AgentQA fallback)
+ h.handleKnowledgeQARequest(ctx, c, session, request.Query, knowledgeBaseIDs, assistantMessage, false, request.SummaryModelID)
+ return
+ }
+
+ // Emit agent query event to create user message
+ requestID := c.GetString(types.RequestIDContextKey.String())
+ if err := event.Emit(ctx, event.Event{
+ Type: event.EventAgentQuery,
+ SessionID: sessionID,
+ RequestID: requestID,
+ Data: event.AgentQueryData{
+ SessionID: sessionID,
+ Query: request.Query,
+ RequestID: requestID,
+ },
+ }); err != nil {
+ logger.Errorf(ctx, "Failed to emit agent query event: %v", err)
+ return
+ }
+
+ // Set headers for SSE immediately
+ setSSEHeaders(c)
+
+ // Create user message
+ if err := h.createUserMessage(ctx, sessionID, request.Query, requestID); err != nil {
+ c.Error(errors.NewInternalServerError(err.Error()))
+ return
+ }
+
+ // Create assistant message (response)
+ assistantMessagePtr, err := h.createAssistantMessage(ctx, assistantMessage)
+ if err != nil {
+ c.Error(errors.NewInternalServerError(err.Error()))
+ return
+ }
+ assistantMessage = assistantMessagePtr
+
+ logger.Infof(ctx, "Calling agent QA service, session ID: %s", sessionID)
+
+ // Write initial agent_query event to StreamManager
+ h.writeAgentQueryEvent(ctx, sessionID, assistantMessage.ID)
+
+ eventBus := event.NewEventBus()
+ // Create cancellable context for async operations
+ asyncCtx, cancel := context.WithCancel(logger.CloneContext(ctx))
+ // Create and subscribe stream handler
+ h.setupStreamHandler(asyncCtx, sessionID, assistantMessage.ID, requestID, assistantMessage, eventBus)
+
+ // Start async title generation if session has no title
+ if session.Title == "" {
+ logger.Infof(ctx, "Session has no title, starting async title generation, session ID: %s", sessionID)
+ h.sessionService.GenerateTitleAsync(asyncCtx, session, request.Query, eventBus)
+ }
+
+ // Register stop event handler to cancel the context
+ h.setupStopEventHandler(eventBus, sessionID, assistantMessage, cancel)
+
+ go func() {
+ defer func() {
+ if r := recover(); r != nil {
+ logger.ErrorWithFields(asyncCtx, errors.NewInternalServerError("Agent QA service panicked"), nil)
+ }
+ h.completeAssistantMessage(asyncCtx, assistantMessage)
+ logger.Infof(asyncCtx, "Agent QA service completed for session: %s", sessionID)
+ }()
+ err := h.sessionService.AgentQA(asyncCtx, session, request.Query, assistantMessage.ID, eventBus)
+ if err != nil {
+ logger.ErrorWithFields(asyncCtx, err, nil)
+ // Emit error event to dedicated EventBus
+ eventBus.Emit(asyncCtx, event.Event{
+ Type: event.EventError,
+ SessionID: sessionID,
+ Data: event.ErrorData{
+ Error: err.Error(),
+ Stage: "agent_execution",
+ SessionID: sessionID,
+ },
+ })
+ return
+ }
+ }()
+
+ // Handle events for SSE (blocking until connection is done)
+ h.handleAgentEventsForSSE(ctx, c, sessionID, assistantMessage.ID, requestID, eventBus)
+}
+
+// handleKnowledgeQARequest handles a KnowledgeQA request with the given parameters
+// This is a shared function used by both KnowledgeQA endpoint and AgentQA fallback
+func (h *Handler) handleKnowledgeQARequest(
+ ctx context.Context,
+ c *gin.Context,
+ session *types.Session,
+ query string,
+ knowledgeBaseIDs []string,
+ assistantMessage *types.Message,
+ generateTitle bool, // Whether to generate title if session has no title
+ summaryModelID string, // Optional summary model ID (overrides session default)
+) {
+ sessionID := session.ID
+ requestID := getRequestID(c)
+
+ // Create user message
+ if err := h.createUserMessage(ctx, sessionID, query, requestID); err != nil {
+ c.Error(errors.NewInternalServerError(err.Error()))
+ return
+ }
+
+ // Create assistant message (response)
+ if _, err := h.createAssistantMessage(ctx, assistantMessage); err != nil {
+ c.Error(errors.NewInternalServerError(err.Error()))
+ return
+ }
+
+ // Validate knowledge bases
+ if len(knowledgeBaseIDs) == 0 {
+ logger.Error(ctx, "No knowledge base ID available")
+ c.Error(errors.NewBadRequestError("At least one knowledge base ID is required"))
+ return
+ }
+
+ logger.Infof(ctx, "Using knowledge bases: %v", knowledgeBaseIDs)
+
+ // Set headers for SSE
+ setSSEHeaders(c)
+
+ // Write initial agent_query event to StreamManager
+ h.writeAgentQueryEvent(ctx, sessionID, assistantMessage.ID)
+
+ // Create dedicated EventBus for this request
+ eventBus := event.NewEventBus()
+ // Create cancellable context for async operations
+ asyncCtx, cancel := context.WithCancel(logger.CloneContext(ctx))
+
+ // Register stop event handler and setup stream handler
+ h.setupStopEventHandler(eventBus, sessionID, assistantMessage, cancel)
+ h.setupStreamHandler(asyncCtx, sessionID, assistantMessage.ID, requestID, assistantMessage, eventBus)
+
+ // Generate title if needed
+ if generateTitle && session.Title == "" {
+ logger.Infof(ctx, "Session has no title, starting async title generation, session ID: %s", sessionID)
+ h.sessionService.GenerateTitleAsync(asyncCtx, session, query, eventBus)
+ }
+
+ eventBus.On(event.EventAgentFinalAnswer, func(ctx context.Context, evt event.Event) error {
+ data, ok := evt.Data.(event.AgentFinalAnswerData)
+ if !ok {
+ return nil
+ }
+ assistantMessage.Content += data.Content
+ if data.Done {
+ logger.Infof(asyncCtx, "Knowledge QA service completed for session: %s", sessionID)
+ h.completeAssistantMessage(asyncCtx, assistantMessage)
+ cancel() // Clean up context
+ return nil
+ }
+ return nil
+ })
+
+ // Call service to perform knowledge QA (async, emits events)
+ go func() {
+ defer func() {
+ if r := recover(); r != nil {
+ logger.ErrorWithFields(asyncCtx, errors.NewInternalServerError("Knowledge QA service panicked"), nil)
+ }
+ }()
+ err := h.sessionService.KnowledgeQA(asyncCtx, session, query, knowledgeBaseIDs, assistantMessage.ID, summaryModelID, eventBus)
+ if err != nil {
+ logger.ErrorWithFields(asyncCtx, err, nil)
+ // Emit error event to dedicated EventBus
+ eventBus.Emit(asyncCtx, event.Event{
+ Type: event.EventError,
+ SessionID: sessionID,
+ Data: event.ErrorData{
+ Error: err.Error(),
+ Stage: "knowledge_qa_execution",
+ SessionID: sessionID,
+ },
+ })
+ return
+ }
+ }()
+
+ // Handle events for SSE (blocking until connection is done)
+ h.handleAgentEventsForSSE(ctx, c, sessionID, assistantMessage.ID, requestID, eventBus)
+}
+
+// completeAssistantMessage marks an assistant message as complete and updates it
+func (h *Handler) completeAssistantMessage(ctx context.Context, assistantMessage *types.Message) {
+ assistantMessage.UpdatedAt = time.Now()
+ assistantMessage.IsCompleted = true
+ _ = h.messageService.UpdateMessage(ctx, assistantMessage)
+}
diff --git a/internal/handler/session/stream.go b/internal/handler/session/stream.go
new file mode 100644
index 00000000..04701a05
--- /dev/null
+++ b/internal/handler/session/stream.go
@@ -0,0 +1,363 @@
+package session
+
+import (
+ "context"
+ "fmt"
+ "net/http"
+ "time"
+
+ "github.com/Tencent/WeKnora/internal/errors"
+ "github.com/Tencent/WeKnora/internal/event"
+ "github.com/Tencent/WeKnora/internal/logger"
+ "github.com/Tencent/WeKnora/internal/types"
+ "github.com/Tencent/WeKnora/internal/types/interfaces"
+ "github.com/gin-gonic/gin"
+)
+
+// ContinueStream handles continued streaming of an active response stream
+func (h *Handler) ContinueStream(c *gin.Context) {
+ ctx := c.Request.Context()
+
+ logger.Info(ctx, "Start continuing stream response processing")
+
+ // Get session ID from URL parameter
+ sessionID := c.Param("session_id")
+ if sessionID == "" {
+ logger.Error(ctx, "Session ID is empty")
+ c.Error(errors.NewBadRequestError(errors.ErrInvalidSessionID.Error()))
+ return
+ }
+
+ // Get message ID from query parameter
+ messageID := c.Query("message_id")
+ if messageID == "" {
+ logger.Error(ctx, "Message ID is empty")
+ c.Error(errors.NewBadRequestError("Missing message ID"))
+ return
+ }
+
+ logger.Infof(ctx, "Continuing stream, session ID: %s, message ID: %s", sessionID, messageID)
+
+ // Verify that the session exists and belongs to this tenant
+ _, err := h.sessionService.GetSession(ctx, sessionID)
+ if err != nil {
+ if err == errors.ErrSessionNotFound {
+ logger.Warnf(ctx, "Session not found, ID: %s", sessionID)
+ c.Error(errors.NewNotFoundError(err.Error()))
+ } else {
+ logger.ErrorWithFields(ctx, err, nil)
+ c.Error(errors.NewInternalServerError(err.Error()))
+ }
+ return
+ }
+
+ // Get the incomplete message
+ message, err := h.messageService.GetMessage(ctx, sessionID, messageID)
+ if err != nil {
+ logger.ErrorWithFields(ctx, err, nil)
+ c.Error(errors.NewInternalServerError(err.Error()))
+ return
+ }
+
+ if message == nil {
+ logger.Warnf(ctx, "Incomplete message not found, session ID: %s, message ID: %s", sessionID, messageID)
+ c.JSON(http.StatusNotFound, gin.H{
+ "success": false,
+ "error": "Incomplete message not found",
+ })
+ return
+ }
+
+ // Get initial events from stream (offset 0)
+ events, currentOffset, err := h.streamManager.GetEvents(ctx, sessionID, messageID, 0)
+ if err != nil {
+ logger.ErrorWithFields(ctx, err, nil)
+ c.Error(errors.NewInternalServerError(fmt.Sprintf("Failed to get stream data: %s", err.Error())))
+ return
+ }
+
+ if len(events) == 0 {
+ logger.Warnf(ctx, "No events found in stream, session ID: %s, message ID: %s", sessionID, messageID)
+ c.JSON(http.StatusNotFound, gin.H{
+ "success": false,
+ "error": "No stream events found",
+ })
+ return
+ }
+
+ logger.Infof(
+ ctx, "Preparing to replay %d events and continue streaming, session ID: %s, message ID: %s",
+ len(events), sessionID, messageID,
+ )
+
+ // Set headers for SSE
+ setSSEHeaders(c)
+
+ // Check if stream is already completed
+ streamCompleted := false
+ for _, evt := range events {
+ if evt.Type == "complete" {
+ streamCompleted = true
+ break
+ }
+ }
+
+ // Replay existing events
+ logger.Debugf(ctx, "Replaying %d existing events", len(events))
+ for _, evt := range events {
+ response := buildStreamResponse(evt, message.RequestID)
+ c.SSEvent("message", response)
+ c.Writer.Flush()
+ }
+
+ // If stream is already completed, send final event and return
+ if streamCompleted {
+ logger.Infof(ctx, "Stream already completed, session ID: %s, message ID: %s", sessionID, messageID)
+ sendCompletionEvent(c, message.RequestID)
+ return
+ }
+
+ // Continue polling for new events
+ logger.Debug(ctx, "Starting event update monitoring")
+ ticker := time.NewTicker(100 * time.Millisecond)
+ defer ticker.Stop()
+
+ for {
+ select {
+ case <-c.Request.Context().Done():
+ logger.Debug(ctx, "Client connection closed")
+ return
+
+ case <-ticker.C:
+ // Get new events from current offset
+ newEvents, newOffset, err := h.streamManager.GetEvents(ctx, sessionID, messageID, currentOffset)
+ if err != nil {
+ logger.Errorf(ctx, "Failed to get new events: %v", err)
+ return
+ }
+
+ // Send new events
+ streamCompletedNow := false
+ for _, evt := range newEvents {
+ // Check for completion event
+ if evt.Type == "complete" {
+ streamCompletedNow = true
+ }
+
+ response := buildStreamResponse(evt, message.RequestID)
+ c.SSEvent("message", response)
+ c.Writer.Flush()
+ }
+
+ // Update offset
+ currentOffset = newOffset
+
+ // If stream completed, send final event and exit
+ if streamCompletedNow {
+ logger.Infof(ctx, "Stream completed, session ID: %s, message ID: %s", sessionID, messageID)
+ sendCompletionEvent(c, message.RequestID)
+ return
+ }
+ }
+ }
+}
+
+// StopSession handles the stop generation request
+func (h *Handler) StopSession(c *gin.Context) {
+ ctx := logger.CloneContext(c.Request.Context())
+ sessionID := c.Param("session_id")
+
+ if sessionID == "" {
+ c.JSON(400, gin.H{"error": "Session ID is required"})
+ return
+ }
+
+ // Parse request body to get message_id
+ var req StopSessionRequest
+ if err := c.ShouldBindJSON(&req); err != nil {
+ logger.ErrorWithFields(ctx, err, map[string]interface{}{
+ "session_id": sessionID,
+ })
+ c.JSON(400, gin.H{"error": "message_id is required"})
+ return
+ }
+
+ assistantMessageID := req.MessageID
+ logger.Infof(ctx, "Stop generation request for session: %s, message: %s", sessionID, assistantMessageID)
+
+ // Get tenant ID from context
+ tenantID, exists := c.Get(types.TenantIDContextKey.String())
+ if !exists {
+ logger.Error(ctx, "Failed to get tenant ID")
+ c.JSON(401, gin.H{"error": "Unauthorized"})
+ return
+ }
+ tenantIDUint := tenantID.(uint)
+
+ // Verify message ownership and status
+ message, err := h.messageService.GetMessage(ctx, sessionID, assistantMessageID)
+ if err != nil {
+ logger.ErrorWithFields(ctx, err, map[string]interface{}{
+ "session_id": sessionID,
+ "message_id": assistantMessageID,
+ })
+ c.JSON(404, gin.H{"error": "Message not found"})
+ return
+ }
+
+ // Verify message belongs to this session (double check)
+ if message.SessionID != sessionID {
+ logger.Warnf(ctx, "Message %s does not belong to session %s", assistantMessageID, sessionID)
+ c.JSON(403, gin.H{"error": "Message does not belong to this session"})
+ return
+ }
+
+ // Verify message belongs to the current tenant
+ session, err := h.sessionService.GetSession(ctx, sessionID)
+ if err != nil {
+ logger.ErrorWithFields(ctx, err, map[string]interface{}{
+ "session_id": sessionID,
+ })
+ c.JSON(404, gin.H{"error": "Session not found"})
+ return
+ }
+
+ if session.TenantID != tenantIDUint {
+ logger.Warnf(ctx, "Session %s does not belong to tenant %d", sessionID, tenantIDUint)
+ c.JSON(403, gin.H{"error": "Access denied"})
+ return
+ }
+
+ // Check if message is already completed (stopped)
+ if message.IsCompleted {
+ logger.Infof(ctx, "Message %s is already completed, no need to stop", assistantMessageID)
+ c.JSON(200, gin.H{
+ "success": true,
+ "message": "Message already completed",
+ })
+ return
+ }
+
+ // Write stop event to StreamManager for distributed support
+ stopEvent := interfaces.StreamEvent{
+ ID: fmt.Sprintf("stop-%d", time.Now().UnixNano()),
+ Type: types.ResponseType(event.EventStop),
+ Content: "",
+ Done: true,
+ Timestamp: time.Now(),
+ Data: map[string]interface{}{
+ "session_id": sessionID,
+ "message_id": assistantMessageID,
+ "reason": "user_requested",
+ },
+ }
+
+ if err := h.streamManager.AppendEvent(ctx, sessionID, assistantMessageID, stopEvent); err != nil {
+ logger.ErrorWithFields(ctx, err, map[string]interface{}{
+ "session_id": sessionID,
+ "message_id": assistantMessageID,
+ })
+ c.JSON(500, gin.H{"error": "Failed to write stop event"})
+ return
+ }
+
+ logger.Infof(ctx, "Stop event written successfully for session: %s, message: %s", sessionID, assistantMessageID)
+ c.JSON(200, gin.H{
+ "success": true,
+ "message": "Generation stopped",
+ })
+}
+
+// handleAgentEventsForSSE handles agent events for SSE streaming using an existing handler
+// The handler is already subscribed to events and AgentQA is already running
+// This function polls StreamManager and pushes events to SSE, allowing graceful handling of disconnections
+func (h *Handler) handleAgentEventsForSSE(
+ ctx context.Context,
+ c *gin.Context,
+ sessionID, assistantMessageID, requestID string,
+ eventBus *event.EventBus,
+) {
+ ticker := time.NewTicker(100 * time.Millisecond)
+ defer ticker.Stop()
+
+ lastOffset := 0
+ log := logger.GetLogger(ctx)
+
+ log.Infof("Starting pull-based SSE streaming for session=%s, message=%s", sessionID, assistantMessageID)
+
+ for {
+ select {
+ case <-c.Request.Context().Done():
+ // Connection closed, exit gracefully without panic
+ log.Infof("Client disconnected, stopping SSE streaming for session=%s, message=%s", sessionID, assistantMessageID)
+ return
+
+ case <-ticker.C:
+ // Get new events from StreamManager using offset
+ events, newOffset, err := h.streamManager.GetEvents(ctx, sessionID, assistantMessageID, lastOffset)
+ if err != nil {
+ log.Warnf("Failed to get events from stream: %v", err)
+ continue
+ }
+
+ // Send any new events
+ streamCompleted := false
+ for _, evt := range events {
+ // Check for stop event
+ if evt.Type == types.ResponseType(event.EventStop) {
+ log.Infof("Detected stop event, triggering stop via EventBus for session=%s", sessionID)
+
+ // Emit stop event to the EventBus to trigger context cancellation
+ if eventBus != nil {
+ eventBus.Emit(ctx, event.Event{
+ Type: event.EventStop,
+ SessionID: sessionID,
+ Data: event.StopData{
+ SessionID: sessionID,
+ MessageID: assistantMessageID,
+ Reason: "user_requested",
+ },
+ })
+ }
+
+ // Send stop notification to frontend
+ c.SSEvent("message", &types.StreamResponse{
+ ID: requestID,
+ ResponseType: "stop",
+ Content: "Generation stopped by user",
+ Done: true,
+ })
+ c.Writer.Flush()
+ return
+ }
+
+ // Build StreamResponse from StreamEvent
+ response := buildStreamResponse(evt, requestID)
+
+ // Check for completion event
+ if evt.Type == "complete" {
+ streamCompleted = true
+ }
+
+ // Check if connection is still alive before writing
+ if c.Request.Context().Err() != nil {
+ log.Info("Connection closed during event sending, stopping")
+ return
+ }
+
+ c.SSEvent("message", response)
+ c.Writer.Flush()
+ }
+
+ // Update offset
+ lastOffset = newOffset
+
+ // Check if stream is completed
+ if streamCompleted {
+ log.Infof("Stream completed for session=%s, message=%s", sessionID, assistantMessageID)
+ sendCompletionEvent(c, requestID)
+ return
+ }
+ }
+ }
+}
diff --git a/internal/handler/session/title.go b/internal/handler/session/title.go
new file mode 100644
index 00000000..82cffc3c
--- /dev/null
+++ b/internal/handler/session/title.go
@@ -0,0 +1,56 @@
+package session
+
+import (
+ "net/http"
+
+ "github.com/Tencent/WeKnora/internal/errors"
+ "github.com/Tencent/WeKnora/internal/logger"
+ "github.com/gin-gonic/gin"
+)
+
+// GenerateTitle generates a title for a session based on message content
+func (h *Handler) GenerateTitle(c *gin.Context) {
+ ctx := c.Request.Context()
+
+ logger.Info(ctx, "Start generating session title")
+
+ // Get session ID from URL parameter
+ sessionID := c.Param("session_id")
+ if sessionID == "" {
+ logger.Error(ctx, "Session ID is empty")
+ c.Error(errors.NewBadRequestError(errors.ErrInvalidSessionID.Error()))
+ return
+ }
+
+ // Parse request body
+ var request GenerateTitleRequest
+ if err := c.ShouldBindJSON(&request); err != nil {
+ logger.Error(ctx, "Failed to parse request data", err)
+ c.Error(errors.NewBadRequestError(err.Error()))
+ return
+ }
+
+ // Get session from database
+ session, err := h.sessionService.GetSession(ctx, sessionID)
+ if err != nil {
+ logger.ErrorWithFields(ctx, err, nil)
+ c.Error(errors.NewInternalServerError(err.Error()))
+ return
+ }
+
+ // Call service to generate title
+ logger.Infof(ctx, "Generating session title, session ID: %s, message count: %d", sessionID, len(request.Messages))
+ title, err := h.sessionService.GenerateTitle(ctx, session, request.Messages)
+ if err != nil {
+ logger.ErrorWithFields(ctx, err, nil)
+ c.Error(errors.NewInternalServerError(err.Error()))
+ return
+ }
+
+ // Return generated title
+ logger.Infof(ctx, "Session title generated successfully, session ID: %s, title: %s", sessionID, title)
+ c.JSON(http.StatusOK, gin.H{
+ "success": true,
+ "data": title,
+ })
+}
diff --git a/internal/handler/session/types.go b/internal/handler/session/types.go
new file mode 100644
index 00000000..5f1c642d
--- /dev/null
+++ b/internal/handler/session/types.go
@@ -0,0 +1,71 @@
+package session
+
+import (
+ "github.com/Tencent/WeKnora/internal/types"
+)
+
+// SessionStrategy defines the configuration for a conversation session strategy
+type SessionStrategy struct {
+ // Maximum number of conversation rounds to maintain
+ MaxRounds int `json:"max_rounds"`
+ // Whether to enable query rewrite for multi-round conversations
+ EnableRewrite bool `json:"enable_rewrite"`
+ // Strategy to use when no relevant knowledge is found
+ FallbackStrategy types.FallbackStrategy `json:"fallback_strategy"`
+ // Fixed response content for fallback
+ FallbackResponse string `json:"fallback_response"`
+ // Number of top results to retrieve from vector search
+ EmbeddingTopK int `json:"embedding_top_k"`
+ // Threshold for keyword-based retrieval
+ KeywordThreshold float64 `json:"keyword_threshold"`
+ // Threshold for vector-based retrieval
+ VectorThreshold float64 `json:"vector_threshold"`
+ // ID of the model used for reranking results
+ RerankModelID string `json:"rerank_model_id"`
+ // Number of top results after reranking
+ RerankTopK int `json:"rerank_top_k"`
+ // Threshold for reranking results
+ RerankThreshold float64 `json:"rerank_threshold"`
+ // ID of the model used for summarization
+ SummaryModelID string `json:"summary_model_id"`
+ // Parameters for the summary model
+ SummaryParameters *types.SummaryConfig `json:"summary_parameters" gorm:"type:json"`
+ // Prefix for responses when no match is found
+ NoMatchPrefix string `json:"no_match_prefix"`
+}
+
+// CreateSessionRequest represents a request to create a new session
+// Sessions are now knowledge-base-independent and serve as conversation containers.
+// Knowledge bases can be specified dynamically in each query request (AgentQA/KnowledgeQA).
+type CreateSessionRequest struct {
+ // ID of the associated knowledge base (optional, can be set/changed during queries)
+ KnowledgeBaseID string `json:"knowledge_base_id"`
+ // Session strategy configuration
+ SessionStrategy *SessionStrategy `json:"session_strategy"`
+ // Agent configuration (optional, session-level config only: enabled and knowledge_bases)
+ AgentConfig *types.SessionAgentConfig `json:"agent_config"`
+}
+
+// GenerateTitleRequest defines the request structure for generating a session title
+type GenerateTitleRequest struct {
+ Messages []types.Message `json:"messages" binding:"required"` // Messages to use as context for title generation
+}
+
+// CreateKnowledgeQARequest defines the request structure for knowledge QA
+type CreateKnowledgeQARequest struct {
+ Query string `json:"query" binding:"required"` // Query text for knowledge base search
+ KnowledgeBaseIDs []string `json:"knowledge_base_ids"` // Selected knowledge base ID for this request
+ AgentEnabled bool `json:"agent_enabled"` // Whether agent mode is enabled for this request
+ SummaryModelID string `json:"summary_model_id"` // Optional summary model ID for this request (overrides session default)
+}
+
+// SearchKnowledgeRequest defines the request structure for searching knowledge without LLM summarization
+type SearchKnowledgeRequest struct {
+ Query string `json:"query" binding:"required"` // Query text to search for
+ KnowledgeBaseID string `json:"knowledge_base_id" binding:"required"` // ID of the knowledge base to search
+}
+
+// StopSessionRequest represents the stop session request
+type StopSessionRequest struct {
+ MessageID string `json:"message_id" binding:"required"`
+}
diff --git a/internal/handler/tenant.go b/internal/handler/tenant.go
index 8acff2d4..281ac350 100644
--- a/internal/handler/tenant.go
+++ b/internal/handler/tenant.go
@@ -280,10 +280,9 @@ func (h *TenantHandler) GetTenantAgentConfig(c *gin.Context) {
c.JSON(http.StatusOK, gin.H{
"success": true,
"data": gin.H{
- "enabled": false,
- "max_iterations": 5,
+ "max_iterations": 20,
"reflection_enabled": false,
- "allowed_tools": []string{"knowledge_search", "knowledge_search"},
+ "allowed_tools": []string{"thinking", "todo_write", "knowledge_search", "get_related_chunks", "query_knowledge_graph", "get_document_info", "database_query"},
"temperature": 0.7,
"thinking_model_id": "",
"rerank_model_id": "",
diff --git a/internal/router/router.go b/internal/router/router.go
index f0446acc..65b42e6b 100644
--- a/internal/router/router.go
+++ b/internal/router/router.go
@@ -9,6 +9,7 @@ import (
"github.com/Tencent/WeKnora/internal/config"
"github.com/Tencent/WeKnora/internal/handler"
+ "github.com/Tencent/WeKnora/internal/handler/session"
"github.com/Tencent/WeKnora/internal/middleware"
"github.com/Tencent/WeKnora/internal/types/interfaces"
)
@@ -31,7 +32,7 @@ type RouterParams struct {
TenantHandler *handler.TenantHandler
TenantService interfaces.TenantService
ChunkHandler *handler.ChunkHandler
- SessionHandler *handler.SessionHandler
+ SessionHandler *session.Handler
MessageHandler *handler.MessageHandler
ModelHandler *handler.ModelHandler
EvaluationHandler *handler.EvaluationHandler
@@ -171,7 +172,7 @@ func RegisterMessageRoutes(r *gin.RouterGroup, handler *handler.MessageHandler)
}
// RegisterSessionRoutes 注册路由
-func RegisterSessionRoutes(r *gin.RouterGroup, handler *handler.SessionHandler) {
+func RegisterSessionRoutes(r *gin.RouterGroup, handler *session.Handler) {
sessions := r.Group("/sessions")
{
sessions.POST("", handler.CreateSession)
@@ -187,7 +188,7 @@ func RegisterSessionRoutes(r *gin.RouterGroup, handler *handler.SessionHandler)
}
// RegisterChatRoutes 注册路由
-func RegisterChatRoutes(r *gin.RouterGroup, handler *handler.SessionHandler) {
+func RegisterChatRoutes(r *gin.RouterGroup, handler *session.Handler) {
knowledgeChat := r.Group("/knowledge-chat")
{
knowledgeChat.POST("/:session_id", handler.KnowledgeQA)
diff --git a/internal/types/interfaces/session.go b/internal/types/interfaces/session.go
index abd088d6..dbd04b60 100644
--- a/internal/types/interfaces/session.go
+++ b/internal/types/interfaces/session.go
@@ -28,9 +28,10 @@ type SessionService interface {
GenerateTitleAsync(ctx context.Context, session *types.Session, userQuery string, eventBus *event.EventBus)
// KnowledgeQA performs knowledge-based question answering
// knowledgeBaseIDs: list of knowledge base IDs to search (supports multi-KB)
+ // summaryModelID: optional summary model ID override (if empty, uses session/KB default)
// Events are emitted through eventBus (references, answer chunks, completion)
KnowledgeQA(ctx context.Context,
- session *types.Session, query string, knowledgeBaseIDs []string, assistantMessageID string, eventBus *event.EventBus,
+ session *types.Session, query string, knowledgeBaseIDs []string, assistantMessageID string, summaryModelID string, eventBus *event.EventBus,
) error
// KnowledgeQAByEvent performs knowledge-based question answering by event
KnowledgeQAByEvent(ctx context.Context, chatManage *types.ChatManage, eventList []types.EventType) error
diff --git a/internal/types/model.go b/internal/types/model.go
index d70fada0..f6542604 100644
--- a/internal/types/model.go
+++ b/internal/types/model.go
@@ -45,6 +45,7 @@ type ModelParameters struct {
BaseURL string `yaml:"base_url" json:"base_url"`
APIKey string `yaml:"api_key" json:"api_key"`
EmbeddingParameters EmbeddingParameters `yaml:"embedding_parameters" json:"embedding_parameters"`
+ ParameterSize string `yaml:"parameter_size" json:"parameter_size"` // Ollama model parameter size (e.g., "7B", "13B", "70B")
}
// Model represents the AI model
diff --git a/scripts/dev.sh b/scripts/dev.sh
index 899ca60f..169e9c0f 100755
--- a/scripts/dev.sh
+++ b/scripts/dev.sh
@@ -122,8 +122,8 @@ start_services() {
echo " - Jaeger: localhost:16686"
echo ""
log_info "接下来的步骤:"
- printf "%b\n" "${YELLOW}1. 在新终端运行后端:${NC} cd $PROJECT_ROOT && ./scripts/dev.sh app"
- printf "%b\n" "${YELLOW}2. 在新终端运行前端:${NC} cd $PROJECT_ROOT && ./scripts/dev.sh frontend"
+ printf "%b\n" "${YELLOW}1. 在新终端运行后端:${NC} make dev-app"
+ printf "%b\n" "${YELLOW}2. 在新终端运行前端:${NC} make dev-frontend"
return 0
else
log_error "服务启动失败"
@@ -219,7 +219,7 @@ start_app() {
else
log_info "未检测到 Air,使用普通模式启动"
log_warning "提示: 安装 Air 可以实现代码修改后自动重启"
- log_info "安装命令: go install github.com/cosmtrek/air@latest"
+ log_info "安装命令: go install github.com/air-verse/air@latest"
# 运行应用
go run cmd/server/main.go
fi