Skip to content

AiMention AI 提及

基于 Mention 组件扩展,专为 AI 助手设计。支持通过 @ 呼叫 Agent(智能体)、引用 Context(文档、表格、知识库)等 AI 场景下的常用交互。

基础用法

展示 AI 提及组件的标准样式,包括不同类型的图标区分、描述信息展示以及类型标签。

基础用法

类型过滤

通过 types 属性,可以实现不同触发前缀下的类型过滤,例如 @ 用于唤醒智能体,# 用于引用知识库文件。

仅选择 Agent (@ 呼叫...)

仅选择 Context (# 引用...)

类型过滤与自定义前缀

在 Nuxt 中使用

该组件完美支持 Nuxt 3/4 SSR 渲染。在 Nuxt 项目中,组件会自动注册,无需手动导入。

有关详细配置,请参考 Nuxt 集成文档

SSR 友好

AiMention 已通过完整的 SSR 测试,支持服务端渲染,确保首屏加载性能。

API

Props

属性名说明类型默认值
v-model绑定值string
options提及选项列表AiMentionOption[][]
types允许显示的类型列表('agent'|'document'|'table'|'knowledge')[]['agent', 'document', 'table']
prefix触发前缀string | string[]@
show-icon是否显示图标booleantrue
show-description是否显示描述信息booleantrue
theme-overrides组件级别的主题定制ComponentThemeVars

AiMentionOption

属性名说明类型默认值
label显示文本string
value选中值string
typeAI 类型'agent' | 'document' | 'table' | 'knowledge'
icon自定义图标string
description描述文本string

Slots

插槽名说明参数
label自定义选项内容{ option: AiMentionOption }
empty无匹配项内容
loading加载中内容

主题变量

变量名说明默认值
--yh-ai-mention-option-height选项高度56px
--yh-ai-mention-agent-color智能体类型主题色var(--yh-color-primary)
--yh-ai-mention-doc-color文档类型主题色#47c2ff
--yh-ai-mention-table-color表格类型主题色#10b981
--yh-ai-mention-knowledge-color知识库类型主题色#f59e0b

Released under the MIT License.