agentscope.console 模块直接在终端中与智能体对话、查看完整的事件流,无需启动 Web 服务,也无需手动分发 reply_stream 产出的数十种事件。
控制台(Console)模块提供两个接口,分别对应两类使用场景:
启动交互对话
launch_console 接收一个构造完成的智能体,接管终端交互的全部环节:
与智能体在终端中对话
launch_console 支持以下参数:
Agent
必填
要交互的智能体。
str
默认值:"user"
用户消息的发送者名称,同时用作输入提示符。
int | None
默认值:"20"
单条工具结果的最大打印行数,超出部分折叠为提示行,
None 表示不截断。launch_console 不包含会话管理与持久化:对话状态保存在 agent.state 中,随进程退出而结束。若需要多用户、多会话与持久化存储,请使用智能体服务。嵌入事件渲染器
当开发者自己掌控运行逻辑(例如多智能体流水线、测试脚本)时,可以只使用ConsoleRenderer 完成打印。渲染器是被动的:事件如何产生、输入与确认如何处理,均由调用方决定。
在自己的代码中渲染事件流
渲染多智能体流水线
控制输出详细程度
launch_console 与 ConsoleRenderer 均通过 verbosity 参数控制输出的详细程度,三档依次递增:
渲染器会静默跳过未知的事件类型(
debug 档打印一行类型名),因此事件协议新增类型不会影响既有的渲染逻辑。