用途:指导在 Cloudflare 平台上发送事务性邮件(Email Sending)与接收/路由邮件(Email Routing)。资料强调该产品 2025 年推出且快速演进,应优先检索官方来源而非依赖预训练知识;若技能与官方文档、REST API 规范、@cloudflare/workers-types、Agents SDK 仓库有出入,以原始来源为准。
主要能力:从 Worker 通过绑定发信(无需 API 密钥);从 Agents SDK 智能体发信(onEmail() 与 replyToEmail());从外部应用经 REST API 携带 Bearer token 发信;从编码智能体经 MCP 工具、wrangler CLI 或 REST API 发信;用 Workers email() 处理器接收并处理来信;配置发信/路由;改善送达率。
使用方式:先检查前置条件——用 npx wrangler email sending list 查看已启用发信的域名,未列出则运行 npx wrangler email sending enable userdomain.com;在 wrangler.jsonc 配置 send_email 绑定;接收/解析邮件需安装 postal-mime(npm ls postal-mime)。Workers 绑定示例:在 wrangler.jsonc 写 { "send_email": [{ "name": "EMAIL" }] },再调用 env.EMAIL.send(),from 域名须已启用。REST API 端点为 POST https://api.cloudflare.com/client/v4/accounts/{account_id}/email/sending/send,from 用 address 字段,replyTo 写作 reply_to,响应返回 delivered、permanent_bounces、queued。
适用场景:Worker、Agents SDK 智能体、外部应用与编码智能体的发信,以及来信接收与转发。
限制与注意:仅用于事务性邮件,营销/群发需另用平台;from 必须使用已启用域名;message.raw 只能读一次,需先缓冲;应同时提供 html 与 text;转发目标须为已验证地址;开发时勿用虚假地址;勿硬编码 API token。具体价格、限额等资料未提供,需查阅官方文档。