AgentCLIInteraction
town agent chat
在终端里与运行中的 Agent 对话,支持交互式和一次性模式
town agent chat
用法
town agent chat
town agent chat --to my-agent
town agent chat --to my-agent --message "总结一下今天做了什么"
town agent chat --to my-agent --message "输出 JSON" --json两种模式
交互式模式
不带 --message 时进入持续对话:
town agent chat --to my-agent适合:
- 你要持续多轮对话
- 你在逐步调试项目行为
- 你在人工探索某个问题
一次性模式
带 --message 时只发一轮:
town agent chat --to my-agent --message "总结一下当前仓库结构"适合:
- 脚本调用
- 快速单轮问答
- 作为终端工具链的一环
目标 Agent 如何选择
- 如果传了
--to,直接使用该 agent id - 如果没传且终端是交互式环境,会从当前运行中的 agent 里让你选择
如果终端不是交互式环境,又没有显式给出 --to,命令就不会有足够信息帮你自动选择目标。
重要限制
目标 agent 必须已经运行。
chat 本身不会替你自动完成启动。
如果没有运行中的 agent,命令不会自动帮你启动。
常用参数
--to <name>--message <text>--json--host--port--token
交互式模式下的常用命令
/exit/quit/clear/help
如果你在 REPL 里调试项目行为,这几个命令能显著提升效率,尤其是 /clear 和 /help。
相关文档
一个常见误区
不要把 CLI chat 当成“和所有入口共享一条全局上下文”的聊天窗口。
它默认使用的是独立的本地 CLI 主会话,这让它非常适合终端调试,但也意味着你需要把它和其它入口的上下文边界区分开。