teams_read_chat_messages

Microsoft Teams · macOS · Windows

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

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

macOS

用途

读取 Microsoft Teams 聊天（chat_id 来自 teams_list_chats）中最近的消息，最旧的在前，来自 Microsoft 365。已删除的消息会被跳过；系统事件（有成员加入、通话）显示为 [kind]。时间采用 ISO 8601 格式，使用这台电脑的时区并附带其偏移量（2026-10-11T14:05-03:00）。最多读取 20 页、每页 50 条消息，包括已删除的消息。当读取被截断（因达到该上限，或因调用超时）时，答复中会带有 truncated: true。需要用 connect_m365_account 连接工作或学校的 Microsoft 365 账户（个人 Microsoft 账户无法读取 Teams）。如果完全没有连接 Microsoft 365 账户，则改为读取这台 Mac 上 Teams 应用的本地缓存（需要完整磁盘访问权限，可能落后数小时或数天）；答复中的 source 会说明由哪一个提供了答复（graph 或 local_cache）。

必填输入

chat_id

输入名称会严格保持工具要求的形式。下方可展开的架构中保留英文规范技术定义。

权限与确认

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

仅使用用户在此平台上授权的应用、账户和资源。请查阅此工具针对平台的说明，以了解其连接和权限要求；本目录不声称需要额外的 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"
    },
    "chat_id": {
      "description": "Chat ID from teams_list_chats",
      "type": "string"
    },
    "limit": {
      "description": "Max items to return (default 50)",
      "type": "integer"
    }
  },
  "required": [
    "chat_id"
  ],
  "type": "object"
}

文档示例

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

{
  "chat_id": "demo-chat-001"
}

Windows

用途

读取某个 Teams 聊天对话中的消息。最多读取 20 页、每页 50 条消息，包括已删除的消息。当读取被截断（因达到该上限，或因调用超时）时，答复中会带有 truncated: true。时间采用 ISO 8601 格式，使用这台电脑的时区并附带其偏移量（2026-10-11T14:05-03:00）。