本技能是 swarm 智能体发送邮件时使用的 AgentMail 发送消息 API 规范参考，用于统一调用方式、避免因字段名或域名写错导致的发送失败。
用途与接口：发送接口为 POST https://api.agentmail.to/v0/inboxes/{inbox}/messages/send。基础 URL 必须使用 api.agentmail.to，不要使用 api.agentmail.ai。
主要能力与字段约定：请求 JSON 正文的字段只有 to、bcc、subject、text，其中内容字段必须用 text，不要使用 text_body、body 或 content。不要传 html：AgentMail 存在已知渲染问题，同时传 html 与 text 时 HTML 正文可能为空，客户端显示空白邮件；AgentMail 能自行正确渲染 text。
使用方式：一次性发送（如启动邮件或单条通知）不要创建可复用脚本，直接用 Bash 的 curl，或在需要 swarm 可见执行时使用内联 script_run。仅当发送会被反复触发的工作流复用时，才使用 script_upsert。curl 示例中 INBOX 为收件箱 ID，通过 Authorization: Bearer $AGENTMAIL_API_KEY 鉴权，--data-binary 传入 JSON 正文。API Key 需在 swarm 配置中配置或导出到 shell。可复用脚本示例会通过 ctx.swarm.config.get('AGENTMAIL_API_KEY') 运行时读取密钥，并用 fetch 调用同一接口，参数结构为 inbox、to、bcc、subject、text。
密送策略与审批：所有发给外部收件人的邮件必须在 bcc 中包含人工监督邮箱，以便操作者了解 swarm 外发内容；swarm 自有智能体收件箱之间的内部邮件无需 BCC。未经明确人工批准，不得向外部收件人发送外联或冷邮件，需先起草、提交审核，批准后再发送。
检查清单：发送前确认使用正确基础 URL，仅用 to、bcc、subject、text 字段，内容用 text 而非 text_body/body/content，不传 html，外部收件人抄送监督地址，外联邮件取得人工批准，一次性发送用 curl 或 script_run、仅可复用工作流用 script_upsert。
常见错误：404 检查基础 URL 是否用了 api.agentmail.ai；422 报 text Field required 说明用了 text_body 或 body；401 说明未在 swarm 配置中配置 AGENTMAIL_API_KEY，脚本中应使用 swarm.config.get；HTML 渲染问题应完全不传 html。