sentio

这是什么？适合谁？

Sentio（truespar/sentio）是一个为 AI Agent 设计的邮箱 API。每个 AI Agent 可以拥有自己的真实邮箱地址，独立收发邮件、解析邮件线程、管理收件箱——让 Agent 拥有「电子身份」的通信能力。

与 sv-number MCP（Agent 手机号）形成互补：sv-number 解决「短信验证」，Sentio 解决「邮件通信」——两者结合构成 Agent 的完整数字身份基础设施。

适合人群：

• 构建 Agent 自动化工作流需要邮件交互的开发者
• 需要 Agent 自动处理邮件（如客服、发票处理、订阅管理）的团队
• 构建「数字员工」系统的企业
• 研究 Agent-to-Agent 邮件通信的从业者

不适合：只需要群发邮件营销的场景（用 SendGrid/Mailchimp）；不需要 Agent 的普通邮件客户端。

使用前提：Sentio API Key；MCP 兼容客户端或 REST API 调用能力；了解邮件协议基础（SMTP/IMAP）。

准备工作

1. Sentio 账号：访问 Sentio 官网 注册获取 API Key
2. API Key：在 Sentio 后台生成，用于 API 认证
3. 客户端：任意支持 REST API 的客户端，或通过 MCP 接入 Agent
4. 成本：Sentio 提供免费套餐（每天 50 封邮件）；付费套餐按邮件量计费
5. 时间预算：注册 3 分钟；首次让 Agent 收发邮件 10 分钟

快速上手（3 步）

第一步：创建 Agent 邮箱

curl -X POST https://api.truespar.com/v1/mailboxes \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "support-agent-1"}'

返回示例：

{
  "id": "mbx_abc123",
  "email": "support-agent-1@sentio.email",
  "status": "active"
}

第二步：让 Agent 发送邮件

curl -X POST https://api.truespar.com/v1/mailboxes/mbx_abc123/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "user@example.com",
    "subject": "你的订单已发货",
    "body": "您好，您的订单 #12345 已发货...",
    "thread_id": "thread_xyz"
  }'

第三步：让 Agent 读取收件箱

curl https://api.truespar.com/v1/mailboxes/mbx_abc123/messages?limit=10 \
  -H "Authorization: Bearer YOUR_API_KEY"

初级用法

邮件线程管理

Sentio 自动追踪邮件线程，Agent 可以按线程查看完整对话历史：

# 获取某个线程的全部消息
curl https://api.truespar.com/v1/threads/thread_xyz/messages \
  -H "Authorization: Bearer YOUR_API_KEY"

邮件规则与过滤

设置自动规则，让 Agent 只处理特定类型的邮件：

{
  "rules": [
    {
      "field": "subject",
      "pattern": "退款|退货|投诉",
      "action": "forward",
      "target": "human-support@company.com"
    }
  ]
}

高级玩法

Agent 邮箱池

为并行 Agent 各分配独立邮箱，实现大规模邮件处理：

# 伪代码：批量客服 Agent
agents = ["billing", "tech-support", "returns"]
for name in agents:
    mailbox = sentio.create_mailbox(name=name)
    agent = Agent(name=name, email=mailbox.email)
    agent.start_processing()

邮件内容结构化提取

结合 LLM 从邮件中提取结构化信息：

email = sentio.get_message(msg_id)
extracted = llm.extract(email.body, schema={
    "order_id": "string",
    "amount": "number",
    "issue_type": "enum[refund, complaint, inquiry]"
})

与工作流引擎集成

将 Sentio 接入 n8n / Dify 等引擎，实现「收到邮件 → 分类 → Agent 处理 → 回复 → 归档」的端到端自动化。

小技巧

1. 签名模板：为每个 Agent 邮箱预设签名模板，保持专业形象
2. 速率控制：设置 RATE_LIMIT=20/minute 避免被邮件服务商标记为垃圾邮件
3. 退信处理：监控 bounce 事件，自动清理无效邮箱地址
4. 附件安全：开启附件扫描，过滤可执行文件、宏文档等潜在威胁
5. 多语言：配合 LLM 自动翻译邮件内容，实现多语言客服 Agent

常见踩坑

踩坑 1：邮件被标记为垃圾邮件

现象：Agent 发送的邮件进入收件人垃圾箱

原因：新域名/邮箱信誉低；邮件内容缺乏个性化

解决：为 Agent 邮箱设置 SPF/DKIM/DMARC 记录；邮件内容保持自然语言风格；逐步增加发送量建立信誉

踩坑 2：邮箱 ID 泄露

现象：Sentio 账户出现异常消费

原因：API Key 或邮箱 ID 被泄露

解决：使用环境变量存储敏感信息；定期轮换 API Key；设置邮箱级权限隔离

踩坑 3：大量未读邮件积压

现象：Agent 处理速度跟不上邮件到达速度

原因：并发处理能力不足；邮件规则未过滤低优先级邮件

解决：增加 Agent 并发数；设置优先级规则，低优先级邮件延迟处理

踩坑 4：线程解析错误

现象：Agent 将不同对话的邮件混在一起

原因：邮件缺少 In-Reply-To 或 References 头

解决：发送邮件时正确设置 thread_id 字段；对于入站邮件，依赖 Sentio 的线程检测算法

踩坑 5：API 速率限制

现象：Agent 大量操作时收到 429 错误

原因：超出套餐的 API 调用限制

解决：实现指数退避重试；升级到更高套餐；批量操作合并为单次 API 调用

常见问题 FAQ

Q1: Sentio 和 SendGrid/Twilio SendGrid 有什么区别？

A: SendGrid 是面向开发者的邮件发送平台（事务邮件、营销邮件），Sentio 是为 AI Agent 设计的完整邮箱 API（收发 + 线程管理 + 规则引擎）。SendGrid 更适合批量发送；Sentio 更适合 Agent 需要「像人一样管理收件箱」的场景。

Q2: 一个 Agent 可以管理多个邮箱吗？

A: 可以。通过 API 创建多个邮箱，Agent 可以同时管理多个收件箱，适合多角色 Agent（如同时处理客服和销售邮件）。

Q3: 支持附件吗？

A: 支持。发送和接收邮件均可包含附件，上限 25MB/封。建议开启附件安全扫描。

Q4: 价格如何？

A: 免费套餐每天 50 封邮件；付费套餐从 $10/月起（1000 封/天）。具体以 truespar.com 定价页为准。

Q5: 数据存储在哪里？

A: Sentio 是云服务，数据存储在 truespar 管理的服务器上。如需自托管，请联系 Sentio 团队咨询企业版方案。

进阶学习建议

掌握 Sentio 基础后，建议深入：

1. Agent 数字身份全栈：结合 sv-number MCP（手机号）+ Sentio（邮箱）+ Halofy（身份治理），构建 Agent 的完整数字身份体系——从通信到权限到审计全覆盖。
2. 邮件自动化最佳实践：研究 Gmail API 和 Microsoft Graph API 的邮件处理模式，将 Sentio 与传统邮件系统打通，实现 Agent 与企业现有邮件基础设施的集成。
3. Agent 间通信协议：探索 Agent-to-Agent 邮件通信的标准格式（如结构化 JSON 邮件），为多 Agent 协作建立标准化通信协议。

参考链接

• 官方仓库
• Sentio 官网
• SPF/DKIM/DMARC 配置指南

最后更新：2026-08-26 · 作者：MagicNetWorld · 基于公开资料整理，AI 辅助生成