---
name: ai-base-meeting
description: AI基座会议管理系统 - 通过API创建会议和查询会议列表。当用户要求"创建会议"、"新建会议"、"安排会议"、"预定会议室"时使用此技能创建会议。当用户要求"查询会议"、"查看我的会议"、"我的会议列表"、"会议记录"时使用此技能查询会议列表。
---

# AI基座会议管理

## 认证流程

所有接口必须先获取 token，再使用 Bearer Token 认证。

1. **获取 Token：** `POST https://gateway.pccpage.cn/auth/param-token`
2. **使用 Token：** 在请求头中添加 `Authorization: Bearer <token>`

Auth 凭证默认使用预配置的值（userId=5, tenantId=1），可通过环境变量覆盖。

## 核心操作

### 1. 创建会议

**接口：** `POST https://gateway.pccpage.cn/gateway/oa-meeting/meetings`

创建会议时需要用户提供以下信息，如果用户未提供，**必须逐项询问**（不要一次性全问，按以下顺序逐个确认）：

1. **会议标题** → 直接问
2. **会议开始时间** → 直接问
3. **会议结束时间** → 直接问
4. **会议类型** → 默认 `WORKSHOP`，可选：`WORKSHOP`（工作坊）、`MEETING`（会议）、`TRAINING`（培训）、`OTHER`（其他）
5. **会议室ID** → 默认 `1`
6. **紧急程度** → 默认 `NORMAL`，可选：`HIGH`、`NORMAL`、`LOW`
7. **会议描述** → 可选，不提供则不填
8. **参会人ID** → 至少包含当前用户ID(`5`)，如需添加其他人询问具体人员ID

### 2. 查询会议列表

**接口：** `GET https://gateway.pccpage.cn/gateway/oa-meeting/meetings`

支持以下查询参数：

| 参数    | 说明                                                             | 默认值    |
| ------- | ---------------------------------------------------------------- | --------- |
| keyword | 标题搜索关键词                                                   | 空        |
| status  | 会议状态过滤：`PLANNED`、`IN_PROGRESS`、`COMPLETED`、`CANCELLED` | `PLANNED` |
| current | 当前页码                                                         | 1         |
| size    | 每页条数                                                         | 10        |

用户要求查询时，询问是否需要按状态筛选、关键词搜索。默认查询已计划的会议。

## 快捷使用（CLI脚本）

脚本位于 `scripts/meeting_manager.py`，支持命令行快捷操作：

```bash
# 获取 token
python meeting_manager.py token

# 创建会议
python meeting_manager.py create \
  --title "项目周例会" \
  --start "2026-04-15T09:00:00" \
  --end "2026-04-15T10:00:00" \
  --participants 5

# 查询会议列表（查询已计划的会议，第1页，每页10条）
python meeting_manager.py list --status PLANNED --page 1 --size 10
```

详细参数见 `--help`。

## 参考文档

详细的API参考和响应格式请查看 `references/api-reference.md`。
