teams_read_channel_messages

Microsoft Teams · macOS · Windows

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

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

macOS

Назначение

Читает самые недавние публикации канала Microsoft Teams (team_id из teams_list_teams, channel_id из teams_list_channels), от старых к новым, из Microsoft 365. Только публикации верхнего уровня: ответы не включаются. Для чтения сообщений канала нужно разрешение, которое одобряет администратор организации Microsoft 365; без него ответом будет consent_required с указанием, что делать. Читается не более 20 страниц по 50 публикаций, включая удаленные. Если чтение прерывается (из-за этого предела или потому, что вызову не хватило времени), в ответе будет truncated: true. Требуется рабочая или учебная учетная запись Microsoft 365, подключенная через connect_m365_account (у личных учетных записей Microsoft нет доступа к чтению Teams). Если не подключена вообще ни одна учетная запись Microsoft 365, вместо этого читается локальный кеш приложения Teams на этом Mac (требуется Full Disk Access; данные могут отставать на часы или дни); source в ответе указывает, какой источник ответил (graph или local_cache).

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

team_id
channel_id

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

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

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

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях 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"
    },
    "channel_id": {
      "description": "Channel ID from teams_list_channels",
      "type": "string"
    },
    "limit": {
      "description": "Max items to return (default 50)",
      "type": "integer"
    },
    "team_id": {
      "description": "Team ID from teams_list_teams",
      "type": "string"
    }
  },
  "required": [
    "team_id",
    "channel_id"
  ],
  "type": "object"
}

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

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

{
  "channel_id": "demo-channel-001",
  "team_id": "demo-team-001"
}

Windows

Назначение

Читает сообщения из указанного канала Teams (только публикации верхнего уровня; ответы не включаются). Читается не более 20 страниц по 50 публикаций, включая удаленные. Если чтение прерывается (из-за этого предела или потому, что вызову не хватило времени), в ответе будет truncated: true.

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

team_id
channel_id

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

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях 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"
    },
    "channel_id": {
      "description": "Channel ID from teams_list_channels (within that team)",
      "type": "string"
    },
    "limit": {
      "description": "Maximum messages (default: 50)",
      "type": "number"
    },
    "team_id": {
      "description": "Team ID from teams_list_teams",
      "type": "string"
    }
  },
  "required": [
    "team_id",
    "channel_id"
  ],
  "type": "object"
}

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

{
  "channel_id": "demo-channel-001",
  "team_id": "demo-team-001"
}