【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
2
3
4
5
const agent = context.get<AgentService>(Hook.Agent);
terminal = createInterface({
input: process.stdin,
output: process.stdout,
});

Ctrl+C 根据当前状态执行不同操作:

1
2
3
4
5
6
7
terminal.on("SIGINT", () => {
if (currentRequest) {
currentRequest.abort();
} else {
terminal?.close();
}
});

存在进行中的请求时,只触发它的 AbortSignal;空闲时则关闭终端,结束输入循环。

对话循环逐行读取输入,并将回答片段直接写入终端:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
for await (const line of terminal!) {
const input = line.trim();

if (input === "/exit") break;
if (!input) {
terminal?.prompt();
continue;
}

currentRequest = new AbortController();

try {
for await (const chunk of agent.chat(input, currentRequest.signal)) {
process.stdout.write(chunk);
}
process.stdout.write("\n\n");
} catch (error) {
if (currentRequest.signal.aborted) {
process.stdout.write("\n[已取消]\n\n");
} else {
process.stderr.write(`\n${String(error)}\n\n`);
}
} finally {
currentRequest = undefined;
}

terminal?.prompt();
}

这里不缓存回答片段,拿到一段就显示一段。完整内容的拼接与保存仍由 Agent 负责。

循环退出时统一请求 Runtime 停止:

1
2
3
4
finally {
terminal?.close();
await context.emit(Event.RuntimeStopRequested, { source: "cli" });
}

stop 行为

Kernel 停止时,CLI 先取消当前请求,再关闭输入接口,最后等待交互循环结束:

1
2
3
4
5
async stop() {
currentRequest?.abort();
terminal?.close();
await loop;
}

等待 loop 可以避免终端尚未收尾,进程就直接退出。

到此,最初版本的基本功能已经凑齐,下一篇,我们将这个 Agent 实际串起来看看效果。