让 Agent 能接入不同宿主的控制接口

Agent 不应只绑定在一个聊天页面里。它需要被外部宿主启动、暂停、查询、推送事件和接收人工输入，这要求控制接口明确任务、会话、事件和错误模型。

接口要素

启动接口返回 runId，状态接口提供运行阶段和最后事件，取消接口保证任务能停止，恢复接口让人工补充信息后继续执行。事件协议要允许文本、工具调用、审批和错误等不同类型。

项目落点

共享集群可以被多个业务 Agent 调用，AI 陪伴 IoT 则需要把设备事件和云端 Agent 运行状态分开。设备在线不等于对话任务成功，两个状态都要有独立的控制接口。

结论

控制接口的价值，是让 Agent 成为可被编排的运行单元，而不是某个页面里的黑盒请求。