upc_free_classrooms
Find free UPC classrooms for a campus, date, and class periods. Query public room records, verify per-room occupancy, and return available or access-restricted rooms for study planning.
Instructions
Query public classroom records with an explicit verification scope.
Anonymous read-only requests to fixed school endpoints. No account, Cookie, URL, header, or arbitrary endpoint is accepted.
search-all supplies only the room directory and building options.
Its d.js occupancy is ignored: it neither vetoes a detail-free room
nor becomes occupied when detail fails. mode=auto returns a
directory-only per-building overview for "全部"; a 1–2 building scope is
checked room by room through the official detail endpoint.
mode=full also supports "全部", but that is a deliberately heavy
explicit request. Overview does not return candidate free-room counts.
available means the per-room detail record has no selected-period
lessArr overlap; it is not proof of a live empty seat, reservation,
or admission. Name markers are returned separately as
access_restriction; available_restricted rooms are not ordinary
self-study recommendations and are not returned by only_available.
availability_certainty reflects detail coverage only, not access.
If the user already named one or two buildings, query them directly; do not ask again. Only an all-building request should start with the overview and a narrowing question.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"campus": "<campus>",
"date": "<date>",
"periods": "<periods>"
},
"name": "upc_free_classrooms"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | 查询日期，显式 YYYY-MM-DD。 | |
| mode | No | auto：全部范围返回按楼目录概览，1–2 栋走 full；overview：只返回目录楼宇/教室数，不查 detail、不判断占用；full：对所选范围（含“全部”）每间 detail 校验。 | auto |
| limit | No | 本次最多返回 1–500 间，默认 200。 | |
| campus | Yes | 唐岛湾校区或古镇口校区；也接受唐岛湾/古镇口简称。 | |
| offset | No | 房间结果偏移，默认 0。 | |
| periods | Yes | 节次 1–12，至少一节；重复值会去重并按升序提交。第 13 节未验证，传入会返回 unsupported_period。 | |
| building | No | “全部”或学校返回的 building_options[].id；省略 buildings 时使用。 | 全部 |
| buildings | No | 可选；1–2 个 building_options[].id。指定后走 full 逐间校验。 | |
| only_available | No | true 只返回普通自习推荐：detail 记录在所选节次无占用，且名称没有研究生专用/教师专用/专用教室等限制线索。受限但记录空闲的房间在 restricted_rooms 单列；unknown/occupied 不返回。 | |
| include_conflicts | No | 已弃用，仅为兼容旧调用保留且不改变结果。search-all 的占用集合不参与判定，conflict_candidates 恒为空。 |