AgentGetting Started

和 Agent 对话

使用终端聊天命令与运行中的 Agent 进行交互

和 Agent 对话

最简单的方式

确保 agent 已经运行,然后执行:

town agent chat

如果你没有显式指定目标 agent,并且当前终端是交互式环境,CLI 会让你从运行中的 agent 里选择一个。

这意味着 town agent chat 的默认交互体验更偏向人工使用,而不是脚本化调用。

指定目标 Agent

town agent chat --to my-agent

如果你同时维护多个 agent,建议在文档、脚本和日常命令里都尽量显式写出 --to,这样行为更稳定、可复现。

一次性发送消息

town agent chat --to my-agent --message "总结一下这个仓库的结构"

这适合脚本化调用,发送一轮消息后就退出。

如果你只是想临时让 agent 做一次总结、列清单、做分析,一次性模式通常比进入持续 REPL 更高效。

JSON 输出

town agent chat --to my-agent --message "列出今天的变更" --json

适合把结果接到别的脚本或工具链里。

如果你后面还要做二次解析、自动存档或流水线处理,优先考虑 --json

交互式会话特点

  • 默认使用独立的本地 CLI 主会话
  • 终端里每一轮消息都会进入同一个会话
  • 不和 Console UI 的其它上下文自动共享

这一点很重要,因为它意味着“终端聊天上下文”并不自动等于“所有其它入口的上下文”。

常用退出命令

  • /exit
  • /quit

如果没有回复

优先检查:

  1. town agent status
  2. 模型绑定是否正确
  3. agent 是否真的处于 running

如果你遇到的是 daemon unreachable 或类似错误,通常先排运行状态,不要一上来就怀疑提示词或会话逻辑。

下一步