mirror of
https://github.com/abhinavxd/libredesk.git
synced 2026-11-01 17:09:52 +00:00
Abhinav Raut
9cac787f30
The assistant test tab looked up every search hit as a snippet, so a help article showed an unrelated snippet's title or vanished from the list. Also drops the help center view count, which nothing ever read.
109 lines
4.6 KiB
Go
109 lines
4.6 KiB
Go
package models
|
|
|
|
import (
|
|
"time"
|
|
|
|
"github.com/lib/pq"
|
|
"github.com/volatiletech/null/v9"
|
|
)
|
|
|
|
// FAQ suggestion review states.
|
|
const (
|
|
FAQStatusPending = "pending"
|
|
FAQStatusApproved = "approved"
|
|
FAQStatusRejected = "rejected"
|
|
)
|
|
|
|
// Tone and response-length presets shape the customer-facing voice.
|
|
var (
|
|
Tones = []string{"friendly", "professional", "neutral", "casual"}
|
|
ResponseLengths = []string{"concise", "balanced", "detailed"}
|
|
)
|
|
|
|
// Assistant is one AI assistant: a persona plus the ai_assistant user that carries its identity.
|
|
type Assistant struct {
|
|
ID int `db:"id" json:"id"`
|
|
CreatedAt time.Time `db:"created_at" json:"created_at"`
|
|
UpdatedAt time.Time `db:"updated_at" json:"updated_at"`
|
|
UserID int `db:"user_id" json:"user_id"`
|
|
Name string `db:"name" json:"name"`
|
|
AvatarURL null.String `db:"avatar_url" json:"avatar_url"`
|
|
Description string `db:"description" json:"description"`
|
|
Instructions string `db:"instructions" json:"instructions"`
|
|
Guardrails string `db:"guardrails" json:"guardrails"`
|
|
Expectation string `db:"expectation" json:"expectation"`
|
|
Tone string `db:"tone" json:"tone"`
|
|
ResponseLength string `db:"response_length" json:"response_length"`
|
|
MaxTurns int `db:"max_turns" json:"max_turns"`
|
|
FallbackTeamID null.Int `db:"fallback_team_id" json:"fallback_team_id"`
|
|
HandoffEnabled bool `db:"handoff_enabled" json:"handoff_enabled"`
|
|
Languages pq.StringArray `db:"languages" json:"languages"`
|
|
Enabled bool `db:"enabled" json:"enabled"`
|
|
ToolIDs []int `db:"-" json:"tool_ids"`
|
|
|
|
// RemoveAvatar, when set on a save request, clears the assistant's current avatar.
|
|
RemoveAvatar bool `db:"-" json:"remove_avatar"`
|
|
}
|
|
|
|
// PreviewSource is one knowledge item a preview reply was grounded in.
|
|
type PreviewSource struct {
|
|
ID int `json:"id"`
|
|
Type string `json:"type"`
|
|
Title string `json:"title"`
|
|
Score float64 `json:"score"`
|
|
}
|
|
|
|
// RecentConversation is a summary row of a contact's past conversation, fed to the assistant as context.
|
|
type RecentConversation struct {
|
|
UUID string `db:"uuid"`
|
|
ReferenceNumber string `db:"reference_number"`
|
|
CreatedAt time.Time `db:"created_at"`
|
|
Subject string `db:"subject"`
|
|
Status string `db:"status"`
|
|
}
|
|
|
|
// StatWindow holds the raw counts scanned for one time window.
|
|
type StatWindow struct {
|
|
Conversations int `db:"conversations"`
|
|
Replies int `db:"replies"`
|
|
Handoffs int `db:"handoffs"`
|
|
Resolves int `db:"resolves"`
|
|
Reopened int `db:"reopened"`
|
|
CSATCount int `db:"csat_count"`
|
|
CSATAvg float64 `db:"csat_avg"`
|
|
CSATPositive float64 `db:"csat_positive"`
|
|
}
|
|
|
|
// AssistantStats is the computed window summary with derived rates and trend deltas vs the previous equal window.
|
|
type AssistantStats struct {
|
|
RangeDays int `json:"range_days"`
|
|
Conversations int `json:"conversations"`
|
|
Replies int `json:"replies"`
|
|
Handoffs int `json:"handoffs"`
|
|
Resolved int `json:"resolved"`
|
|
Reopened int `json:"reopened"`
|
|
ResolutionRate float64 `json:"resolution_rate"`
|
|
HandoffRate float64 `json:"handoff_rate"`
|
|
ReopenRate float64 `json:"reopen_rate"`
|
|
Depth float64 `json:"depth"`
|
|
CSATCount int `json:"csat_count"`
|
|
CSATAvg float64 `json:"csat_avg"`
|
|
CSATPositive float64 `json:"csat_positive"`
|
|
Trends map[string]float64 `json:"trends"`
|
|
}
|
|
|
|
// FAQSuggestion is a candidate Q&A mined from a resolved conversation, awaiting review.
|
|
type FAQSuggestion struct {
|
|
ID int `db:"id" json:"id"`
|
|
CreatedAt time.Time `db:"created_at" json:"created_at"`
|
|
UpdatedAt time.Time `db:"updated_at" json:"updated_at"`
|
|
ConversationID int `db:"conversation_id" json:"conversation_id"`
|
|
Question string `db:"question" json:"question"`
|
|
Answer string `db:"answer" json:"answer"`
|
|
Status string `db:"status" json:"status"`
|
|
ReviewedByID null.Int `db:"reviewed_by_id" json:"reviewed_by_id"`
|
|
ReviewedAt null.Time `db:"reviewed_at" json:"reviewed_at"`
|
|
ConversationUUID string `db:"conversation_uuid" json:"conversation_uuid"`
|
|
ConversationReferenceNumber string `db:"reference_number" json:"conversation_reference_number"`
|
|
}
|