Skip to main content
当开发者需要快速验证或调试一个智能体时,可以使用 agentscope.console 模块直接在终端中与智能体对话、查看完整的事件流,无需启动 Web 服务,也无需手动分发 reply_stream 产出的数十种事件。 控制台(Console)模块提供两个接口,分别对应两类使用场景:

启动交互对话

launch_console 接收一个构造完成的智能体,接管终端交互的全部环节:
与智能体在终端中对话
运行后各交互环节的行为如下: launch_console 支持以下参数:
Agent
必填
要交互的智能体。
str
默认值:"user"
用户消息的发送者名称,同时用作输入提示符。
str
默认值:"default"
输出详细程度,取值为 "quiet""default""debug",详见控制输出详细程度
int | None
默认值:"20"
单条工具结果的最大打印行数,超出部分折叠为提示行,None 表示不截断。
launch_console 不包含会话管理与持久化:对话状态保存在 agent.state 中,随进程退出而结束。若需要多用户、多会话与持久化存储,请使用智能体服务

嵌入事件渲染器

当开发者自己掌控运行逻辑(例如多智能体流水线、测试脚本)时,可以只使用 ConsoleRenderer 完成打印。渲染器是被动的:事件如何产生、输入与确认如何处理,均由调用方决定。
在自己的代码中渲染事件流
渲染器按回复标识区分事件的归属,因此多个智能体顺序发言时可以复用同一个实例:
渲染多智能体流水线
渲染器对各类事件的处理规则如下:
工具确认、外部执行等需要人工介入的事件,渲染器只负责显示提醒;如何收集确认结果并继续回复由调用方实现,可参考人机协作

控制输出详细程度

launch_consoleConsoleRenderer 均通过 verbosity 参数控制输出的详细程度,三档依次递增:
渲染器会静默跳过未知的事件类型(debug 档打印一行类型名),因此事件协议新增类型不会影响既有的渲染逻辑。