SuperAPI AI 工具集

outlook_calendar

办公与效率

查看项目

更新于 10-26 18:14

技能介绍

Outlook Calendar 是一个用于管理 Outlook 日历事件的技能,底层通过名为 outlook-calendar 的配套 CLI 完成操作。该 CLI 已安装并位于 PATH 中,可通过 exec 直接运行。

主要能力:

  • 查看事件:使用 list 命令列出事件,支持 --page-size 控制返回数量,--time-min 与 --time-max 限定时间范围,--query 进行文本查询,--page-token 翻页;使用 get 命令按事件 ID 获取单个事件。
  • 创建事件:使用 create 命令,需提供 --summary 标题、--start 与 --end 起止时间、--timezone IANA 时区,可选 --attendee 参会人、--location 地点、--description 描述和 --all-day 全天标记。
  • 更新事件:使用 update 命令,按事件 ID 修改标题、起止时间、时区、地点或描述。
  • 删除事件:使用 delete 命令,按事件 ID 删除。
  • 账号管理:使用 --status 检查连接状态,使用 disconnect 断开连接。

认证与连接:认证由 CLI 管理的 Outlook 连接器处理,不应手写认证文件。首次使用或重新连接时,先运行 outlook-calendar --status;若返回 connect_url,需将其以 Markdown 链接形式提供给用户并等待其完成连接,然后再次运行同一状态命令确认。若返回 disconnect_url,表示账号已连接。断开连接时运行 outlook-calendar disconnect,并按返回的 disconnect_url 提供断开链接;若无该链接则说明账号已断开。

输出与使用要点:各命令输出 JSON,可解析 ok、action、status、event_id、web_link、count、next_page_token、retrieved_at、events、event 等字段。事件 ID 为不透明的 Graph 值,应原样复用 list 或 get 返回的 id。所有计时值必须使用 RFC3339/ISO 8601 格式,仅全天事件可使用纯日期值。创建时必须提供有效的 IANA 时区,更新中若变更起止时间也需提供时区。对于计时事件,优先使用 event_starts_at.user_local 与 event_ends_at.user_local;全天值为日历日期,不应做时区偏移。

操作限制:创建会发送邀请的事件前需与用户确认;私有事件更新可依用户明确请求进行;有参会人的组织者会议更新需确认,因为 Outlook 会发送会议更新邮件。当前工具不支持在更新时修改参会人,若用户要求增加或移除邀请对象,应说明该限制,而不是使用不支持的 --attendee 参数。删除可在用户请求明确无歧义时直接进行。不应向用户展示原始 Graph 标识符(事件 ID、日历 ID)或其他内部响应字段(变更键、分页/跳过令牌、原始 JSON),仅在内部串联后续命令时复用 ID;用户明确索要原始 ID 或排查故障时除外。列表查询应使用 --page-size,--top、--limit、--max-results 仅为兼容别名,不应在新命令中使用;列表的时间边界使用 --time-min/--time-max,--start/--end 仅在创建和更新中为标准参数。