更新时间：2026-11-06 GMT+08:00
内置工具
在配置智能体时，可为其选择内置工具，这些工具将在智能体会话中执行。
智能体在会话中调用工具时，平台会根据工具权限策略决定是否放行。工具在运行时沙箱内执行，结果回传给模型。
当智能体需要在会话中读写文件、执行脚本或检索目录时，通过启用内置工具即可获得这些能力。
可用工具
智能体内置工具集包含以下文件类工具。
| 工具名称 | 描述 |
|---|---|
| * | 通配符，等同于勾选全部内置工具（含bash命令与文件操作权限）。 |
| bash | 在会话中执行bash命令。 |
| read_file | 读取文本、图片、PDF、Jupyter Notebook、Office文档。 |
| write_file | 写入文件内容（覆盖已有内容）。 |
| edit_file | 通过精确字符串替换编辑已有文件。 |
| glob | 使用glob模式查找文件。 |
| list_files | 列出目录内容。 |
| grep | 在文件中搜索内容，支持正则表达式。 |
选型建议
| 业务场景 | 推荐工具 | 说明 |
|---|---|---|
| 仅需读取文档/图片做问答 | read_file、glob、grep | 不授予写权限，降低风险。 |
| 需生成/编辑文件 | write_file、edit_file | 受路径穿越约束。 |
| 需执行脚本/系统命令 | bash | 高危操作，建议限定沙箱。 |
| 全功能自动化 | * | 等同全部权限，仅在受控环境使用。 |
在智能体中使用工具
在自定义创建智能体时，在“内置工具（可选）”区域勾选所需工具。如果不选择，等同于选择*。
在智能体详情页“工具与Skill”区域确认对应工具已勾选；或通过会话测试调用该工具验证生效。
使用工具后显示效果示例
- 场景一：启用工具
前提条件：在“内置工具（可选）”中勾选“write_file”工具。
调试显示结果：
图1 启用工具显示结果
- 场景二：禁用工具
前提条件：在“内置工具（可选）”中勾选“list_files”、未勾选“write_file”工具。
调试显示结果：
图2 禁用工具显示结果
