Appearance
网易邮箱
官方免费 云插件。本文依据插件市场当前上架信息与平台导入目录中的工具定义编写；不提供调用示例。
功能说明
通过标准 IMAP/SMTP 安全收发、搜索和管理网易及常见邮箱中的邮件。
接入与授权
填写邮箱地址和 IMAP/SMTP 客户端授权码，不是登录密码。
| 授权字段 | 页面名称 | 必填 | 类型 |
|---|---|---|---|
email | 邮箱地址 | 是 | |
authorization_code | IMAP/SMTP 授权码 | 是 | 密码输入框 |
授权信息仅用于当前用户的插件调用。请勿在提示词、工作流变量、日志或文档中填写令牌、密码、访问密钥或私有密钥。
工具目录
| 工具 | 说明 |
|---|---|
test_connection | 验证邮箱地址和客户端授权码是否可以登录 IMAP。 |
send_email | 发送纯文本或 HTML 邮件，可抄送、密送并附加公网 URL 文件。 |
list_emails | 列出邮箱中最近的邮件，可限定时间和未读状态。 |
search_emails | 按主题、发件人、时间和已读状态搜索邮件。 |
get_email | 按 UID 获取一封邮件的正文、头信息和附件清单。 |
get_attachment | 按邮件 UID 获取附件，返回文件名、类型和 Base64 内容，单个附件不超过 20MB。 |
mark_email | 批量将邮件标记为已读或未读。 |
list_mailboxes | 列出邮箱中的文件夹。 |
工具与参数
test_connection
验证邮箱地址和客户端授权码是否可以登录 IMAP。
输入参数
无输入参数。
返回字段
| 字段 | 类型 | 必返 | 说明 |
|---|---|---|---|
success | boolean | 是 | — |
send_email
发送纯文本或 HTML 邮件，可抄送、密送并附加公网 URL 文件。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
to | array<string> | 是 | 收件人邮箱数组 |
subject | string | 是 | 邮件主题 |
body | string | 是 | 邮件正文 |
html | boolean | 否 | 正文是否为 HTML；默认值：false |
cc | array<string> | 否 | 抄送邮箱数组 |
bcc | array<string> | 否 | 密送邮箱数组 |
attachment_urls | array<string> | 否 | 公网可下载的附件 URL，最多 10 个，每个不超过 20MB |
返回字段
| 字段 | 类型 | 必返 | 说明 |
|---|---|---|---|
success | boolean | 是 | — |
refused_recipients | object | 否 | — |
list_emails
列出邮箱中最近的邮件，可限定时间和未读状态。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
mailbox | string | 否 | 邮箱文件夹；默认值：INBOX |
limit | integer | 否 | 返回数量，1-100；默认值：10 |
recent_hours | integer | 否 | 只查询最近多少小时 |
unseen | boolean | 否 | 是否只查询未读邮件 |
返回字段
| 字段 | 类型 | 必返 | 说明 |
|---|---|---|---|
emails | array<object> | 是 | — |
search_emails
按主题、发件人、时间和已读状态搜索邮件。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
subject | string | 否 | 主题关键词 |
from | string | 否 | 发件人关键词 |
mailbox | string | 否 | —；默认值：INBOX |
limit | integer | 否 | —；默认值：20 |
recent_hours | integer | 否 | — |
unseen | boolean | 否 | — |
返回字段
| 字段 | 类型 | 必返 | 说明 |
|---|---|---|---|
emails | array<object> | 是 | — |
get_email
按 UID 获取一封邮件的正文、头信息和附件清单。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
uid | integer | 是 | — |
mailbox | string | 否 | —；默认值：INBOX |
返回字段
| 字段 | 类型 | 必返 | 说明 |
|---|---|---|---|
uid | integer | 是 | — |
from | string | 否 | — |
to | string | 否 | — |
cc | string | 否 | — |
subject | string | 否 | — |
date | string | 否 | — |
text | string | 否 | — |
html | string | 否 | — |
attachments | array<object> | 否 | — |
get_attachment
按邮件 UID 获取附件，返回文件名、类型和 Base64 内容，单个附件不超过 20MB。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
uid | integer | 是 | — |
filename | string | 否 | — |
mailbox | string | 否 | —；默认值：INBOX |
返回字段
| 字段 | 类型 | 必返 | 说明 |
|---|---|---|---|
attachments | array<object> | 是 | — |
mark_email
批量将邮件标记为已读或未读。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
uids | array<integer> | 是 | — |
read | boolean | 是 | — |
mailbox | string | 否 | —；默认值：INBOX |
返回字段
| 字段 | 类型 | 必返 | 说明 |
|---|---|---|---|
success | boolean | 是 | — |
uids | array<integer> | 否 | — |
read | boolean | 否 | — |
list_mailboxes
列出邮箱中的文件夹。
输入参数
无输入参数。
返回字段
| 字段 | 类型 | 必返 | 说明 |
|---|---|---|---|
mailboxes | array<string> | 是 | — |
使用约束
- 先在插件市场安装插件，再将其添加到智能体或工作流；插件参数由对应工具节点配置。
- 对会改变外部数据的工具（例如发送邮件、创建生成任务、领取权益或财务操作），应在智能体指令中要求用户明确确认后再执行。
- 调用失败时应检查授权状态、必填字段、提供方配额和网络可达性；不要用编造的数据替代工具结果。