【Agent进阶专题】接入 CLI 交互
本篇接入 CLI:从终端读取用户输入,流式显示 Agent 回答,并处理取消与退出。
能力介绍
Workspace、Agent 和模型已经组成完整的对话链路,但还缺少用户入口。CLI 把这套能力包装成一个简单的终端循环。
用户输入一行文本后,CLI 将它交给 Agent,并把返回片段直接写入标准输出。/exit 用于退出;生成过程中按下 Ctrl+C 只取消当前回复,再次输入仍可继续对话。
实现思路
终端交互基于 Node.js 的 readline/promises。CLI 自己不处理消息历史和模型请求,只维护三份运行状态:终端接口、交互循环 Promise,以及当前请求的 AbortController。
每轮输入先经过 trim()。空输入直接忽略,/exit 结束循环,其余内容创建独立的取消信号并调用 Agent。回答正常结束后重新显示提示符;请求失败时,取消操作写入标准输出,其他错误写入标准错误。
交互循环无论怎样结束,最终都会关闭终端并广播 runtime.stop.requested。主程序收到事件后停止 Kernel,CLI 不直接控制整个 Runtime。
start 行为
start 先取得 Agent 能力并创建终端接口:
1 | const agent = context.get<AgentService>(Hook.Agent); |
Ctrl+C 根据当前状态执行不同操作:
1 | terminal.on("SIGINT", () => { |
存在进行中的请求时,只触发它的 AbortSignal;空闲时则关闭终端,结束输入循环。
对话循环逐行读取输入,并将回答片段直接写入终端:
1 | for await (const line of terminal!) { |
这里不缓存回答片段,拿到一段就显示一段。完整内容的拼接与保存仍由 Agent 负责。
循环退出时统一请求 Runtime 停止:
1 | finally { |
stop 行为
Kernel 停止时,CLI 先取消当前请求,再关闭输入接口,最后等待交互循环结束:
1 | async stop() { |
等待 loop 可以避免终端尚未收尾,进程就直接退出。
到此,最初版本的基本功能已经凑齐,下一篇,我们将这个 Agent 实际串起来看看效果。