工具与后台终端
阅读工具调用、检查输出,并管理 Agent 启动的后台命令。
Agent 通过工具读取文件、修改代码、运行命令或调用应用功能。每次调用都会在消息记录中形成工具卡片,工具状态和最终回答共同构成任务结果。
阅读工具卡片
工具运行时会显示当前状态和实时输出;完成后卡片通常折叠,以保持会话可读。展开后可以查看:
- 工具名称和模型提交的参数。
- 命令、工作目录和退出状态。
- 文件补丁及新增、修改、删除摘要。
- 自动权限审查的结论和理由。
- 标准输出、错误输出,以及被截断或省略的提示。
工具可能处于运行、等待审批、等待用户、等待清理、成功、失败、取消或中断等状态。只有进入明确终态后,才能判断该次调用是否结束。
输出可能有保留上限
实时输出和持久化历史都会控制体积。看到截断标记时,应让 Agent 使用更精确的过滤命令或读取指定区段,而不是假设未显示的内容不存在。
停止当前回答
输入框为空且当前回答可取消时,主按钮会变为停止按钮。它用于取消正在进行的 Agent 回答或独立压缩。
停止请求发出后,应用仍需要确认工具和进程已经进入终态。界面显示等待清理时,不要立即创建替代任务;先等待或按错误提示重试清理。
后台终端
长时间运行的命令可以进入后台,并获得一个终端会话标识。它们属于创建它们的 Agent 会话,不会因为折叠工具卡片、切换会话或关闭 Agent 窗口而自动结束。
| 命令 | 作用 |
|---|---|
/ps | 列出当前 Agent 会话保留的后台终端及状态 |
/stop | 请求停止并清理当前会话的全部后台终端 |
/stop 与停止当前回答不是同一个操作。前者处理后台终端,后者取消当前模型轮次或压缩。
安全清理后台命令
执行
/ps,确认终端属于哪个命令并检查当前状态。仍需保留服务时,先让 Agent读取增量输出确认它是否正常。
不再需要时执行
/stop。再次执行
/ps,确认没有保留的后台终端。如果提示清理失败,按照卡片提示再次执行
/stop,不要仅删除会话。后台开发服务器、文件监听器和交互式命令可能持续占用端口或文件。任务完成前应明确说明哪些进程被保留、哪些已经停止。
判断任务是否完成
- 工具调用显示成功,只证明该操作成功,不等于整个目标已经实现。
- 测试命令需要检查退出状态和失败用例,而不只是看到部分输出。
- Agent 最终回答应说明修改内容、验证结果和仍未完成的事项。
- 如果最终回答声称完成,但工具仍在运行或等待清理,应以后端状态为准。