用途：AgentMail 是一个 API 优先的邮箱，与只能发送的服务不同，它的收件箱既能发也能收，使智能体可以完成完整的邮件往返，例如注册服务、等待验证邮件、提取验证码后继续流程。
主要能力：发送、接收、回复、搜索及等待邮件，可通过 REST、Python/TypeScript SDK 或 CLI 调用。鉴权使用 Bearer 头，密钥为 $AGENTMAIL_API_KEY。发送时始终同时提供 text 与 html；回复应使用 reply 路由以保持会话线程正确。等待验证码可用 scripts/wait-for-email.sh --inbox "$INBOX" --from noreply@example.com --timeout 120。接收方式可选轮询、WebSocket 或 Webhook。
使用方式：先解析 inbox_id，顺序为环境变量 $AGENTMAIL_INBOX_ID、GET /v0/inboxes、POST /v0/inboxes（带 client_id 保证幂等）。SDK 安装命令为 npm install agentmail 或 pip install agentmail。项目自用时应把密钥放入被 gitignore 的 .env。
适用场景：本地测试、注册验证、验证码提取、自动回复循环、附件处理等。
限制：免费计划允许 3 个收件箱和每月 3000 封邮件；收件箱不能给自己发信；消息 ID 含尖括号需 URL 编码；退信与投诉是永久的，退信率需低于 4%；message.received 是唯一含完整线程与消息的事件；429 需遵守 Retry-After 并指数退避；403 missing_permission 需在控制台获取更宽权限的密钥。