商务记录填写

目标

销售输入自然语言后，自动整理并创建商务记录。 如果信息缺失，先提醒补充。 提交前必须让用户确认。

注意：商务记录查询功能已移至 lcrm-search skill，本 skill 仅负责创建商务记录。

脚本入口

• 主脚本：node scripts/business-record.mjs <action> [options]

• 环境变量：

• 必填：LCRM_API_KEY

• 可选：LCRM_BASE_URL （默认 https://crm.langcore.net ）

目标接口

• POST /api/business-records

请求体关键字段：

• 必填：

• customerId 或 leadId （二选一，销售场景优先 customerId ）

• followUpType （枚举）

• contactedPerson

• description （去 HTML 后至少 10 个字）

• 可选：

• recordTime

• opportunityId

• opportunityStatus

• estimatedCloseDate

• actualCloseDate

• attachments

followUpType 枚举：

• 微信 电话 线上会议 邮件 现场拜访 商务活动 其他

必须执行的流程

• 解析用户输入，抽取：

• 客户名称

• 联系人名称

• 跟进类型（若无法判断先置空）

• 记录内容

• 客户名称转 ID：

• 脚本：node scripts/business-record.mjs find-customer --company-name "<客户名>" --limit 5

• 无结果：告知客户不存在并让用户补充准确名称。

• 多结果：列候选让用户确认唯一客户。

• 联系人校验（建议）：

• 脚本：node scripts/business-record.mjs customer-detail --customer-id "<customerId>" ，检查联系人是否存在。

• 若未命中，不阻断，但提示"联系人未在系统中匹配到，将按文本写入 contactedPerson"。

• 组装 payload 并做本地校验：

• description 长度 >= 10

• followUpType 必须在枚举中

• 提交前确认（强制）：

• 输出确认卡片，至少包含：

• customerId

• 客户名

• contactedPerson

• followUpType

• description 摘要

• recordTime （若为空说明"默认当前时间"）

• 仅当用户明确回复"确认/提交/是"再执行 POST。

• 提交并回传结果：

• 脚本：node scripts/business-record.mjs create --payload '<JSON>' 或 --payload-file <file>

• 成功：返回 id/recordTime 与关键字段。

• 失败：透出后端错误并给下一步补充建议。

命令示例

node scripts/business-record.mjs create
--customer-id "<customerId>"
--follow-up-type "电话"
--contacted-person "张三"
--description "已与客户确认POC范围和预算，预计下周提交技术方案。"

缺失信息提示模板

当以下字段缺失时，直接向用户追问：

• 缺客户名：请补充客户名称。

• 缺联系人：请补充本次对接人姓名。

• 缺跟进类型：请补充跟进类型（微信/电话/线上会议/邮件/现场拜访/商务活动/其他）。

• 缺记录内容或不足 10 字：请补充更完整的跟进记录（至少 10 个字）。

• 请求返回报错：请先完善联系人信息（姓名、电话、角色）后再新增商务记录 (此时需要用户前往LCRM系统web端完善联系人信息)。