teams_list_chats

Microsoft Teams · macOS · Windows

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

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

macOS

Назначение

Показывает чаты Microsoft Teams аккаунта Microsoft 365 — личные сообщения, групповые чаты и чаты встреч — сначала недавно активные, из Microsoft 365. У каждого чата есть id (для teams_read_chat_messages), название, остальные участники, тип (oneOnOne, group или meeting) и последнее сообщение. participants называет всех остальных участников; тот, чьё имя прочитать не удалось, отображается как "unnamed member" (или "unnamed member (external)"), но никогда не пропадает. participants_state показывает, насколько можно доверять списку: resolved, unresolved (хотя бы один без имени), only_you (в чате больше никого нет) или unknown (список участников прочитать не удалось: тогда participant_count и has_external_members отсутствуют). Читает не более 20 страниц по 50 чатов. Если чтение оборвано (из-за этого предела или потому, что вызов не уложился во время), в ответе будет 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"
    },
    "limit": {
      "description": "Max items to return (default 50)",
      "type": "integer"
    }
  },
  "required": [],
  "type": "object"
}

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

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

{
  "limit": 5
}

Windows

Назначение

Показывает ваши недавние чаты Microsoft Teams через Microsoft Graph с помощью подключённого аккаунта Microsoft 365. Читает не более 20 страниц по 50 чатов. Если чтение оборвано (из-за этого предела или потому, что вызов не уложился во время), в ответе будет truncated: true. participants называет всех остальных участников; тот, чьё имя прочитать не удалось, отображается как "unnamed member" (или "unnamed member (external)"), но никогда не пропадает. participants_state показывает, насколько можно доверять списку: resolved, unresolved (хотя бы один без имени), only_you (в чате больше никого нет) или unknown (список участников прочитать не удалось: тогда participant_count и has_external_members отсутствуют).

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

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

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях 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"
    },
    "limit": {
      "description": "Maximum chats to return (default: 50)",
      "type": "number"
    }
  },
  "type": "object"
}

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

{
  "limit": 5
}