search_emails

macOS

用途

当用户希望在此 Mac 上查找特定电子邮件时使用此工具（Apple Mail——已添加到 Mail.app 的任何账户）。默认搜索主题和发件人；传入 scope="body" 或 scope="all" 还可搜索邮件正文（请查看响应中的 search_coverage——当本地索引仍在构建时，正文搜索可能不完整）。对于尚未添加到 Mail.app 的 Microsoft 365 邮箱，请使用 m365_search_emails。 重要提示：在拥有 2+ 个账户的计算机上，请使用 account=<name> 调用（名称来自 list_email_accounts）。若未传入该参数，且快速索引无法给出答案，search_emails 会返回账户列表，而不是扫描所有账户——在一次调用中扫描每个账户没有时间限制，也可能阻塞 Mail 对其他请求的处理。恰好只有 1 个账户时不受影响。

必填输入

• query

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

权限与确认

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

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

{
  "properties": {
    "account": {
      "type": "string"
    },
    "limit": {
      "default": "20",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "mailbox": {
      "type": "string"
    },
    "query": {
      "type": "string"
    },
    "scope": {
      "default": "metadata",
      "description": "\"metadata\" (default, subject+sender — fast, unchanged behavior), \"body\" (message body only, via a local index — see search_coverage in the response), or \"all\" (subject+sender+body).",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

文档示例

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

{
  "query": "launch checklist"
}