teams_list_chats

Microsoft Teams · macOS · Windows

效果: 读取. 状态: 受限可用.

“受限可用”表示工具可能取决于版本、平台、权限、账户或配置，并不表示它在所有安装中都已启用。

macOS

用途

列出某个 Microsoft 365 账户的 Microsoft Teams 聊天——私信、群聊和会议聊天——最近活跃的在前，读取自 Microsoft 365。每个聊天都有其 id（用于 teams_read_chat_messages）、标题、其他参与者、类型（oneOnOne、group 或 meeting）以及最后一条消息。participants 会列出其他每位成员；无法读取姓名的成员显示为 "unnamed member"（或 "unnamed member (external)"），绝不会显示为空。participants_state 说明可信程度：resolved、unresolved（至少有一位未命名）、only_you（聊天中没有其他人）或 unknown（无法读取成员列表：此时 participant_count 和 has_external_members 不会出现）。最多读取 20 页、每页 50 个聊天。当读取被截断（因达到该上限，或因调用超时）时，答复中会带有 truncated: true。需要用 connect_m365_account 连接工作或学校的 Microsoft 365 账户（个人 Microsoft 账户无法读取 Teams）。如果完全没有连接 Microsoft 365 账户，则改为读取这台 Mac 上 Teams 应用的本地缓存（需要完整磁盘访问权限，可能落后数小时或数天）；答复中的 source 会说明由哪一个提供了答复（graph 或 local_cache）。

必填输入

此平台的架构未声明必填输入，但仍可能存在可选选择器或运行时要求。

权限与确认

架构未声明明确的确认参数。这并不代表可以未经许可操作；请检查效果并取得授权。

仅使用用户在此平台上授权的应用、账户和资源。请查阅此工具针对平台的说明，以了解其连接和权限要求；本目录不声称需要额外的 OAuth 范围或操作系统授权。

英文规范技术架构 — macOS

{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "limit": {
      "description": "Max items to return (default 50)",
      "type": "integer"
    }
  },
  "required": [],
  "type": "object"
}

文档示例

teams_list_chats 的文档示例。请勿执行此示例。所示参数属于虚构数据集；在实际调用前，请解析真实标识符并获得授权。

{
  "limit": 5
}

Windows

用途

通过 Microsoft Graph，使用已连接的 Microsoft 365 账户，列出你最近的 Microsoft Teams 聊天对话。最多读取 20 页、每页 50 个聊天。当读取被截断（因达到该上限，或因调用超时）时，答复中会带有 truncated: true。participants 会列出其他每位成员；无法读取姓名的成员显示为 "unnamed member"（或 "unnamed member (external)"），绝不会显示为空。participants_state 说明可信程度：resolved、unresolved（至少有一位未命名）、only_you（聊天中没有其他人）或 unknown（无法读取成员列表：此时 participant_count 和 has_external_members 不会出现）。