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 主会话,这让它非常适合终端调试,但也意味着你需要把它和其它入口的上下文边界区分开。