teams_search_messages

Microsoft Teams · macOS · Windows

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

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

macOS

Назначение

Ищет сообщения чатов и каналов Microsoft Teams учетной записи Microsoft 365 с помощью Microsoft Search: по тексту и, при желании, по отправителю и диапазону дат. Используйте, чтобы найти, где что-либо обсуждалось, не зная чата. Результаты приходят в порядке релевантности Microsoft (а не от новых к старым), а body — это фрагмент вокруг совпадения, а не все сообщение; остальное прочитайте через teams_read_chat_messages. Возвращает не более 100 результатов не более чем с 4 страниц поиска. Если чтение прерывается (из-за этого предела или потому, что вызову не хватило времени), в ответе будет truncated: true. Требуется рабочая или учебная учетная запись Microsoft 365, подключенная через connect_m365_account (у личных учетных записей Microsoft нет доступа к чтению Teams). Если не подключена вообще ни одна учетная запись Microsoft 365, вместо этого читается локальный кеш приложения Teams на этом Mac (требуется Full Disk Access; данные могут отставать на часы или дни); source в ответе указывает, какой источник ответил (graph или local_cache).

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

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

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

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

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях 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"
    },
    "from_sender": {
      "description": "Only messages from this sender (name or email; optional)",
      "type": "string"
    },
    "limit": {
      "description": "Max results (default 25, max 100)",
      "type": "integer"
    },
    "query": {
      "description": "Text to search for",
      "type": "string"
    },
    "since": {
      "description": "Only messages on/after this date, YYYY-MM-DD (optional)",
      "type": "string"
    },
    "until": {
      "description": "Only messages on/before this date, YYYY-MM-DD (optional)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

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

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

{
  "limit": 5,
  "query": "launch checklist"
}

Windows

Назначение

Ищет по тексту, имени отправителя и/или диапазону дат во всей вашей истории чатов и личных сообщений Microsoft Teams (во всех разговорах сразу). Используйте, чтобы найти, где что-либо обсуждалось в Teams, не зная конкретного чата. Возвращает совпавшие сообщения (самые релевантные первыми), каждое с фрагментом и чатом, из которого оно получено. Возвращает не более 100 результатов не более чем с 4 страниц поиска. Если чтение прерывается (из-за этого предела или потому, что вызову не хватило времени), в ответе будет truncated: true.

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

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

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях 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"
    },
    "from_sender": {
      "description": "Filter to a sender by name (optional)",
      "type": "string"
    },
    "limit": {
      "description": "Max results (default 25, max 100)",
      "type": "integer"
    },
    "query": {
      "description": "Text to find in messages",
      "type": "string"
    },
    "since": {
      "description": "Only messages on/after this date, YYYY-MM-DD (optional)",
      "type": "string"
    },
    "until": {
      "description": "Only messages on/before this date, YYYY-MM-DD (optional)",
      "type": "string"
    }
  },
  "type": "object"
}

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

{
  "limit": 5,
  "query": "launch checklist"
}