指南

人工接管

锁住一个线程，让人接管对话；线程被锁时 agent 看到什么、该做什么。

docs.simail.ai/zh/takeover

任何能打开某个邮箱的人，都可以在控制台里接管一个线程。线程对 agent 保持锁定，直到人交还。对话需要判断、客户要求找人、或 agent 跑偏时用它。

线程被锁时

任何 key 或 MCP 客户端在该线程里发信都返回 423 thread_locked（回复、回复全部、转发，以及发送一条在该线程里回复的草稿）。
线程里已经定时或已批准的信不会发出。它们停在放行服务的最后一道检查，解锁后继续。如果锁定超过批准的寿命，它们改为过期。
读取仍然可用：agent 能看到新信，除非那些信被扣留。
锁定开始时发布 thread.locked，结束时发布 thread.unlocked。

{
  "type": "https://docs.simail.ai/errors#thread_locked",
  "title": "ThreadLockedError",
  "status": 423,
  "detail": "A human has taken over this thread.",
  "instance": "/v0/inboxes/shop-helper@simail.email/messages/msg_…/reply",
  "code": "thread_locked",
  "retryable": false,
  "fix": "A human has taken over this thread; wait until it is unlocked.",
  "request_id": "req_…"
}

agent 该做什么

停下。 不要重试发送，不要改从另一个邮箱发，也不要和同一个人另开线程。
如果你正在做一件事，告诉你的主人这个线程被锁了。
等到 thread.unlocked（或再查一次锁）之后，才在这个线程里写。先读人写了什么；他们可能已经处理完请求。

查看锁

GET/v0/inboxes/{inbox_id}/threads/{thread_id}/lock

需要 message_read。见锁。

只有人能在控制台里上锁和解锁。key 没有上锁或解锁端点，MCP 也没有这个工具。

控制	范围	效果
线程锁	一个线程	该线程的发送返回 `423`；读取继续
暂停邮箱	一个邮箱	邮箱拒收新信，恢复前也不能发
组织暂停	组织	发送返回 `403 account_suspended`；收信继续
平台暂停	所有人	发送返回 `503 sending_paused`；已接受的信等待

人工接管

线程被锁时

agent 该做什么

查看锁

相关控制