SuperAPI AI 工具集

wecomcli-create-meeting

办公与效率

查看项目

更新于 10-16 09:20

技能介绍

企业微信会议创建技能(wecomcli-create-meeting)是企业微信 wecom-cli 命令行程序中的一项技能,所有操作均通过执行 wecom-cli 命令完成。该技能提供企业微信预约会议的创建能力,支持设置会议参数并邀请参与人,当用户需要"创建会议""预约会议""约会议""安排会议"时触发。

一、用途 该技能用于创建企业微信预约会议,可根据用户提供的时间、主题等信息生成会议,并返回会议号与会议链接。

二、命令调用方式 执行指定命令的格式为:wecom-cli meeting <tool_name> '<json_params>'

三、主要能力:创建预约会议(create_meeting) 执行命令示例:wecom-cli meeting create_meeting '{"title": "<会议标题>", "meeting_start_datetime": "<会议开始时间>", "meeting_duration": <会议持续时长(秒)>}'

入参说明: title(string,必填):会议标题。 meeting_start_datetime(string,必填):会议开始时间,格式为 YYYY-MM-DD HH:mm。 meeting_duration(integer,必填):会议持续时长(秒),例如 3600 = 1 小时。 description(string,选填):会议描述。 location(string,选填):会议地点。 invitees(object,必填):被邀请人,格式为 {"userid": ["lisi", "wangwu"]}。被邀请人 userid 通过 wecomcli-lookup-contact 技能获取。 settings(object,选填):会议设置,包含以下字段——password(string):会议密码;enable_waiting_room(boolean):是否启用等候室;allow_enter_before_host(boolean):是否允许成员在主持人进入前加入;enable_enter_mute(integer):入会时静音设置(枚举:0 关闭,1 开启);allow_external_user(boolean):是否允许外部用户入会;enable_screen_watermark(boolean):是否开启屏幕水印;remind_scope(integer):提醒范围(1 不提醒,2 仅提醒主持人,3 提醒所有成员,4 指定部分人响铃,默认仅提醒主持人);ring_users(object):响铃用户,格式为 {"userid": ["lisi"]},其 userid 同样通过 wecomcli-lookup-contact 技能获取。

返回参数包含:errcode、errmsg、meetingid(会议 ID)、meeting_code(会议号码)、meeting_link(会议链接)、excess_users(参会人中包含无效会议账号的 userid,仅在购买会议专业版企业由于部分参会人无有效会议账号时返回)。其中 meeting_code 向用户展示时需在回复开头单独一行纯文字展示,格式为 #会议号: xxx-xxx-xxx(每 3 位用 - 分隔)。

四、使用方式与典型工作流 工作流 1:最简创建(无邀请人)。用户意图如"帮我约一个明天下午3点的会议,主题是周例会,时长1小时"。步骤为:解析用户意图(时间 + 主题已有,邀请人未提及则默认留空,直接创建);调用创建命令(例如 wecom-cli meeting create_meeting '{"title": "周例会", "meeting_start_datetime": "2026-03-18 15:00", "meeting_duration": 3600}');展示结果时以 #会议号 开头,并列出会议标题、时间、时长与会议链接。

工作流 2:带邀请人 + 地点 + 描述。用户意图如"帮我约一个明天下午3点的会议,主题是技术方案评审,邀请张三和李四,地点在3楼会议室,时长1小时"。步骤为:解析用户意图(有邀请人,需先查询通讯录获取 userid);调用通讯录查询 wecom-cli contact get_userlist '{}',在返回的 userlist 中筛选 name 包含"张三"和"李四"的成员获取 userid;信息充分后直接调用创建命令(禁止暴露内部 ID);展示结果时列出会议标题、时间、时长、参与人姓名列表与会议链接。

复杂场景样例按需加载,避免一次性引入过多无关示例:references/example-security.md 适用于会议密码、等候室、外部用户限制;references/example-reminder.md 适用于响铃提醒、指定部分人响铃;references/example-full.md 适用于全参数综合场景(含静音、屏幕水印、等候室等设置)。

五、注意事项 信息追问:缺少时间或主题时,简洁追问用户;未提及邀请人则默认留空。 通讯录查询:涉及参与人时,需先通过 wecomcli-lookup-contact 技能的 get_userlist 接口获取全量通讯录成员,再按姓名/别名本地筛选匹配出对应的 userid。该接口无入参,返回当前用户可见范围内的成员列表(含 userid、name、alias)。 直接创建:时间 + 主题已知即可直接创建,邀请人有则带上、无则留空;无论信息是一次性提供还是上下文可推断,非必要则均不请求确认,直接创建。 时间格式:统一使用 YYYY-MM-DD HH:mm 格式。