---
title: Microsoft Teams
description: 管理 Teams 中的消息、反应和成员
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="microsoft_teams"
  color="#E0E0E0"
/>

{/* MANUAL-CONTENT-START:intro */}
[Microsoft Teams](https://teams.microsoft.com) 是一个强大的通信和协作平台，用户可以在团队和组织内进行实时消息、会议和内容共享。作为 Microsoft 生产力生态系统的一部分，Microsoft Teams 提供与 Office 365 无缝集成的聊天功能，用户可以发布消息、协调工作，并在设备和工作流之间保持连接。

使用 Microsoft Teams，您可以：

- **发送和接收消息**：通过聊天线程即时与个人或群组沟通  
- **实时协作**：在频道和聊天中共享更新和信息  
- **组织对话**：通过线程式讨论和持久聊天记录保持上下文  
- **共享文件和内容**：直接在聊天中附加和查看文档、图片和链接  
- **与 Microsoft 365 集成**：无缝连接 Outlook、SharePoint、OneDrive 等  
- **跨设备访问**：在桌面、网页和移动设备上使用 Teams，并同步云端对话  
- **安全通信**：利用企业级安全性和合规功能

在 Sim 中，Microsoft Teams 集成使您的代理可以通过编程方式直接与聊天消息交互。这为强大的自动化场景提供了可能，例如发送更新、发布警报、协调任务以及实时响应对话。您的代理可以向聊天或频道中写入新消息，根据工作流数据更新内容，并在协作发生的地方与用户互动。通过将 Sim 与 Microsoft Teams 集成，您可以弥合智能工作流与团队沟通之间的差距——帮助您的代理简化协作、自动化通信任务，并使您的团队保持一致。
{/* MANUAL-CONTENT-END */}

## 使用说明

将 Microsoft Teams 集成到工作流程中。读取、写入、更新和删除聊天和频道消息。回复消息、添加反应以及列出团队/频道成员。可以在触发模式下使用，当消息发送到聊天或频道时触发工作流程。要在消息中提及用户，请将他们的名字用 `<at>` 标签包裹起来：`<at>userName</at>`

## 工具

### `microsoft_teams_read_chat`

从 Microsoft Teams 聊天中读取内容

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `chatId` | string | 是 | 要读取的聊天 ID |
| `includeAttachments` | boolean | 否 | 下载并将消息附件（托管内容）包含到存储中 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | Teams 聊天读取操作成功状态 |
| `messageCount` | number | 从聊天中检索到的消息数量 |
| `chatId` | string | 读取的聊天 ID |
| `messages` | array | 聊天消息对象的数组 |
| `attachmentCount` | number | 找到的附件总数 |
| `attachmentTypes` | array | 找到的附件类型 |
| `content` | string | 聊天消息的格式化内容 |
| `attachments` | file[] | 为方便起见上传的附件（扁平化） |

### `microsoft_teams_write_chat`

在 Microsoft Teams 聊天中撰写或更新内容

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `chatId` | string | 是 | 要写入的聊天 ID |
| `content` | string | 是 | 要写入消息的内容 |
| `files` | file[] | 否 | 要附加到消息的文件 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | Teams 聊天消息发送成功状态 |
| `messageId` | string | 已发送消息的唯一标识符 |
| `chatId` | string | 发送消息的聊天 ID |
| `createdTime` | string | 创建消息的时间戳 |
| `url` | string | 消息的网页 URL |
| `updatedContent` | boolean | 内容是否成功更新 |

### `microsoft_teams_read_channel`

从 Microsoft Teams 频道读取内容

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `teamId` | string | 是 | 要读取的团队 ID |
| `channelId` | string | 是 | 要读取的频道 ID |
| `includeAttachments` | boolean | 否 | 下载并将消息附件（托管内容）包含到存储中 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | Teams 频道读取操作成功状态 |
| `messageCount` | number | 从频道中检索到的消息数量 |
| `teamId` | string | 读取的团队 ID |
| `channelId` | string | 读取的频道 ID |
| `messages` | array | 频道消息对象的数组 |
| `attachmentCount` | number | 找到的附件总数 |
| `attachmentTypes` | array | 找到的附件类型 |
| `content` | string | 频道消息的格式化内容 |
| `attachments` | file[] | 为方便起见上传的附件（扁平化） |

### `microsoft_teams_write_channel`

向 Microsoft Teams 频道编写或发送消息

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `teamId` | string | 是 | 要写入的团队 ID |
| `channelId` | string | 是 | 要写入的频道 ID |
| `content` | string | 是 | 要写入频道的内容 |
| `files` | file[] | 否 | 要附加到消息的文件 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | Teams 频道消息发送成功状态 |
| `messageId` | string | 已发送消息的唯一标识符 |
| `teamId` | string | 发送消息的团队 ID |
| `channelId` | string | 发送消息的频道 ID |
| `createdTime` | string | 消息创建的时间戳 |
| `url` | string | 消息的网页 URL |
| `updatedContent` | boolean | 内容是否成功更新 |

### `microsoft_teams_update_chat_message`

更新 Microsoft Teams 聊天中的现有消息

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `chatId` | string | 是 | 包含消息的聊天 ID |
| `messageId` | string | 是 | 要更新的消息 ID |
| `content` | string | 是 | 消息的新内容 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 更新是否成功 |
| `messageId` | string | 更新的消息 ID |
| `updatedContent` | boolean | 内容是否成功更新 |

### `microsoft_teams_update_channel_message`

更新 Microsoft Teams 频道中的现有消息

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `teamId` | string | 是 | 团队 ID |
| `channelId` | string | 是 | 包含消息的频道 ID |
| `messageId` | string | 是 | 要更新的消息 ID |
| `content` | string | 是 | 消息的新内容 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 更新是否成功 |
| `messageId` | string | 已更新消息的 ID |
| `updatedContent` | boolean | 内容是否成功更新 |

### `microsoft_teams_delete_chat_message`

在 Microsoft Teams 聊天中软删除一条消息

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `chatId` | string | 是 | 包含消息的聊天 ID |
| `messageId` | string | 是 | 要删除的消息 ID |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 删除是否成功 |
| `deleted` | boolean | 删除确认 |
| `messageId` | string | 已删除消息的 ID |

### `microsoft_teams_delete_channel_message`

在 Microsoft Teams 频道中软删除一条消息

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `teamId` | string | 是 | 团队的 ID |
| `channelId` | string | 是 | 包含消息的频道 ID |
| `messageId` | string | 是 | 要删除的消息 ID |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 删除是否成功 |
| `deleted` | boolean | 删除确认 |
| `messageId` | string | 已删除消息的 ID |

### `microsoft_teams_reply_to_message`

回复 Microsoft Teams 频道中的现有消息

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `teamId` | string | 是 | 团队 ID |
| `channelId` | string | 是 | 频道 ID |
| `messageId` | string | 是 | 要回复的消息 ID |
| `content` | string | 是 | 回复内容 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 回复是否成功 |
| `messageId` | string | 回复消息的 ID |
| `updatedContent` | boolean | 内容是否成功发送 |

### `microsoft_teams_get_message`

从 Microsoft Teams 聊天或频道中获取特定消息

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `teamId` | string | 否 | 团队 ID（用于频道消息） |
| `channelId` | string | 否 | 频道 ID（用于频道消息） |
| `chatId` | string | 否 | 聊天 ID（用于聊天消息） |
| `messageId` | string | 是 | 要检索的消息 ID |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 检索是否成功 |
| `content` | string | 消息内容 |
| `metadata` | object | 消息元数据，包括发送者、时间戳等 |

### `microsoft_teams_set_reaction`

在 Microsoft Teams 中为消息添加表情符号反应

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `teamId` | string | 否 | 团队 ID（用于频道消息） |
| `channelId` | string | 否 | 频道 ID（用于频道消息） |
| `chatId` | string | 否 | 聊天 ID（用于聊天消息） |
| `messageId` | string | 是 | 要添加反应的消息 ID |
| `reactionType` | string | 是 | 表情符号反应（例如：❤️, 👍, 😊） |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 是否成功添加了反应 |
| `reactionType` | string | 添加的表情符号 |
| `messageId` | string | 消息 ID |

### `microsoft_teams_unset_reaction`

在 Microsoft Teams 中从消息中移除表情符号反应

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `teamId` | string | 否 | 团队 ID（用于频道消息） |
| `channelId` | string | 否 | 频道 ID（用于频道消息） |
| `chatId` | string | 否 | 聊天 ID（用于聊天消息） |
| `messageId` | string | 是 | 消息 ID |
| `reactionType` | string | 是 | 要移除的表情符号反应（例如：❤️, 👍, 😊） |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 是否成功移除反应 |
| `reactionType` | string | 被移除的表情符号 |
| `messageId` | string | 消息的 ID |

### `microsoft_teams_list_team_members`

列出 Microsoft Teams 团队的所有成员

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `teamId` | string | 是 | 团队的 ID |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 列表是否成功 |
| `members` | array | 团队成员的数组 |
| `memberCount` | number | 成员总数 |

### `microsoft_teams_list_channel_members`

列出 Microsoft Teams 频道的所有成员

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `teamId` | string | 是 | 团队的 ID |
| `channelId` | string | 是 | 频道的 ID |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 列表是否成功 |
| `members` | array | 频道成员的数组 |
| `memberCount` | number | 成员总数 |
