m365_search_emails

Microsoft 365 · macOS · Windows

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

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

macOS

Назначение

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

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

query

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

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

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

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

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

{
  "properties": {
    "limit": {
      "description": "Max results (default 20, max 50)",
      "type": "integer"
    },
    "query": {
      "description": "Search query, e.g. 'budget Q2', 'from:[email protected]', '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 по ключевому слову, отправителю или теме.

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

query

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

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

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

{
  "properties": {
    "limit": {
      "description": "Max results (default 20, max 50)",
      "type": "number"
    },
    "query": {
      "description": "Search query, e.g. 'budget Q2', 'from:[email protected]', 'subject:invoice'",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

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

{
  "query": "launch checklist"
}