AI 填充队列

功能简介

AI 自动填充是让 AI 替员工填写某个字段：在「业务对象」一章的「表单」页签给字段打开「AI 自动填充」并写清「使命」后，员工新建或修改记录时，系统把记录内容交给 AI，由它生成分类、摘要或一段文字填回该字段。填写不在保存的那一刻完成，而是先排进队列，由服务器上每分钟运行一次的后台程序逐条处理。本页是这个队列的看板：汇总各状态数量，列出开了 AI 的字段、最近的任务和 AI 写过的值，出问题时在这里找原因，也可以一键重试失败任务或清理旧记录。

页面概览

• 顶部按钮：「重试失败任务」「清理已完成」。
• 汇总区：五个计数卡片「待处理 pending」「等待重试（限流退避中）」「执行中 running」「已完成 done」「失败 failed」，下方一行「最近一次 runner 运行：时间」；有失败任务时多一条红色提示「有 N 条任务失败……」。
• 「AI 字段一览」：每个开过 AI 的字段一行，标题右侧注明「N 个字段配置了 AI」。
• 「任务列表」：最近 50 条任务，含「触发方式」「状态」「次数」「下次重试」「失败原因」等列。
• 「填值记录」：最近 50 次 AI 实际写入，含「模型」「依据摘要」「人工修改」等列。
• 提示条：功能没有初始化时整页只显示「功能尚未初始化……」，需要实施人员在服务器上执行一次补丁。

操作步骤

给字段打开 AI 自动填充

1. 打开「零代码定制 › 业务对象」，选中模块，切到「表单」页签。
2. 点击画布上的字段，右栏「组件属性」最下方出现「✨ AI 自动填充」区；从左栏「AI 自动填充」组拖入「分类」「摘要」「联网查找」「自定义」得到的新字段，这一区的开关已经打开。
3. 打开「AI 自动填充」开关，下方各项展开。
4. 选「AI 模式」，可选项随字段类型变化：下拉框、多选只有「分类」，文本、文本域有「摘要」「联网查找」「自定义」，数字有「联网查找」「自定义」。
5. 在「选个模板」里挑一个内置模板，「使命」「判断规则」（分类模板连同选项）自动填好，随后可以随意改；不用模板就直接写「使命」，「{} 插入变量」可以把本模块字段、派生变量或关联记录的字段以 {字段名} 形式插进句子。
6. 按需填写「判断规则」并勾选下方几个开关，含义见「字段与选项说明」。
7. 点击画布上方的「保存」。「使命」为空、或模式与字段类型不匹配时，服务器会拒绝这次保存，页面只提示「保存失败」，不显示原因；此时回到该字段的「AI 自动填充」区检查「AI 模式」和「使命」，补好后再保存。
8. 首次为某个字段打开 AI 并保存成功后，弹出「存量回填」，选「最近 100 条（推荐，先看看效果）」或「全部记录」；点击「暂不」则只对之后新建或修改的记录生效。
9. 点击「开始回填」，提示「已排入 N 条，后台会陆续填充。」；选的是「全部记录」时会先显示预计调用次数和耗时，再点击「确定」才入队。

保存后对之后的保存动作立即生效，不需要到「设置中心」清除缓存，也不需要重新登录；改动同步出现在本页「AI 字段一览」里。

看懂队列里的任务

员工在前台保存记录后，「任务列表」出现一行「pending」的任务；后台程序每分钟认领一批，处理中为「running」，完成为「done」，无法处理为「failed」。「等待重试」是遇到限流或服务暂时不可用后自动安排的重试，「下次重试」列显示时间；一条任务最多跑 3 次，两次等待分别约 1 分钟和 5 分钟，之后仍失败就记为「failed」。

排查时这样看：

1. 看「失败原因」一列：「done」但写着「模型未能给出可用结果」表示 AI 认为信息不足而弃权，字段保持原值；「字段已停用 AI」「记录已删除」表示排队期间配置或记录变了，直接跳过；「failed」的原因通常是密钥、供应商等需要管理员处理的问题。
2. 看「最近一次 runner 运行」：长时间不更新说明服务器上的定时程序没有在跑，需要实施人员检查，此时前台字段旁会一直显示「队列未运行」。

