1.9 KiB
1.9 KiB
AI 集成
- 功能:约束学习引导与 AI 异步生成链路的实现方式。
- 何时用:接入或改动 AI 相关功能、新增后台任务、处理生成类能力时。
学习引导(复习-06)
一次引导是一次复习行为,有自己的记录实体 review_guidance_conversations:
- 产出的知识碎片以它作为记录上下文(
context_type=REVIEW),默认内容归属为被引导概念所属任务,并带FROM_GUIDANCE系统标记。 - 复习耗时记在会话行上(与回忆对比同一口径)。
- 多轮对话复用 AI 异步任务:每轮提交一个
GUIDANCE任务,前端轮询取回复;AI 回复会写回会话轮次,供下一轮作为上下文。 - 没有降级形态:AI 不可用时该链路直接失败,前端把入口置为不可用。
AI 异步链路(AI-02)
生成类能力(回忆对比、标准导图、报告草稿)不在请求线程里等 AI:
- 前端
POST /ai/tasks提交,秒级拿到taskNum;随后轮询GET /ai/tasks/{taskNum}直到SUCCEEDED/FAILED。 - 结果写在
ai_tasks.result_payload,按taskNum可重复获取,刷新或离开页面都不丢。 - 同一用户 + 同一类型 + 同一目标已有进行中任务时复用该任务(AI-04),不重复生成。
- 执行器在
ai-task-*线程池里跑;提交后立即投递,@Scheduled兜底扫描接手投递失败或进程重启的任务。 - 后台线程必须显式声明身份:执行线程没有 Web 上下文,租户拦截器与
MetaObjectHandler字段自动填充都取不到当前用户。执行器用TenantContext.callAs(task.createdBy, ...)绑定任务所属用户;请求线程不受影响(没有绑定时仍走StpUtil)。新增后台任务时必须照此处理,否则会抛NotWebContextException。 - 禁止在
@Transactional方法内调用 AI:等待 AI 期间不得占用数据库连接。