JCOA 会议室预定

解决手动预订的字段对齐难题

在OA系统中手动预定会议室时，工程师常面临繁琐的表单填写和易错的字段对齐问题。例如，meetingType 必须使用接口返回的 id 或 idspan，参会人必须使用人员主键 id 而非 workcode，且创建请求中的 method 字段必须为空字符串，否则会议会被系统当作暂存草稿。手动拼装这些请求不仅效率低下，还极易因字段格式错误导致预订失败。

多轮对话与自动化校验工作流

该技能通过 config.yaml 配置 OA 账号，调用 jcoa_client.py 脚本与 JCOA HTTP API 交互，将繁琐的预订流程转化为自然的多轮对话。

1. 身份与基础信息收集：登录后自动获取当前用户的 id、mobile 等主键信息，仅向用户索要密码以外的必要字段。通过多轮对话确认会议类型、主题、时间及提醒配置。
2. 会议室智能推荐与匹配：调用接口查询空闲会议室。针对结果较长的问题，强制将数据重定向至临时文件分段读取。根据参会人数智能推荐最匹配的房间，并严格过滤出在选定时段内完全空闲的选项。
3. 参会人解析与冲突校验：通过姓名搜索参会人并转换为主键 id。在最终提交前，执行时段冲突校验，将会议时段与房间空闲时段逐条比对，确保会议时间完全落在空闲区间内，从源头杜绝时间冲突。

适用边界与核心红线

该技能专为依赖 JCOA 内部 API 的企业环境设计，需确保 base_url 网络可达且账号权限正常。在执行过程中，必须严格遵守以下约束：

• 禁止猜测提交：未获用户最终确认前，禁止创建会议；接口数据必须实时查询，禁止编造。
• 地点字段互斥：预定真实会议室时传 address（房间ID），自定义地点时传 customizeAddress，两者不可混用。
• 临时文件清理：流程结束后必须删除 rooms.json 和 meeting_temp.json 等中间产物，避免敏感数据残留。