# base_toolset

KiloStar 内置基础工具集。提供文件操作、命令执行、搜索等通用能力，所有 Agent 默认可用。

## 工具列表

| 工具 | 说明 |
|------|------|
| `shell_executor` | 执行 shell 命令，返回 stdout/stderr |
| `file_reader` | 读取文件内容（支持按行偏移和行数限制） |
| `edit_file` | 按 old_string → new_string 的方式精确替换文件内容 |
| `write_file` | 整体写入或覆盖文件 |
| `search_file` | 在目录树内按 glob/正则搜索文件名或内容 |
| `python_executor` | 在沙箱中运行 Python 代码片段 |
| `tavily_search` | 调用 Tavily API 进行联网搜索（需配置 `api_key`） |

## 配置说明

`tavily_search` 需要在工具配置中填入 `api_key`，可选参数：

- `max_results`：返回结果条数，默认 `5`
- `search_depth`：`basic` 或 `advanced`
- `include_answer`：是否带 LLM 摘要，默认 `true`

其他工具开箱即用，无需配置。

## 安全提示

- `shell_executor` / `python_executor` 会在受限沙箱内执行，但仍建议在受信环境下使用
- `edit_file` / `write_file` 会修改本地文件系统，注意权限范围