Files
Enterprise-Knowledge-Base/frontend/src/views/embed/EmbedChatCore.vue
T
Jack Wang 43839f7830 fix(agent): honor suggested-questions limit parameter
Treat limit as the authoritative upper bound instead of clamping it down
to the agent's Starters.Count, so ?limit=N no longer always returns 6.

Fixes #2238
2026-07-24 10:46:53 +08:00

613 lines
18 KiB
Vue

<template>
<div class="embed-chat">
<div ref="scrollContainer" class="embed-chat__scroll" @scroll="handleScroll">
<div class="embed-chat__messages">
<div v-if="historyLoading && messagesList.length === 0 && !hasWelcomeText" class="msg-skeleton-list">
<div class="msg-skeleton msg-skeleton-user"><div class="sk-line sk-line--short" /></div>
<div class="msg-skeleton msg-skeleton-bot">
<div class="sk-line" />
<div class="sk-line" />
<div class="sk-line sk-line--medium" />
</div>
</div>
<div
v-if="showWelcome"
class="embed-welcome-bubble"
>
<p class="embed-welcome-bubble__text">{{ welcomeText }}</p>
</div>
<div
v-if="showSuggestedBlock"
class="embed-suggested"
>
<p v-if="suggestedQuestions.length > 0" class="embed-suggested__title">
{{ t('chat.suggestedQuestions') }}
</p>
<div v-if="suggestedLoading && suggestedQuestions.length === 0" class="embed-suggested__grid">
<div v-for="n in 4" :key="`sq-skel-${n}`" class="embed-suggested__card embed-suggested__card--skeleton" />
</div>
<div v-else-if="suggestedQuestions.length > 0" class="embed-suggested__grid">
<button
v-for="item in suggestedQuestions"
:key="item.question"
type="button"
class="embed-suggested__card"
@click="handleSuggestedClick(item.question)"
>
<span class="embed-suggested__text">{{ item.question }}</span>
</button>
</div>
</div>
<div
v-for="(session, index) in messagesList"
:key="(session.id as string) || `${session.role}-${session.created_at}-${index}`"
class="msg-item-wrapper"
>
<div v-if="session.role === 'user'">
<EmbedUserMessage
:content="String(session.content || '')"
:mentioned_items="asUnknownArray(session.mentioned_items)"
:images="asEmbedImages(session.images)"
:attachments="asEmbedAttachments(session.attachments)"
:embeddedMode="true"
:embed-channel-id="channelId"
:embed-token="token"
/>
</div>
<div v-if="session.role === 'assistant' && shouldRenderAssistantMessage(session)">
<EmbedBotMessage
:content="String(session.content || '')"
:session="session"
:session-id="sessionId"
:user-query="getUserQuery(index)"
:embedded-mode="true"
:embed-channel-id="channelId"
:embed-token="token"
:embed-session-sig="sessionSig"
:embed-visitor-id="visitorId"
/>
<FollowUpSuggestions v-if="!session.suggestionsDismissed"
:suggestion-set="session.suggestionSet as any"
:loading="Boolean(session.suggestionLoading)"
:allow-regenerate="Boolean((session.suggestionSet as any)?.allow_regenerate)"
@select="(item) => handleFollowUpSelect(session, item)"
@regenerate="loadFollowUpSuggestions(session, true, true)"
@impression="(set) => recordFollowUpEvent(set, 'impression')"
@dismiss="(set) => dismissFollowUps(session, set)" />
</div>
</div>
<div v-if="showGlobalTypingIndicator" class="embed-chat__typing" role="status"
:aria-label="t('chat.thinkingAlt')">
<span class="embed-chat__typing-spinner" aria-hidden="true"></span>
</div>
</div>
</div>
<transition name="scroll-btn-fade">
<div v-show="userHasScrolledUp" class="scroll-to-bottom-btn" @click="onClickScrollToBottom" aria-label="scroll to bottom">
<svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true">
<path d="M6 9l6 6 6-6" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />
</svg>
</div>
</transition>
<div class="embed-chat__input">
<EmbedInputField
:isReplying="isReplying"
:show-web-search-toggle="showWebSearchToggle"
v-model:web-search-enabled="webSearchEnabled"
:show-file-upload-toggle="showFileUploadToggle"
@send-msg="onSendMsg"
@stop-generation="handleStopGeneration"
/>
</div>
<ChatReferencesDrawer embedded-mode />
</div>
</template>
<script setup lang="ts">
import { computed, onMounted, onUnmounted, ref, toRef, watch } from 'vue'
import { useI18n } from 'vue-i18n'
import {
ensureEmbedMessageSuggestions,
getEmbedMessageSuggestions,
getEmbedSuggestedQuestions,
onEmbedHostOpenWithQuery,
recordEmbedMessageSuggestionEvent,
type SuggestedQuestion,
} from '@/api/embed'
import EmbedInputField from '@/components/EmbedInputField.vue'
import EmbedBotMessage from '@/views/embed/EmbedBotMessage.vue'
import EmbedUserMessage from '@/views/embed/EmbedUserMessage.vue'
import ChatReferencesDrawer from '@/components/ChatReferencesDrawer.vue'
import { provideChatReferencesDrawer } from '@/composables/useChatReferencesDrawer'
import { useEmbedChatSession } from '@/composables/useEmbedChatSession'
import FollowUpSuggestions from '@/components/chat/FollowUpSuggestions.vue'
import type { MessageSuggestionItem, MessageSuggestionSet } from '@/api/message-suggestion'
provideChatReferencesDrawer()
type EmbedImage = { url?: string; data?: string }
type EmbedAttachment = { file_name: string; file_size?: number }
const props = defineProps<{
sessionId: string
sessionSig: string
visitorId: string
channelId: string
token: string
agentId: string
kbIds: string[]
welcomeMessage?: string
showSuggestedQuestions?: boolean
allowWebSearch?: boolean
agentWebSearchEnabled?: boolean
allowFileUpload?: boolean
agentImageUploadEnabled?: boolean
useSessionHeaderTitle?: boolean
hostContext?: Record<string, unknown>
}>()
const emit = defineEmits<{
(e: 'session-title', title: string): void
(e: 'messages-state', hasMessages: boolean): void
}>()
const { t } = useI18n()
const sessionIdRef = toRef(props, 'sessionId')
const sessionSigRef = toRef(props, 'sessionSig')
const visitorIdRef = toRef(props, 'visitorId')
const suggestedQuestions = ref<SuggestedQuestion[]>([])
const suggestedLoading = ref(false)
const hostContextRef = ref<Record<string, unknown>>(props.hostContext || {})
const loadFollowUpSuggestions = async (
message: Record<string, unknown>,
ensure = false,
regenerate = false,
) => {
const messageId = String(message.id || message.assistant_message_id || '')
const targetSessionId = props.sessionId
if (!props.showSuggestedQuestions || !messageId || !targetSessionId || message.suggestionsDismissed) return
message.suggestionLoading = true
try {
let response = ensure
? await ensureEmbedMessageSuggestions(
props.channelId, props.token, targetSessionId, messageId, props.sessionSig, props.visitorId, regenerate,
)
: await getEmbedMessageSuggestions(
props.channelId, props.token, targetSessionId, messageId, props.sessionSig, props.visitorId,
)
let set = response?.data
for (let attempt = 0; set?.status === 'generating' && attempt < 120; attempt++) {
await new Promise((resolve) => setTimeout(resolve, 1000))
if (props.sessionId !== targetSessionId || message.suggestionsDismissed) return
response = await getEmbedMessageSuggestions(
props.channelId, props.token, targetSessionId, messageId, props.sessionSig, props.visitorId,
)
set = response?.data
}
message.suggestionSet = set?.status === 'ready' ? set : null
} catch {
message.suggestionSet = null
} finally {
message.suggestionLoading = false
}
}
const loadPersistedFollowUps = (messages: Record<string, unknown>[]) => {
for (const message of messages) {
if (message.role === 'assistant' && message.is_completed && message.suggestionSet === undefined) {
void loadFollowUpSuggestions(message, false)
}
}
}
function asUnknownArray(value: unknown): unknown[] | undefined {
return Array.isArray(value) ? value : undefined
}
function asEmbedImages(value: unknown): EmbedImage[] | undefined {
return Array.isArray(value) ? value as EmbedImage[] : undefined
}
function asEmbedAttachments(value: unknown): EmbedAttachment[] | undefined {
return Array.isArray(value) ? value as EmbedAttachment[] : undefined
}
const embedWebSearchStorageKey = () => `weknora-embed-web-search:${props.channelId}`
const readStoredWebSearchEnabled = () => {
if (typeof localStorage === 'undefined') return false
return localStorage.getItem(embedWebSearchStorageKey()) === '1'
}
const webSearchEnabled = ref(readStoredWebSearchEnabled())
const showWebSearchToggle = computed(
() => props.allowWebSearch === true && props.agentWebSearchEnabled === true,
)
const showFileUploadToggle = computed(
() => props.allowFileUpload === true && props.agentImageUploadEnabled === true,
)
watch(webSearchEnabled, (enabled) => {
if (!showWebSearchToggle.value) return
if (typeof localStorage === 'undefined') return
localStorage.setItem(embedWebSearchStorageKey(), enabled ? '1' : '0')
})
watch(showWebSearchToggle, (visible) => {
if (!visible) {
webSearchEnabled.value = false
}
})
watch(() => props.hostContext, (ctx) => {
hostContextRef.value = ctx || {}
}, { deep: true })
const {
messagesList,
loading,
isReplying,
historyLoading,
scrollContainer,
userHasScrolledUp,
shouldRenderAssistantMessage,
shouldShowGlobalTypingIndicator,
getUserQuery,
handleScroll,
scrollToBottom,
onClickScrollToBottom,
sendMsg,
handleStopGeneration,
setSuggestionAttribution,
} = useEmbedChatSession({
sessionId: sessionIdRef,
sessionSig: sessionSigRef,
visitorId: visitorIdRef,
channelId: props.channelId,
token: props.token,
agentId: props.agentId,
kbIds: props.kbIds,
allowWebSearch: props.allowWebSearch,
allowFileUpload: props.allowFileUpload,
hostContext: hostContextRef,
onMessagesChange: (has) => emit('messages-state', has),
onSessionTitle: (title) => {
if (props.useSessionHeaderTitle) {
emit('session-title', title)
}
},
onTurnComplete: (message) => { void loadFollowUpSuggestions(message, true) },
onMessagesLoaded: loadPersistedFollowUps,
})
const welcomeText = computed(() => props.welcomeMessage?.trim() || '')
const hasWelcomeText = computed(() => welcomeText.value.length > 0)
const hasUserMessage = computed(() =>
messagesList.some((m) => m.role === 'user'))
const showGlobalTypingIndicator = computed(() =>
shouldShowGlobalTypingIndicator(messagesList, loading.value),
)
/** 访客未发言前始终展示欢迎语(含历史加载中),发送后隐藏 */
const showWelcome = computed(() => hasWelcomeText.value && !hasUserMessage.value)
const showSuggestedBlock = computed(() =>
props.showSuggestedQuestions
&& !hasUserMessage.value
&& !loading.value
&& !historyLoading.value
&& (suggestedLoading.value || suggestedQuestions.value.length > 0))
const fetchSuggestedQuestions = async () => {
if (!props.showSuggestedQuestions || !props.channelId || !props.token) {
suggestedQuestions.value = []
return
}
suggestedLoading.value = true
try {
const res = await getEmbedSuggestedQuestions(props.channelId, props.token)
suggestedQuestions.value = res?.data?.questions || []
} catch {
suggestedQuestions.value = []
} finally {
suggestedLoading.value = false
}
}
const onSendMsg = (query: string, imageFiles: File[] = [], attachmentFiles: File[] = []) => {
void sendMsg(query, {
webSearchEnabled: webSearchEnabled.value,
imageFiles,
attachmentFiles,
})
}
const handleSuggestedClick = (question: string) => {
const text = question.trim()
if (!text || isReplying.value) return
void sendMsg(text, { webSearchEnabled: webSearchEnabled.value })
}
const recordFollowUpEvent = (
set: MessageSuggestionSet,
eventType: 'impression' | 'click' | 'dismiss',
questionId = '',
) => {
if (!set?.id) return
void recordEmbedMessageSuggestionEvent(
props.channelId,
props.token,
props.sessionId,
props.sessionSig,
props.visitorId,
set.id,
eventType,
questionId,
).catch(() => undefined)
}
const handleFollowUpSelect = (message: Record<string, unknown>, item: MessageSuggestionItem) => {
const set = message.suggestionSet as MessageSuggestionSet | undefined
if (set) {
recordFollowUpEvent(set, 'click', item.id)
setSuggestionAttribution(set.id, item.id)
}
if (!isReplying.value) void sendMsg(item.text, { webSearchEnabled: webSearchEnabled.value })
}
const dismissFollowUps = (message: Record<string, unknown>, set: MessageSuggestionSet) => {
message.suggestionsDismissed = true
recordFollowUpEvent(set, 'dismiss')
}
let removeOpenQueryListener: (() => void) | null = null
onMounted(() => {
fetchSuggestedQuestions()
removeOpenQueryListener = onEmbedHostOpenWithQuery((query) => {
if (isReplying.value) return
void sendMsg(query, { webSearchEnabled: webSearchEnabled.value })
})
})
onUnmounted(() => {
removeOpenQueryListener?.()
})
watch(
() => [props.showSuggestedQuestions, props.channelId, props.token] as const,
() => { fetchSuggestedQuestions() },
)
</script>
<style scoped lang="less">
.embed-chat {
display: flex;
flex-direction: column;
flex: 1;
min-height: 0;
width: 100%;
position: relative;
}
.embed-chat__scroll {
flex: 1;
min-height: 0;
width: 100%;
overflow-y: auto;
}
.embed-chat__messages {
display: flex;
flex-direction: column;
gap: 16px;
max-width: 800px;
margin: 0 auto;
width: 100%;
padding: 12px 16px 0;
box-sizing: border-box;
}
.embed-suggested {
width: 100%;
&__title {
margin: 0 0 8px;
font-size: 13px;
font-weight: 500;
color: var(--td-text-color-secondary);
}
&__grid {
display: flex;
flex-direction: column;
gap: 8px;
}
&__card {
display: block;
width: 100%;
padding: 10px 12px;
border: 1px solid var(--td-component-stroke);
border-radius: 10px;
background: var(--td-bg-color-container);
text-align: left;
cursor: pointer;
box-shadow: 0 1px 2px rgba(0, 0, 0, 0.04);
transition: border-color 0.15s ease, box-shadow 0.15s ease, background 0.15s ease;
&:hover {
border-color: color-mix(in srgb, var(--td-text-color-primary) 10%, var(--td-component-stroke));
background: color-mix(in srgb, var(--td-text-color-primary) 4%, var(--td-bg-color-container));
box-shadow: 0 2px 6px rgba(0, 0, 0, 0.05);
}
&--skeleton {
height: 40px;
cursor: default;
background: linear-gradient(90deg, #f0f0f0 25%, #e6e6e6 50%, #f0f0f0 75%);
background-size: 200% 100%;
animation: sk-shimmer 1.2s ease-in-out infinite;
border: none;
}
}
&__text {
font-size: 13px;
line-height: 1.45;
color: var(--td-text-color-primary);
}
}
.embed-welcome-bubble {
display: flex;
justify-content: flex-start;
width: 100%;
animation: welcome-in 0.28s ease both;
&__text {
margin: 0;
max-width: min(88%, 520px);
padding: 10px 14px;
font-size: 14px;
line-height: 1.55;
color: var(--td-text-color-primary);
white-space: pre-wrap;
word-break: break-word;
background: color-mix(
in srgb,
var(--embed-primary, var(--td-brand-color)) 7%,
var(--td-bg-color-container, #fff)
);
border: 1px solid color-mix(
in srgb,
var(--embed-primary, var(--td-brand-color)) 14%,
var(--td-component-stroke, #e7e7e7)
);
border-radius: 4px 14px 14px 14px;
box-shadow: 0 1px 2px rgba(15, 23, 42, 0.04);
}
}
@keyframes welcome-in {
from {
opacity: 0;
transform: translateY(6px);
}
to {
opacity: 1;
transform: translateY(0);
}
}
.embed-chat__typing {
min-height: 28px;
display: flex;
align-items: center;
padding-left: 4px;
}
.embed-chat__typing-spinner {
width: 12px;
height: 12px;
box-sizing: border-box;
border: 1.5px solid var(--td-component-stroke);
border-top-color: var(--td-text-color-secondary);
border-radius: 50%;
animation: embedChatTypingSpin 0.8s linear infinite;
}
@keyframes embedChatTypingSpin {
to {
transform: rotate(360deg);
}
}
@media (prefers-reduced-motion: reduce) {
.embed-chat__typing-spinner {
animation: none;
}
}
.embed-chat__input {
flex-shrink: 0;
padding: 8px 16px 16px;
box-sizing: border-box;
}
.msg-skeleton-list {
display: flex;
flex-direction: column;
gap: 20px;
padding: 8px 0;
}
.msg-skeleton-user {
display: flex;
justify-content: flex-end;
}
.msg-skeleton-bot {
display: flex;
flex-direction: column;
gap: 8px;
padding-left: 4px;
}
.sk-line {
height: 14px;
border-radius: 6px;
background: linear-gradient(90deg, #f0f0f0 25%, #e6e6e6 50%, #f0f0f0 75%);
background-size: 200% 100%;
animation: sk-shimmer 1.2s ease-in-out infinite;
}
.sk-line--short { width: 45%; height: 36px; }
.sk-line--medium { width: 60%; }
@keyframes sk-shimmer {
0% { background-position: 200% 0; }
100% { background-position: -200% 0; }
}
.scroll-to-bottom-btn {
position: absolute;
left: 50%;
transform: translateX(-50%);
bottom: 100px;
z-index: 10;
width: 36px;
height: 36px;
border-radius: 50%;
background: var(--td-bg-color-container);
border: 1px solid var(--td-component-stroke);
box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
display: flex;
align-items: center;
justify-content: center;
cursor: pointer;
color: var(--td-text-color-secondary);
}
.scroll-btn-fade-enter-active,
.scroll-btn-fade-leave-active {
transition: opacity 0.2s ease, transform 0.2s ease;
}
.scroll-btn-fade-enter-from,
.scroll-btn-fade-leave-to {
opacity: 0;
transform: translateX(-50%) translateY(8px);
}
</style>