技能介绍

解决什么问题

在泛微E10的九氚汇模块中处理客户、商机和线索时，有两个反复出现的工程问题：一是每张表单的接口路径、参数和必填项都不固定，直接写死请求很容易遇到参数缺失或默认值越权写入；二是接口调用通常依赖外部登录态和表单发现结果，缺少统一约定就很难稳定复用。这个技能把认证、发现、配置查询、缓存和交互约束纳入同一套规则，让 Agent 可以按固定流程操作九氚汇业务数据，而不是每次重新猜接口。

技能如何工作

这个技能先依赖 weaver-e10-login 提供完整域名与认证信息，自身不拼接认证字段，也不跳过登录检查。首次调用时会读取本地缓存文件，获取客户类型、状态、行业、线索池、行政区划和表单发现等稳定数据；缓存为空时再通过动态配置流程补齐，并在后续会话中复用。

所有接口调用前都要先读取对应模块和操作的参考文档，确认参数表、特殊后缀和自动填充规则。读取类接口可以直接调用；写入、转移、释放、领取等操作必须先展示候选信息，再由用户通过可点击按钮确认，不能自行决定。查询结果会保留接口返回的全量字段，列表还会输出分页信息，避免只展示少量摘要字段。

适用边界与注意点

这个技能适合九氚汇营销管理模块内的常规业务流程，包括客户查重、线索转客户、商机推进、联系记录录入和公海领取等。它不负责泛微E10其他模块，也不能替代业务规则判断。

使用时要注意几个边界：缓存中的选项 ID 和表单发现结果会复用，配置变化后需要按初始化流程刷新；操作结果只以接口返回的 status 或 resultCode 为准，不要再次查询去验证；创建数据时只能使用用户明确提供的字段，必填项缺失必须追问，不能填入默认值；行政区划需要传全路径 ID，金额统一转成数字；Ebuilder 关联字段不能走普通选项接口，要按关联表单查询获取 ID。