sim/apps/docs/content/docs/zh/tools/gmail.mdx

---
title: Gmail
description: 发送、读取、搜索和移动 Gmail 邮件，或通过 Gmail 事件触发工作流
---

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

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

{/* MANUAL-CONTENT-START:intro */}
[Gmail](https://gmail.com) 是 Google 的一项流行电子邮件服务，提供了一个强大的平台，用于发送、接收和管理电子邮件通信。Gmail 拥有超过 18 亿的全球活跃用户，提供了功能丰富的体验，包括强大的搜索功能、组织工具和集成选项。

使用 Gmail，您可以：

- **发送和接收电子邮件**：通过简洁直观的界面与联系人交流
- **组织邮件**：使用标签、文件夹和过滤器保持收件箱井井有条
- **高效搜索**：利用 Google 强大的搜索技术快速找到特定邮件
- **自动化工作流**：创建过滤器和规则以自动处理收到的邮件
- **随时随地访问**：通过设备同步的内容和设置使用 Gmail
- **与其他服务集成**：连接 Google 日历、云端硬盘和其他生产力工具

在 Sim 中，Gmail 集成使您的代理能够以编程方式全面管理电子邮件，并具备全面的自动化功能。这支持强大的自动化场景，例如发送通知、处理收到的邮件、从电子邮件中提取信息以及大规模管理通信工作流。您的代理可以：

- **撰写和发送**：创建带有附件的个性化电子邮件并发送给收件人
- **读取和搜索**：使用 Gmail 的查询语法查找特定邮件并提取内容
- **智能组织**：将邮件标记为已读/未读，存档或取消存档电子邮件，并管理标签
- **清理收件箱**：删除邮件，在标签之间移动电子邮件，并保持收件箱整洁
- **触发工作流**：实时监听新邮件，启用对收到邮件的响应式工作流

此集成弥合了您的 AI 工作流与电子邮件通信之间的差距，实现了与全球最广泛使用的通信平台之一的无缝交互。无论您是在自动化客户支持响应、处理收据、管理订阅，还是协调团队通信，Gmail 集成都提供了全面的电子邮件自动化所需的所有工具。
{/* MANUAL-CONTENT-END */}

## 使用说明

将 Gmail 集成到工作流中。可以发送、读取、搜索和移动电子邮件。可以在触发模式下使用，当收到新电子邮件时触发工作流。

## 工具

### `gmail_send`

使用 Gmail 发送电子邮件

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `to` | 字符串 | 是 | 收件人邮箱地址 |
| `subject` | 字符串 | 否 | 邮件主题 |
| `body` | 字符串 | 是 | 邮件正文内容 |
| `contentType` | 字符串 | 否 | 邮件正文的内容类型（文本或 HTML） |
| `threadId` | 字符串 | 否 | 回复的线程 ID（用于线程化） |
| `replyToMessageId` | 字符串 | 否 | Gmail 消息 ID，用于回复 - 使用 Gmail 读取结果中的 "id" 字段（不是 RFC 的 "messageId"） |
| `cc` | 字符串 | 否 | 抄送收件人（逗号分隔） |
| `bcc` | 字符串 | 否 | 密送收件人（逗号分隔） |
| `attachments` | 文件[] | 否 | 附加到邮件的文件 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `content` | string | 成功消息 |
| `metadata` | object | 邮件元数据 |

### `gmail_draft`

使用 Gmail 草拟电子邮件

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `to` | 字符串 | 是 | 收件人邮箱地址 |
| `subject` | 字符串 | 否 | 邮件主题 |
| `body` | 字符串 | 是 | 邮件正文内容 |
| `contentType` | 字符串 | 否 | 邮件正文的内容类型（文本或 HTML） |
| `threadId` | 字符串 | 否 | 回复的线程 ID（用于线程化） |
| `replyToMessageId` | 字符串 | 否 | Gmail 消息 ID，用于回复 - 使用 Gmail 读取结果中的 "id" 字段（不是 RFC 的 "messageId"） |
| `cc` | 字符串 | 否 | 抄送收件人（逗号分隔） |
| `bcc` | 字符串 | 否 | 密送收件人（逗号分隔） |
| `attachments` | 文件[] | 否 | 附加到邮件草稿的文件 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `content` | string | 成功消息 |
| `metadata` | object | 草稿元数据 |

### `gmail_read`

从 Gmail 读取电子邮件

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | 否 | 要读取的消息 ID |
| `folder` | string | 否 | 要从中读取电子邮件的文件夹/标签 |
| `unreadOnly` | boolean | 否 | 仅检索未读消息 |
| `maxResults` | number | 否 | 要检索的最大消息数（默认：1，最大：10） |
| `includeAttachments` | boolean | 否 | 下载并包含电子邮件附件 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `content` | 字符串 | 邮件的文本内容 |
| `metadata` | JSON | 邮件的元数据 |
| `attachments` | 文件[] | 邮件的附件 |

### `gmail_search`

在 Gmail 中搜索邮件

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `query` | 字符串 | 是 | 邮件搜索查询 |
| `maxResults` | 数字 | 否 | 返回的最大结果数 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `content` | 字符串 | 搜索结果摘要 |
| `metadata` | 对象 | 搜索元数据 |

### `gmail_move`

在 Gmail 标签/文件夹之间移动邮件

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `messageId` | 字符串 | 是 | 要移动的邮件 ID |
| `addLabelIds` | 字符串 | 是 | 要添加的逗号分隔标签 ID \(例如：INBOX, Label_123\) |
| `removeLabelIds` | 字符串 | 否 | 要移除的逗号分隔标签 ID \(例如：INBOX, SPAM\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `content` | 字符串 | 成功消息 |
| `metadata` | 对象 | 邮件元数据 |

### `gmail_mark_read`

将 Gmail 邮件标记为已读

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `messageId` | 字符串 | 是 | 要标记为已读的邮件 ID |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `content` | string | 成功消息 |
| `metadata` | object | 邮件元数据 |

### `gmail_mark_unread`

将 Gmail 邮件标记为未读

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | 是 | 要标记为未读的邮件 ID |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `content` | string | 成功消息 |
| `metadata` | object | 邮件元数据 |

### `gmail_archive`

归档 Gmail 邮件（从收件箱中移除）

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | 是 | 要归档的邮件 ID |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `content` | string | 成功消息 |
| `metadata` | object | 邮件元数据 |

### `gmail_unarchive`

取消归档 Gmail 邮件（移回收件箱）

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | 是 | 要取消归档的邮件 ID |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `content` | string | 成功消息 |
| `metadata` | object | 邮件元数据 |

### `gmail_delete`

删除 Gmail 邮件（移至垃圾箱）

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | 是 | 要删除邮件的 ID |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `content` | string | 成功消息 |
| `metadata` | object | 邮件元数据 |

### `gmail_add_label`

为 Gmail 邮件添加标签

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | 是 | 要添加标签的邮件 ID |
| `labelIds` | string | 是 | 要添加的逗号分隔标签 ID（例如：INBOX, Label_123） |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `content` | string | 成功消息 |
| `metadata` | object | 邮件元数据 |

### `gmail_remove_label`

从 Gmail 邮件中移除标签

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | 是 | 要移除标签的邮件 ID |
| `labelIds` | string | 是 | 要移除的逗号分隔标签 ID（例如：INBOX, Label_123） |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `content` | string | 成功消息 |
| `metadata` | object | 邮件元数据 |

## 注意事项

- 类别：`tools`
- 类型：`gmail`