SuperAPI AI 工具集

outlook_contacts

办公与效率

查看项目

更新于 10-26 18:14

技能介绍

用途

Outlook Contacts 用于管理用户 Outlook 账户中的联系人,帮助在不冗长提示的前提下完成联系人的查看、检索与维护。

主要能力

通过本地辅助命令行工具 outlook-contacts 提供以下子命令:

  • disconnect:断开关联
  • list:分页浏览联系人,支持 --page-size 与 --page-token
  • get:按联系人 ID 获取详情
  • search:按姓名、邮箱或电话号码搜索
  • create:创建联系人,可指定名、姓、邮箱、电话
  • update:更新指定字段,未指定字段保持原值
  • delete:删除联系人

通用选项 --timeout-secs N 默认 30 秒。--top、--limit、--max-results 仅为兼容别名,新命令中不建议使用。

输出约定

各子命令返回 JSON,包含 ok、action、status、count、next_page_token、total_people、contacts[](resource_name、display_name、emails、phones)、contact(resource_name、display_name、emails、phones、organization、title)等字段,具体因命令而异。

授权与连接

该技能依赖由 outlook-contacts 管理的 Outlook 连接器。使用 outlook-contacts --status 检查状态。连接或重连时,需以 Markdown 链接形式分享返回的 connect_url;断开时运行 disconnect,若返回 disconnect_url 则以 Markdown 链接形式分享,否则说明已断开。不得使用共享连接器辅助 CLI,不得手动编写令牌文件或猜测连接器状态。

使用方式与规则

  • 按姓名、邮箱或电话查找联系人使用 search;浏览联系人使用 list,并通过 --page-token 分页。
  • 联系人 ID 为不透明 Graph 字符串(如 AAMkAD...),须使用 list 或 search 返回的精确值。
  • 在用户请求清晰明确时,create、update、delete 可直接执行,无需额外确认。
  • 更新联系人时只修改指定字段。
  • 若 CLI 报告授权错误,重新检查 --status 并引导用户重新连接。
  • 不得打印连接器密钥或导出原始联系人数据,除非用户明确要求。
  • 不得在面向用户的文本中展示原始 Graph 标识符或内部响应字段(变更键、分页令牌、原始 JSON),仅在内部串联后续命令时复用 ID;用户明确要求或排障时必须展示时除外。

适用场景

适合需要集中浏览、按条件检索或维护 Outlook 联系人信息的个人与工作场景。

限制

资料未提供安装命令、收费方式、价格、支持的平台范围及与其他系统的集成说明;具体功能以实际 CLI 行为为准。