生产 Agent 架构：API、队列、状态机与事务

Client → API/Auth → Task Store/Queue → Agent Worker → Model Gateway
                                  ↘ Tool Gateway → External Systems
                  Event Stream ← Trace/Metric/Log

• 长任务创建后返回 task_id，客户端查询或订阅状态；
• 状态机至少有 queued、running、waiting、succeeded、failed、cancelled；
• Worker 用租约防止永久占用，Checkpoint 支持接管；
• Tool Gateway 集中做身份、授权、超时、幂等和审计；
• 跨系统写操作用 Saga 与补偿，不假设全局事务。

模型层、编排层、工具层和业务规则层分离。模型提出动作，业务服务决定是否允许并执行。

外部动作执行前记录意图，执行后记录确认；超时标记 unknown 并对账。恢复时按幂等键查询原结果，避免重复付款、发信或建单。

关联面试题： E17 Agent API · S06 长任务 · S19 跨系统事务