Hanafubuki

工具与后台终端

阅读工具调用、检查输出,并管理 Agent 启动的后台命令。

Agent 通过工具读取文件、修改代码、运行命令或调用应用功能。每次调用都会在消息记录中形成工具卡片,工具状态和最终回答共同构成任务结果。

阅读工具卡片

工具运行时会显示当前状态和实时输出;完成后卡片通常折叠,以保持会话可读。展开后可以查看:

  • 工具名称和模型提交的参数。
  • 命令、工作目录和退出状态。
  • 文件补丁及新增、修改、删除摘要。
  • 自动权限审查的结论和理由。
  • 标准输出、错误输出,以及被截断或省略的提示。

工具可能处于运行、等待审批、等待用户、等待清理、成功、失败、取消或中断等状态。只有进入明确终态后,才能判断该次调用是否结束。

输出可能有保留上限

实时输出和持久化历史都会控制体积。看到截断标记时,应让 Agent 使用更精确的过滤命令或读取指定区段,而不是假设未显示的内容不存在。

停止当前回答

输入框为空且当前回答可取消时,主按钮会变为停止按钮。它用于取消正在进行的 Agent 回答或独立压缩。

停止请求发出后,应用仍需要确认工具和进程已经进入终态。界面显示等待清理时,不要立即创建替代任务;先等待或按错误提示重试清理。

后台终端

长时间运行的命令可以进入后台,并获得一个终端会话标识。它们属于创建它们的 Agent 会话,不会因为折叠工具卡片、切换会话或关闭 Agent 窗口而自动结束。

命令作用
/ps列出当前 Agent 会话保留的后台终端及状态
/stop请求停止并清理当前会话的全部后台终端

/stop 与停止当前回答不是同一个操作。前者处理后台终端,后者取消当前模型轮次或压缩。

安全清理后台命令

执行 /ps,确认终端属于哪个命令并检查当前状态。
仍需保留服务时,先让 Agent读取增量输出确认它是否正常。
不再需要时执行 /stop
再次执行 /ps,确认没有保留的后台终端。
如果提示清理失败,按照卡片提示再次执行 /stop,不要仅删除会话。

后台开发服务器、文件监听器和交互式命令可能持续占用端口或文件。任务完成前应明确说明哪些进程被保留、哪些已经停止。

判断任务是否完成

  • 工具调用显示成功,只证明该操作成功,不等于整个目标已经实现。
  • 测试命令需要检查退出状态和失败用例,而不只是看到部分输出。
  • Agent 最终回答应说明修改内容、验证结果和仍未完成的事项。
  • 如果最终回答声称完成,但工具仍在运行或等待清理,应以后端状态为准。

本页目录