agenticboxes — email for AI agents — agenticboxes — 用于AI代理的电子邮件

agenticboxes — AI代理的电子邮件 为代理提供了一个真实的电子邮件地址，可以通过简单的HTTP API发送和接收邮件。无需SMTP、IMAP、DKIM/SPF/DMARC设置 —— 只需一个API密钥。（与himalaya技能比较：它通过IMAP/SMTP驱动CLI邮件客户端，需要config.toml配置文件；agenticboxes是一个托管的HTTP API —— 注册并开始使用。）

何时使用 使用此技能时，代理需要： 发送电子邮件 —— 通知、推广、回复、确认。 接收电子邮件 —— 注册确认、2FA代码、回复、任何入站邮件。 拥有自己的地址以注册第三方服务（Stripe、SaaS工具、账户）。 获取帮助或改进平台 —— 向操作员提出支持问题，或提交功能请求。

步骤 先决条件 —— API密钥 如果设置了AGENTICBOXES_API_KEY，则使用它。否则，注册。 POST /signup/agentic开始注册；domain_intent.mode选择代理获取域名的方式： A · 免费子域名（mode：subdomain） —— 一个.agenticboxes.email地址。免费，无需信用卡。两次调用： curl -s https://api.agenticboxes.email/api/v1/signup/agentic \ -H 'Content-Type: application/json' \ -d '{"human_email":"owner@example.com","domain_intent":{"mode":"subdomain"}}' # → { "intent_id":"int_…", "full_domain":"swift-fox-7.agenticboxes.email" } curl -s https://api.agenticboxes.email/api/v1/signup/agentic/confirm \ -H 'Content-Type: application/json' -d '{"intent_id":"int_…"}' # → { "primary_address":"agent@swift-fox-7.agenticboxes.email", # "api_key":"bxs_live_…", "account_status":"active" } B · 注册真实域名（mode：register） —— agenticboxes为代理购买一个域名。发送domain_intent：{"mode":"register","register_domain":"youragent.com"}。注册响应携带stripe_payment_intent + link_spend_request（一年注册费用，及每月1美元的DNS托管费用）。所有者通过Stripe Link批准该费用；账户在付款清除后自动配置 —— 无需确认调用。 C · 自带域名，自己托管DNS（mode：byo_manual） —— 一个所有者已经控制并在其他地方托管的域名。发送domain_intent：{"mode":"byo_manual","byo_domain":"youragent.com"}。免费；完成注册与子域名相同。DNS记录（MX/SPF/DKIM/DMARC）作为domain.dns_required事件到达 —— 可以随时通过GET /events?type=domain.dns_required读取。一旦它们解析，账户即可激活。 D · 自带域名，委托DNS（mode：byo_delegated） —— 一个所有者控制的域名，但其DNS委托给agenticboxes运行的Route 53区。发送domain_intent：{"mode":"byo_delegated","byo_domain":"youragent.com"}。每月1美元的DNS托管费用；完成注册与子域名相同。domain.delegation_required事件列出需要在域名注册商处设置的nameserver；一旦委托传播，账户即可激活。

任何注册的可选项：initial_credit_cents（≥100 —— 预付信用）和agent_callback_webhook（事件Webhook URL）。立即存储返回的api_key —— 它只显示一次。每个账户开始时都有250条免费消息。

调用API 基准URL：https://api.agenticboxes.email/api/v1 认证：每次调用都携带Authorization：Bearer $AGENTICBOXES_API_KEY 发现：GET https://api.agenticboxes.email/.well-known/agentic.json返回此服务的清单 —— 技能、OpenAPI规范、注册、定价。

发送 —— POST /messages/send： curl -s https://api.agenticboxes.email/api/v1/messages/send \ -H "Authorization: Bearer $AGENTICBOXES_API_KEY" \ -H 'Content-Type: application/json' \ -d '{"from":"outreach@your-domain", "to":"someone@example.com", "subject":"Hello", "text":"Sent by my agent."}' 正文：to（字符串或数组，必需）、subject、text。可选：from —— 从域名上的特定邮箱发送（默认为账户的主邮箱）；attachments（[{filename, content_b64, content_type}】）；idempotency_key；和context —— 一个不透明的JSON对象（≤16 KB），存储与消息，并在任何入站回复中回显（见接收）。

接收 —— 三种方式到一个底层流： 事件提要（轮询） —— GET /events?since= —— 统一提要：平台为账户发出每个事件，一个有序流（mail.received、support.answered、domain.ready等）。处理一页，然后使用since设置为响应的next_cursor的轮询；使用?type=mail.received过滤到一种类型。这是永远不会错过任何内容的接收路径 —— 无论是否有Webhook。 消息（轮询） —— GET /messages?include=body —— 邮件语料库：带有内联正文的最近消息，按方向（接收或发送）、since、before、box、limit过滤。GET /messages/{id}读取一个。 Webhook（推送） —— PUT /account/callback-webhook {"agent_callback_webhook":"https://…"} —— 事件随着发生而被POST到该URL；可选。