m365_search_emails

Microsoft 365 · macOS · Windows

Эффект: чтение. Статус: условно доступен.

«Условная доступность» означает, что инструмент может зависеть от версии, платформы, разрешений, учётной записи или настроек. Он доступен не во всех установках.

macOS

Назначение

Используйте, когда пользователю нужно найти письма в его почтовом ящике Microsoft 365 / Outlook через облако — требует подключённого аккаунта M365. По умолчанию ищет по отправителю, теме И тексту письма (стандартное поведение $search в Microsoft Graph). Передайте scope="metadata", чтобы искать только по отправителю и теме (быстрее, без сканирования текста), или scope="body", чтобы искать только в тексте письма. Передайте folder, чтобы искать в одной папке (известное имя либо id, имя или путь из m365_list_email_folders). Для аккаунтов, добавленных в Mail.app на Mac, используйте search_emails.

Обязательные входные данные

query

Имена сохранены в точности как их требует инструмент. Канонические технические определения на английском находятся в раскрываемой схеме ниже.

Разрешения и подтверждение

Схема не объявляет явного параметра подтверждения. Это не разрешает действовать без согласия: проверьте эффект и получите разрешение.

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — 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"
    },
    "folder": {
      "description": "Search only this folder: a well-known name, or an id, name or path from m365_list_email_folders. Leave it out to search the whole mailbox.",
      "type": "string"
    },
    "limit": {
      "description": "Max results (default 20, max 50)",
      "type": "integer"
    },
    "query": {
      "description": "Search query, e.g. 'budget Q2', 'from:alice@contoso.com', 'subject:invoice'",
      "type": "string"
    },
    "scope": {
      "description": "\"all\" (default — sender+subject+body, today's behavior), \"metadata\" (sender+subject only), or \"body\" (body only).",
      "enum": [
        "metadata",
        "body",
        "all"
      ],
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Пример для документации

Пример документации для m365_search_emails. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

{
  "query": "launch checklist"
}

Windows

Назначение

Ищет в письмах Microsoft 365 по ключевому слову, отправителю или теме. Передайте folder, чтобы искать в одной папке (известное имя либо id, имя или путь из m365_list_email_folders).

Обязательные входные данные

query

Разрешения и подтверждение

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — Windows

{
  "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"
    },
    "folder": {
      "description": "Search only this folder: a well-known name, or an id, name or path from m365_list_email_folders. Leave it out to search the whole mailbox.",
      "type": "string"
    },
    "limit": {
      "description": "Max results (default 20, max 50)",
      "type": "number"
    },
    "query": {
      "description": "Search query, e.g. 'budget Q2', 'from:alice@contoso.com', 'subject:invoice'",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Пример для документации

{
  "query": "launch checklist"
}