7.5 KiB
7.5 KiB
calendar +room-find
前置条件： 先阅读
../lark-shared/SKILL.md。
针对一个或多个时间块查找/搜索可用会议室。会议室是日程的一种资源型参与人，不能脱离日程单独预定。
需要的 scopes: ["calendar:calendar.free_busy:read"]
适用场景
- 已知一个或多个待选时间块，需要查找可用会议室
命令
lark-cli calendar +room-find \
--slot "2026-03-27T14:00:00+08:00~2026-03-27T15:00:00+08:00" \
--slot "2026-03-27T16:00:00+08:00~2026-03-27T17:00:00+08:00" \
--attendee-ids "ou_xxx,ou_yyy" \
--city "北京" \
--building "学清嘉创大厦B座" \
--floor "F2" \
--event-rrule "FREQ=DAILY;INTERVAL=1"
参数
| 参数 | 必填 | 说明 |
|---|---|---|
--slot <start~end> |
是 | 期望查询的时间块，格式需遵循 开始时间~结束时间。若存在多个候选时间块，可重复传入此参数。 |
--city <text> |
否 | 会议室所在城市强约束。仅当用户明确说出具体城市（如北京、上海）时才提取，严禁根据园区或楼宇名称自行联想或补全。 |
--building <text> |
否 | 会议室所在楼宇强约束，承载城市以下、楼层以上的办公区/园区/楼栋描述。 |
--floor <text> |
否 | 仅用于筛选会议室所在楼层。应先做归一化，再传递规范值；例如 2楼 / 二楼 / 2F 统一为 F2。注意：此参数只筛选楼层，不可混入区域定位（如“A区”）或具体会议室号。 |
--room-name <text> |
否 | 会议室名强约束。仅当用户明确提到会议室专名或会议室号（如“木星”“02”）时使用。应优先传递去后缀、去冗余后的规范名，例如 木星会议室 → 木星，会议室 02 / 02会议室 → 02。 |
--min-capacity <n> |
否 | 会议室最小容纳人数。当用户明确参会人数或提出“至少容纳N人”等要求时，提取数字放入此参数，必须为正整数。 |
--max-capacity <n> |
否 | 会议室最大容纳人数。用于过滤过大空间，必须为正整数。 |
--attendee-ids <id_list> |
否 | 参会对象 ID 列表。支持用户 ID（ou_ 前缀）和群组 ID（oc_ 前缀），多个 ID 以逗号分隔。 |
--event-rrule <rrule> |
否 | 重复日程的重复性规则，规则设置方式参考rfc5545。【⚠️注意：系统绝对不支持 COUNT，如需限制重复次数，必须转为 UNTIL】。示例值："FREQ=DAILY;INTERVAL=1" |
--timezone <tz> |
否 | 对话中明确提及的预约日程所使用的时区（默认取用户设备时区，例如 Asia/Shanghai） |
规则
- 多个
--slot会由 CLI 内部并发调用单时间块接口，再聚合成一次输出 +room-find的时间输入必须是确定时间块，不是时间区间搜索。- 如果是重复性日程，必须校验返回中的
reserve_until_time（该会议室最晚可预约时间）是否覆盖event-rrule对应的重复范围。 --city仅在用户明确说出城市时才提取；不要仅凭望京办公室、漕河泾园区、南山办公室这类位置名自动补城市。- 若已经提取了
--city，则--building中不要再重复携带城市前缀。例如用户说北京学清嘉创大厦B座时，应提取为--city "北京"与--building "学清嘉创大厦B座"，不要把北京学清嘉创大厦B座原样整体传入--building。 - 同一语义槽位只保留一个规范值。例如用户说“2楼”，应转换为
--floor "F2"；禁止同时传2楼 F2这类重复楼层信息。 - 参数归类顺序应为：
city/building/floor>floor + room-name复合表达 >room-name。若短词更像楼层/区域定位（如2L、2F），优先落到--floor，不要默认落到--room-name。像学清2层这种表达，通常拆为--building "学清"与--floor "F2"。 - 对会议室名要做轻量归一化：
木星会议室应提取为--room-name "木星"；会议室 02/02会议室应提取为--room-name "02"。 - 对复合会议室号要优先拆分结构化信息：
F3-05/F5-07/3楼-08这类表达，若可稳定识别楼层与会议室号，应优先提取为--floor "F3"+--room-name "05"、--floor "F5"+--room-name "07"、--floor "F3"+--room-name "08"，不要把整段直接作为--room-name。 - 当提供了会议室搜索筛选条件时，返回结果也不保证与搜索词完全字面匹配。底层可能会结合邻近楼层做推荐，例如用户搜索
2层，即使2层没有空闲会议室，也可能返回相近的3层候选。这不应被误判为接口返回异常。
输出格式
将返回的候选会议室整理为易读的结构化排版向用户展示。严禁将时间和会议室名称放在同一行展示，必须分行并使用编号列表呈现可用会议室，严禁揉成一团纯文本堆叠。
## 2026-03-27 周五
[选项 1] 14:00 - 15:00
可用会议室：
1. 学清嘉创大厦B座-F2-02🎦(7人)
2. 学清嘉创大厦B座-F3-05🎦(11人)
💡 请回复您倾向的选项编号以及对应的会议室序号，我来为您完成预定。
AI 行为指导：
- 结构化展示时间块与会议室：默认按“时间块 -> 会议室候选”的层级结构展示。严禁将时间与会议室名称输出在同一行。以清晰的分行列表呈现可用会议室，并直接询问用户意向。默认原样展示完整
room_name；不要擅自缩写、截断、改写，或仅提取楼层及会议室号替代完整名称。room_name必须逐字透传：展示给用户的会议室名称，必须直接使用 CLI/API 返回的room_name原值。禁止提取楼层、会议室号、容量、视频能力后重组成新的名称，禁止意译、缩写、去前缀、去后缀，或仅保留“便于阅读”的摘要名。- 重复日程要明确阻断原因与自动缩短：若某候选会议室的
reserve_until_time无法覆盖重复性日程，必须向用户明确说明该会议室最长可约至何时。若用户确认继续选用该会议室，你必须自动将日程的重复规则结束时间缩短至该reserve_until_time，以防止会议室预约失败。不能直接按原规则继续。- 正确解释推荐结果：如果返回结果与用户输入条件不完全字面一致，先说明底层可能返回邻近位置或相近条件的推荐候选，不要直接将其判定为异常。
- 默认减少用户输入成本：应主动引导用户不必一开始就提供很详细的会议室搜索条件。只要时间块已明确，用户直接表达“想约会议室”即可，先基于当前信息查询候选；只有在用户对结果不满意时，再引导其补充更具体的楼宇、楼层、会议室名或容量条件。
字段说明：
| 字段名 | 说明 |
|---|---|
room_id |
会议室唯一标识，用于后续创建日程时添加为会议室参与人使用。 |
room_name |
会议室名称，默认原样完整展示给用户，不要自行缩写、截断、改写，也不要用楼层及会议室号摘要替代原值。 |
capacity |
会议室最大容纳人数。 |
reserve_until_time |
该会议室当前允许被预约到的最晚时间点，用于校验重复性日程是否超期。 |