AgentMail

AgentMail 是什么？

AgentMail 是面向 AI 代理的邮箱收发 API。它为代理提供真实的邮箱收件箱（类似于 Gmail 为用户提供的），代理可以通过 REST API 创建、发送、接收和搜索邮件，作为自主或代理式工作流的一部分。

与其他注重通知的邮件 API 不同，AgentMail 专为双向对话设计：代理可以读取邮件、理解消息上下文（包括线程），并通过同一 API 驱动的收件箱工作流回复。

主要特性

• 收件箱 API（通过 API 创建、管理、操作）： 以编程方式配置和控制邮箱收件箱，而非手动管理。
• 线程与回复： 支持对话式交互，确保代理回复与现有消息线程对齐。
• 附件： 使代理能够处理邮件附件，而非仅限于纯文本消息体。
• 实时事件： 提供实时更新/事件，以便系统在新消息到达时做出响应。
• 自定义域名： 支持在自定义域名下创建收件箱。
• 开发者工具（类型化 SDK + Webhooks）： 提供 SDK 和基于 Webhook 的集成，同时支持 RESTful 端点。
• 语义搜索与数据提取： 增加语义搜索功能以及用于处理消息内容和提取数据的提取工作流。

如何使用 AgentMail

1. 从 SDK 或 API 开始。 本站展示 Python 入门指南，并支持 TypeScript 和 cURL。
2. 创建收件箱。 使用 API 创建收件箱（示例创建用户名 username="hello" 和域名 domain="agentmail.to" 的收件箱）。
3. 发送消息并观察实时投递。 “实时收件箱”演示显示，发送邮件后消息可实时出现。
4. 构建对话流程。 使用收件箱、线程/回复、附件处理和实时事件，实现代理行为，如响应、路由或数据提取。

使用场景

• 浏览器代理提取一次性验证码（2FA）： 在注册服务时，浏览器自动化代理可监控收件箱，从收到的邮件中提取 OTP/2FA 验证码。
• 行政助理通过邮件安排日程： 代理可接收日程请求、管理会议工作流，并通过邮件发送确认或摘要。
• 文档与附件处理： 代理可解析附件（如发票或收据），从邮件内容中提取相关信息。
• 客服智能路由： 支持邮件可摄入收件箱，根据消息内容和对话上下文路由至合适处理者。
• 代理间或工作流通信： 任何需要多轮邮件对话（而非仅通知）的代理系统，可使用线程和回复保持上下文。

常见问题

• AgentMail 是什么，与传统邮件 API 有何不同？ AgentMail 是面向 AI 代理的 API 优先邮件平台。它专为双向对话设计（读取、回复和线程），而许多传统邮件 API 仅面向单向通知。

• 我可以使用自己的自定义域名吗？ 可以。AgentMail 支持为收件箱使用自定义域名。

• AgentMail 支持附件吗？ 支持。该平台将附件处理纳入收件箱/邮件功能。

• 新消息到达时如何获取更新？ AgentMail 包含实时事件，平台还提及 Webhook 作为集成方式。

• AgentMail 与 Gmail 集成吗？ 提供的页面未提及 Gmail 集成。它描述通过 AgentMail API 配置收件箱和交互。

替代方案

• 交易邮件 API（注重通知）： 设计用于发送消息的邮件服务可帮助发送外发邮件，但通常不提供代理拥有的收件箱、实时对话/线程工作流。
• 基于 IMAP/SMTP 的收件箱自动化： 团队可使用 IMAP 读取和 SMTP 发送构建邮件处理层，但需自行实现收件箱配置、可靠性、线程逻辑和消息解析。
• 邮件解析与工作流自动化平台： 专注于入站邮件路由和提取的工具可支持工作流部分，但可能不提供 AgentMail 描述的 API 优先代理收件箱模式。
• 带自定义邮件连接器的代理编排框架： 代理平台可启用代理式工作流，但仍需邮件连接器或服务来管理收件箱、实时更新和线程回复。