用途:AgentMail 是面向 AI 智能体的 API 优先邮件平台,设计支持双向会话,让智能体自主发送、接收和回复邮件。
主要能力:SDK 提供 Python 与 Node.js 客户端,支持创建收件箱、发送邮件(文本与 HTML)、回复邮件、按标签过滤列出消息、更新消息标签、全组织范围列出线程、发送附件。资源层级为 Organization → Pod(可选多租户)→ Inbox → Thread → Message → Attachment。提供 Webhook(HTTP POST 事件通知)与 WebSocket(持久双向连接)两类实时事件;Webhook 事件类型包括 message.received、message.sent、message.delivered、message.bounced、message.complained、message.rejected、domain.verified。另有 Draft、Domain、Labels 等概念。
使用方式:安装 pip install agentmail 或 npm install agentmail;客户端从环境变量 AGENTMAIL_API_KEY 读取密钥。创建收件箱与发送消息均通过 client.inboxes 相关方法完成。集成 AI 智能体可安装 pip install agentmail-toolkit,并分别对接 OpenAI Agents 或 LangChain。IMAP/SMTP 访问:IMAP 主机 imap.agentmail.to,端口 993(SSL);SMTP 主机 smtp.agentmail.to,端口 465(SSL),认证使用收件箱地址加 API 密钥。
适用场景:邮件自动化、AI 邮件智能体、邮件通知 Webhook 集成,以及需要智能体自主处理邮件往来的流程。
限制与注意事项:退信或被投诉地址会被永久屏蔽;退信率需低于 4%,否则账户进入审核。AWS Route 53 的 DKIM 记录必须拆分为两个带引号字符串且中间无空格;每个域仅允许一条 SPF 记录。message.received 是唯一携带完整 Thread 与 Message 数据的 Webhook 事件,其余事件仅有少量元数据。Pod 存在资源时无法删除,收件箱不可在 Pod 间移动。创建操作建议使用 client_id 保证幂等,Webhook 处理应立即返回 200 并后台处理。具体价格与收费方式暂未提供。