AgentMail — 智能体邮件平台

AgentMail 是专为 AI 智能体设计的 API 优先邮件平台。与传统邮件提供商（Gmail、Outlook）不同，AgentMail 提供程序化收件箱、按用量计费、大容量发送和实时 webhook。

核心能力

• 程序化收件箱：通过 API 创建和管理电子邮件地址
• 发送/接收：支持富内容的完整邮件功能
• 实时事件：Webhook 通知传入消息
• AI 原生功能：语义搜索、自动标签、结构化数据提取
• 无速率限制：专为大容量智能体使用设计

快速开始

• 在 console.agentmail.to 创建账户
• 在控制台仪表板生成 API 密钥
• 安装 Python SDK：pip install agentmail python-dotenv
• 设置环境变量：AGENTMAIL_API_KEY=your_key_here

基本操作

创建收件箱

from agentmail import AgentMail
import os
client = AgentMail(api_key=os.getenv("AGENTMAIL_API_KEY"))
# 创建带自定义用户名的收件箱
inbox = client.inboxes.create(
    username="spike-assistant",  # 创建 spike-assistant@agentmail.to
    client_id="unique-identifier"  # 确保幂等性
)
print(f"已创建: {inbox.inbox_id}")

发送邮件

client.inboxes.messages.send(
    inbox_id="spike-assistant@agentmail.to",
    to="adam@example.com",
    subject="任务完成",
    text="PDF 旋转已完成，请查看附件。",
    html="
PDF 旋转已完成。请查看附件。
",
    attachments=[{
        "filename": "rotated.pdf",
        "content": base64.b64encode(file_data).decode()
    }]
)

列出收件箱

inboxes = client.inboxes.list(limit=10)
for inbox in inboxes.inboxes:
    print(f"{inbox.inbox_id} - {inbox.display_name}")

高级功能

Webhook 实时处理

设置 webhook 立即响应传入邮件：

# 注册 webhook 端点
webhook = client.webhooks.create(
    url="https://your-domain.com/webhook",
    client_id="email-processor"
)

详细 webhook 设置请参见 WEBHOOKS.md。