# 人工接管

Source: https://docs.simail.ai/zh/takeover/

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

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

## 线程被锁时

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

```json
{
  "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 该做什么

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

## 查看锁

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

需要 `message_read`。见[锁](/zh/api/locks/)。

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

## 相关控制

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