前台详情页里，开了 AI 的字段标签旁有 ✨ 图标，悬停显示「AI 于 某时 填写」及所用模型和依据；旁边的 ↻ 是「立即生成（会覆盖当前值）」，点击后先确认「将用 AI 重新生成这个字段，会覆盖当前值。继续？」，几秒内直接生成写回，不经过队列。任务未完成时标签下方显示「排队中·约 N 分钟」「生成中」「重试中」或「生成失败」，状态自动刷新。

重试失败任务和清理记录

1. 点击「重试失败任务」，所有「failed」任务重置为「pending」、次数归零，显示「已将 N 条失败任务重置为待处理」，下一分钟起重新处理；先解决失败原因再点。
2. 点击「清理已完成」，确认「确定要删除全部已完成 / 失败的任务记录吗？此操作不可撤销。」后，「done」和「failed」的任务从列表删除，显示「已清理 N 条已完成 / 失败的任务」；不清理时系统也会自动删除 7 天前完成的任务。

两个操作只影响任务记录，AI 已写进字段的值和「填值记录」不受影响。

字段与选项说明

字段属性里的「AI 自动填充」

项目	含义	备注
「AI 自动填充」	总开关	关闭时其余设置保留但不再入队
「AI 模式」	「分类」从字段现有选项里选一个；「摘要」把记录和沟通记录归纳成文字；「联网查找」上网查找记录里没有的外部信息；「自定义」按「使命」自由生成	「联网查找」由易客 CRM 智能体的 Agent 完成，需要至少一名用户已在「用户与 Agent」开通助手，且比其他模式慢
「选个模板」	内置的使命和规则范例，如「客户意向等级」「沟通要点摘要」「公司工商信息补全」	分类模板会替换字段现有选项，已配过选项时先确认
「使命」	告诉 AI 要判断或生成什么	必填；支持 {字段名} 变量，解析不到的变量按「(空)」处理
「判断规则」	补充的判断标准或写法要求	可留空
「允许 AI 生成新选项」	分类模式下允许 AI 给出不在选项列表里的值	只有下拉框、多选有
「带本记录字段与子明细」	把整条记录及子明细（如产品明细）交给 AI	默认开
「带沟通记录」	把联系记录和评论一并交给 AI	默认关
「新建时填充」「变更时刷新」	新建记录、编辑记录后是否入队	默认都开

本页各列

项目	含义	备注
「模式」「状态」「使命」	字段的 AI 模式中文名、「已启用」或「已停用」、使命前 60 字
「触发方式」	「on_create」新建、「on_change」修改、「backfill」存量回填	「立即生成」不进队列
「状态」	「pending」、「等待重试」、「running」、「done」、「failed」	停在「running」超过 10 分钟的任务会被自动放回队列
「次数」「下次重试」	已尝试次数和下一次重试时间	只有等待重试的任务显示时间
「模型」	写入时使用的模型，形如「供应商/模型」	分类、摘要、自定义用「模型设置」的默认模型
「依据摘要」	AI 参考了哪些字段、几条沟通记录和子明细	前 80 字
「人工修改」	「已修改」表示 AI 填过之后有人改过该值	之后自动填充不再覆盖，「立即生成」仍会覆盖

注意事项

• 后台处理程序需要实施人员在服务器上按每分钟一次挂定时任务，没有它队列只进不出；「最近一次 runner 运行」停在旧时间就是这个原因。
• 同一记录、同一字段有未处理任务时不会重复入队；编辑保存不比较改了哪个字段，「变更时刷新」打开时每次保存都入队，生成结果与现值相同时不写库。
• 「全部记录」回填按每分钟约 100 条估算，大模块可能要跑几十小时，先用「最近 100 条」看效果。
• 「模型设置」里没有选默认模型，或所选供应商没有密钥时，任务会失败，原因分别是「尚未设置默认模型，请到「AI 实例设置 → 模型设置」配置」和「该模型尚未配置 API Key」。
• 本页只显示最近 50 条任务和填值记录，更早的看不到；「记录 ID」是该条业务记录的编号，本页不提供跳转。