llm-to-agent/docs/agent/tools-workspace.md

Tools 与 Workspace

状态：todo
期望阶段：P2

目标

让单 Agent 在隔离工作区中使用文件与 Shell 完成真实任务。

已确定

• Tool 是 Agent 主动调用的外部能力。
• 第一批能力：读写文件、目录浏览、文本搜索和 Shell 执行。
• 每个 Task 有独立 Workspace；Shell 默认在该目录执行。
• Tool 调用参数、输出、错误和生成脚本文本写入 Run 日志。
• Agent 通过模型 Tool Calling 自主选择、调用并读取 Tool 结果。
• 初期不建设复杂审批或权限语言；真实破坏性操作出现后再增强。

待细化

• Shell 超时、取消、后台进程和大输出处理。
• 文件写入与补丁的交互方式。
• Tool 描述和参数 Schema 的具体格式。