内置工具

内置工具是平台自带的能力，不需要额外接入。Agent 只能调用被勾选的工具。

工具分类

类别	工具	用途
交互	ask_user	向用户提问、确认选项
交互	show	展示文件、网页预览等结果
执行	bash	在沙盒里执行命令
执行	bash_async	后台运行长命令，不阻塞对话
执行	background_task	启动/查询/取消后台任务
执行	monitor	持续观察日志或输出
执行	reset_environment	重置执行环境
文件	read_media	读取图片等媒体文件
上下文	compact_context	压缩过长的上下文
协作	run_agents	派生多个子 Agent 并行处理
协作	get_agents	查询子 Agent 状态
协作	talk_to_agent	与指定 Agent 对话
协作	get_team_members	查询团队成员
协作	delete_agents	清理子 Agent
代码	code_map_init	为仓库建立代码地图索引
技能	find-skills	搜索可用技能

配置超时与输出截断

左侧菜单 Tools：

• 超时：留空表示跟随默认值；自定义后按你的值执行。
• 输出截断：超过行数或字节上限时截断，并把完整输出落盘，避免一次塞满上下文。
• 清空或恢复默认，会回到代码内置值；保存后立即生效。

在 Agent 中使用

打开 Agents 编辑页，在内置工具区域勾选。按最小权限原则，只给需要的工具。

建议

• 只读任务不要给写文件/执行命令的工具。
• 长任务优先用后台执行，避免占用一个回合。
• 输出很大的命令（日志、构建）配合截断使用，完整内容从落盘文件读取。

常见问题

工具不可用：确认已勾选，并且会话已启用沙盒（执行类工具依赖沙盒）。

命令超时：改用后台执行，或调大该工具的超时。

输出被截断：这是预期行为；完整输出会落盘，让 Agent 读取文件即可。