package services import ( "context" "fmt" "strings" "time" "agent-desk/internal/ai" "agent-desk/internal/events" "agent-desk/internal/models" "agent-desk/internal/pkg/enums" "agent-desk/internal/pkg/errorsx" "agent-desk/internal/pkg/eventbus" "agent-desk/internal/pkg/i18nx" "agent-desk/internal/repositories" "github.com/mlogclub/simple/sqls" ) var ConversationHumanDispatchService = newConversationHumanDispatchService() var ( HandoffWaitingMessage = HandoffWaitingMessageForLocale(i18nx.DefaultLocale) HandoffOffHoursMessage = HandoffOffHoursMessageForLocale(i18nx.DefaultLocale) ) func HandoffWaitingMessageForLocale(locale string) string { return i18nx.Getf(locale, "conversation.handoff.waiting") } func HandoffOffHoursMessageForLocale(locale string) string { return i18nx.Getf(locale, "conversation.handoff.offHours") } type HandoffDecisionType string const ( HandoffDecisionAssigned HandoffDecisionType = "assigned" HandoffDecisionTeamPool HandoffDecisionType = "team_pool" HandoffDecisionGlobalPool HandoffDecisionType = "global_pool" HandoffDecisionOffHours HandoffDecisionType = "off_hours" ) type HandoffDecisionResult struct { Decision HandoffDecisionType TeamID int64 AssigneeID int64 Message string } type conversationHumanDispatchService struct{} func newConversationHumanDispatchService() *conversationHumanDispatchService { return &conversationHumanDispatchService{} } func (s *conversationHumanDispatchService) ResolveConversationLocale(conversationID int64) string { if conversationID <= 0 { return i18nx.DefaultLocale } recentMsgs := repositories.MessageRepository.Find(sqls.DB(), sqls.NewCnd(). Eq("conversation_id", conversationID). Eq("sender_type", enums.IMSenderTypeCustomer). Desc("id"). Limit(5)) for _, msg := range recentMsgs { content := strings.TrimSpace(msg.Content) if content == "" { continue } lang := ai.DetectLanguage(content) switch lang { case "ru": return "ru-RU" case "zh": return "zh-CN" } } for _, msg := range recentMsgs { if ai.DetectLanguage(msg.Content) == "en" { return "en-US" } } conv := repositories.ConversationRepository.Get(sqls.DB(), conversationID) if conv != nil { if ai.IsCyrillic(conv.CustomerName) || ai.IsCyrillic(conv.Subject) { return "ru-RU" } if ai.IsHan(conv.CustomerName) || ai.IsHan(conv.Subject) { return "zh-CN" } } return i18nx.DefaultLocale } func ResolveConversationLocale(conversationID int64) string { return ConversationHumanDispatchService.ResolveConversationLocale(conversationID) } func (s *conversationHumanDispatchService) TryOffHoursHandoffByAI(conversationID int64, aiAgent models.AIAgent, reason string) (bool, error) { return s.TryOffHoursHandoffByAIWithRequestID(conversationID, aiAgent, reason, "") } func (s *conversationHumanDispatchService) TryOffHoursHandoffByAIWithRequestID(conversationID int64, aiAgent models.AIAgent, reason string, requestID string) (bool, error) { conversation := ConversationService.Get(conversationID) if conversation == nil { return false, errorsx.InvalidParamI18n("error.e0116") } teamIDs := resolveDispatchTeamIDs(aiAgent.TeamIDs) activeTeamIDs := ConversationDispatchService.findActiveScheduleTeamIDs(teamIDs, time.Now()) if len(activeTeamIDs) > 0 { return false, nil } if err := s.markHandoff(conversationID, aiAgent, reason, requestID); err != nil { return true, err } var queuedConversation *models.Conversation var poolErr error if len(teamIDs) > 0 { queuedConversation, poolErr = s.moveToTeamPoolWithRequestID(conversationID, teamIDs[0], reason, requestID) } else { poolErr = s.moveToGlobalPool(conversationID, aiAgent.Name) queuedConversation = ConversationService.Get(conversationID) } if poolErr != nil { return true, poolErr } if queuedConversation != nil { WsService.PublishConversationChanged(queuedConversation, enums.IMRealtimeEventConversationUpdated) } offHoursMessage := strings.TrimSpace(aiAgent.OffHoursMessage) if offHoursMessage == "" { offHoursMessage = HandoffOffHoursMessageForLocale(s.ResolveConversationLocale(conversationID)) } if err := s.sendAITextWithRequestID(conversationID, aiAgent.ID, offHoursMessage, requestID); err != nil { return true, err } return true, nil } func (s *conversationHumanDispatchService) HandoffByAI(conversationID int64, aiAgent models.AIAgent, reason string) (*HandoffDecisionResult, error) { return s.HandoffByAIWithRequestID(conversationID, aiAgent, reason, "") } func (s *conversationHumanDispatchService) HandoffByAIWithRequestID(conversationID int64, aiAgent models.AIAgent, reason string, requestID string) (*HandoffDecisionResult, error) { conversation := ConversationService.Get(conversationID) if conversation == nil { return nil, errorsx.InvalidParamI18n("error.e0116") } teamIDs := resolveDispatchTeamIDs(aiAgent.TeamIDs) activeTeamIDs := ConversationDispatchService.findActiveScheduleTeamIDs(teamIDs, time.Now()) if len(activeTeamIDs) == 0 { if _, err := s.TryOffHoursHandoffByAIWithRequestID(conversationID, aiAgent, reason, requestID); err != nil { return nil, err } offHoursMessage := strings.TrimSpace(aiAgent.OffHoursMessage) if offHoursMessage == "" { offHoursMessage = HandoffOffHoursMessageForLocale(s.ResolveConversationLocale(conversationID)) } var teamID int64 if len(teamIDs) > 0 { teamID = teamIDs[0] } return &HandoffDecisionResult{Decision: HandoffDecisionOffHours, TeamID: teamID, Message: offHoursMessage}, nil } if err := s.markHandoff(conversationID, aiAgent, reason, requestID); err != nil { return nil, err } return s.dispatchAfterHandoffWithRequestID(conversationID, aiAgent, activeTeamIDs, strings.TrimSpace(reason), true, requestID) } func (s *conversationHumanDispatchService) ApplyHumanOnlyCreate(conversationID int64, aiAgent models.AIAgent) (*HandoffDecisionResult, error) { teamIDs := resolveDispatchTeamIDs(aiAgent.TeamIDs) activeTeamIDs := ConversationDispatchService.findActiveScheduleTeamIDs(teamIDs, time.Now()) waitingMessage := strings.TrimSpace(aiAgent.HandoffMessage) if waitingMessage == "" { waitingMessage = HandoffWaitingMessageForLocale(s.ResolveConversationLocale(conversationID)) } if len(activeTeamIDs) == 0 { if err := s.moveToGlobalPool(conversationID, aiAgent.Name); err != nil { return nil, err } if err := s.sendAIText(conversationID, aiAgent.ID, waitingMessage); err != nil { return nil, err } return &HandoffDecisionResult{Decision: HandoffDecisionGlobalPool, Message: waitingMessage}, nil } return s.dispatchAfterHandoff(conversationID, aiAgent, activeTeamIDs, "仅人工模式新会话", false) } func (s *conversationHumanDispatchService) DispatchPendingConversation(conversationID int64, aiAgent models.AIAgent) (*HandoffDecisionResult, error) { conversation := ConversationService.Get(conversationID) if conversation == nil { return nil, errorsx.InvalidParamI18n("error.e0116") } if conversation.Status != enums.IMConversationStatusPending || conversation.CurrentAssigneeID > 0 { return nil, errorsx.InvalidParamI18n("error.e0137") } activeTeamIDs := ConversationDispatchService.findActiveScheduleTeamIDs(resolveDispatchTeamIDs(aiAgent.TeamIDs), time.Now()) if len(activeTeamIDs) == 0 { return &HandoffDecisionResult{Decision: HandoffDecisionOffHours}, nil } candidates, _, err := ConversationDispatchService.pickDispatchCandidates(activeTeamIDs, time.Now()) if err != nil { return nil, err } if len(candidates) > 0 { dispatched, err := ConversationDispatchService.tryAssignConversation(conversationID, candidates[0].profile, "自动分配") if err != nil { return nil, err } if dispatched != nil { WsService.PublishConversationChanged(dispatched, enums.IMRealtimeEventConversationAssigned) return &HandoffDecisionResult{ Decision: HandoffDecisionAssigned, TeamID: dispatched.CurrentTeamID, AssigneeID: dispatched.CurrentAssigneeID, }, nil } } teamID := activeTeamIDs[0] teamPoolConversation, err := s.moveToTeamPool(conversationID, teamID, "手动触发自动分配") if err != nil { return nil, err } if teamPoolConversation != nil { WsService.PublishConversationChanged(teamPoolConversation, enums.IMRealtimeEventConversationUpdated) } return &HandoffDecisionResult{Decision: HandoffDecisionTeamPool, TeamID: teamID}, nil } func (s *conversationHumanDispatchService) dispatchAfterHandoff(conversationID int64, aiAgent models.AIAgent, activeTeamIDs []int64, reason string, publishAssignEvent bool) (*HandoffDecisionResult, error) { return s.dispatchAfterHandoffWithRequestID(conversationID, aiAgent, activeTeamIDs, reason, publishAssignEvent, "") } func (s *conversationHumanDispatchService) dispatchAfterHandoffWithRequestID(conversationID int64, aiAgent models.AIAgent, activeTeamIDs []int64, reason string, publishAssignEvent bool, requestID string) (*HandoffDecisionResult, error) { waitingMessage := strings.TrimSpace(aiAgent.HandoffMessage) if waitingMessage == "" { waitingMessage = HandoffWaitingMessageForLocale(s.ResolveConversationLocale(conversationID)) } if err := s.sendAITextWithRequestID(conversationID, aiAgent.ID, waitingMessage, requestID); err != nil { return nil, err } candidates, _, err := ConversationDispatchService.pickDispatchCandidates(activeTeamIDs, time.Now()) if err != nil { return nil, err } if len(candidates) > 0 { dispatched, err := ConversationDispatchService.tryAssignConversation(conversationID, candidates[0].profile, "自动分配") if err != nil { return nil, err } if dispatched != nil { WsService.PublishConversationChanged(dispatched, enums.IMRealtimeEventConversationAssigned) if publishAssignEvent { eventbus.PublishAsync(context.Background(), events.ConversationAssignedEvent{ ConversationID: dispatched.ID, ToUserID: dispatched.CurrentAssigneeID, OperatorID: systemDispatchPrincipal().UserID, Reason: "自动分配", AssignType: events.ConversationAssignTypeAutoAssign, }) } return &HandoffDecisionResult{ Decision: HandoffDecisionAssigned, TeamID: dispatched.CurrentTeamID, AssigneeID: dispatched.CurrentAssigneeID, Message: waitingMessage, }, nil } } teamID := activeTeamIDs[0] teamPoolConversation, err := s.moveToTeamPoolWithRequestID(conversationID, teamID, reason, requestID) if err != nil { return nil, err } if teamPoolConversation != nil { WsService.PublishConversationChanged(teamPoolConversation, enums.IMRealtimeEventConversationUpdated) } return &HandoffDecisionResult{Decision: HandoffDecisionTeamPool, TeamID: teamID, Message: waitingMessage}, nil } func (s *conversationHumanDispatchService) markHandoff(conversationID int64, aiAgent models.AIAgent, reason string, requestID string) error { now := time.Now() trimmedReason := strings.TrimSpace(reason) return sqls.WithTransaction(func(ctx *sqls.TxContext) error { if err := repositories.ConversationRepository.Updates(ctx.Tx, conversationID, map[string]any{ "handoff_at": now, "handoff_reason": trimmedReason, "status": enums.IMConversationStatusPending, "current_team_id": 0, "current_assignee_id": 0, "update_user_id": 0, "update_user_name": aiAgent.Name, "updated_at": now, }); err != nil { return err } return ConversationEventLogService.CreateEventWithRequestID(ctx, conversationID, requestID, enums.IMEventTypeTransfer, enums.IMSenderTypeAI, aiAgent.ID, "AI转人工", trimmedReason) }) } func (s *conversationHumanDispatchService) moveToTeamPool(conversationID, teamID int64, reason string) (*models.Conversation, error) { return s.moveToTeamPoolWithRequestID(conversationID, teamID, reason, "") } func (s *conversationHumanDispatchService) moveToTeamPoolWithRequestID(conversationID, teamID int64, reason string, requestID string) (*models.Conversation, error) { now := time.Now() var conversation *models.Conversation err := sqls.WithTransaction(func(ctx *sqls.TxContext) error { current := repositories.ConversationRepository.Get(ctx.Tx, conversationID) if current == nil { return errorsx.InvalidParamI18n("error.e0116") } if err := ConversationAssignmentService.FinishActiveAssignments(ctx, conversationID, now); err != nil { return err } if err := repositories.ConversationRepository.Updates(ctx.Tx, conversationID, map[string]any{ "status": enums.IMConversationStatusPending, "current_team_id": teamID, "current_assignee_id": 0, "update_user_id": 0, "update_user_name": "system", "updated_at": now, }); err != nil { return err } if err := ConversationEventLogService.CreateEventWithRequestID(ctx, conversationID, requestID, enums.IMEventTypeTransfer, enums.IMSenderTypeSystem, 0, "会话进入客服组待接入", ConversationService.buildEventPayload(map[string]any{ "fromStatus": current.Status, "toStatus": enums.IMConversationStatusPending, "fromAssigneeId": current.CurrentAssigneeID, "toAssigneeId": int64(0), "toTeamId": teamID, "reason": strings.TrimSpace(reason), "decision": string(HandoffDecisionTeamPool), })); err != nil { return err } current.Status = enums.IMConversationStatusPending current.CurrentTeamID = teamID current.CurrentAssigneeID = 0 current.UpdateUserID = 0 current.UpdateUserName = "system" current.UpdatedAt = now conversation = current return nil }) if err != nil { return nil, err } return conversation, nil } func (s *conversationHumanDispatchService) moveToGlobalPool(conversationID int64, operatorName string) error { now := time.Now() return sqls.WithTransaction(func(ctx *sqls.TxContext) error { conversation := repositories.ConversationRepository.Get(ctx.Tx, conversationID) if conversation == nil { return errorsx.InvalidParamI18n("error.e0116") } if err := repositories.ConversationRepository.Updates(ctx.Tx, conversationID, map[string]any{ "status": enums.IMConversationStatusPending, "current_team_id": 0, "current_assignee_id": 0, "update_user_id": 0, "update_user_name": operatorName, "updated_at": now, }); err != nil { return err } return ConversationEventLogService.CreateEvent(ctx, conversationID, enums.IMEventTypeTransfer, enums.IMSenderTypeSystem, 0, "会话进入全局待接入", ConversationService.buildEventPayload(map[string]any{ "fromStatus": conversation.Status, "toStatus": enums.IMConversationStatusPending, "decision": string(HandoffDecisionGlobalPool), })) }) } func (s *conversationHumanDispatchService) createEvent(conversationID int64, eventType enums.IMEventType, senderType enums.IMSenderType, senderID int64, content, payload string) error { return s.createEventWithRequestID(conversationID, "", eventType, senderType, senderID, content, payload) } func (s *conversationHumanDispatchService) createEventWithRequestID(conversationID int64, requestID string, eventType enums.IMEventType, senderType enums.IMSenderType, senderID int64, content, payload string) error { return sqls.WithTransaction(func(ctx *sqls.TxContext) error { return ConversationEventLogService.CreateEventWithRequestID(ctx, conversationID, requestID, eventType, senderType, senderID, content, payload) }) } func (s *conversationHumanDispatchService) sendAIText(conversationID, aiAgentID int64, content string) error { return s.sendAITextWithRequestID(conversationID, aiAgentID, content, "") } func (s *conversationHumanDispatchService) sendAITextWithRequestID(conversationID, aiAgentID int64, content string, requestID string) error { _, err := MessageService.SendAIServiceNoticeWithRequestID(conversationID, aiAgentID, content, requestID) return err } func resolveDispatchTeamIDs(value string) []int64 { ids := orderedPositiveIDs(value) if len(ids) > 0 { return ids } teams := AgentTeamService.Find(sqls.NewCnd().Eq("status", enums.StatusOk).Asc("id")) if len(teams) == 0 { return nil } fallback := make([]int64, 0, len(teams)) for _, team := range teams { if team.ID > 0 { fallback = append(fallback, team.ID) } } return fallback } func orderedPositiveIDs(value string) []int64 { return uniquePositiveInt64sFromStrings(strings.Split(value, ",")) } func uniquePositiveInt64sFromStrings(values []string) []int64 { seen := make(map[int64]struct{}, len(values)) ret := make([]int64, 0, len(values)) for _, value := range values { var id int64 _, _ = fmt.Sscan(strings.TrimSpace(value), &id) if id <= 0 { continue } if _, ok := seen[id]; ok { continue } seen[id] = struct{}{} ret = append(ret, id) } return ret }