工具使用
Alma 包含 20+ 内置工具，让 AI 能够执行超越文本生成的操作。
工具分类
文件操作
| 工具 | 描述 |
|---|---|
| Read | 读取文件内容 |
| Write | 创建或覆盖文件 |
| Edit | 精确编辑现有文件 |
| Glob | 按模式查找文件 |
| Grep | 用正则搜索文件内容 |
| NotebookEdit | 编辑 Jupyter 笔记本 |
Shell 和系统
| 工具 | 描述 |
|---|---|
| Bash | 执行 Shell 命令 |
| BashOutput | 获取运行中命令的输出 |
| KillShell | 终止运行中的进程 |
网络
| 工具 | 描述 |
|---|---|
| WebFetch | 从 URL 获取内容 |
| WebSearch | 搜索网页 |
规划和任务
| 工具 | 描述 |
|---|---|
| Task | 创建和管理代理任务 |
| TaskOutput | 获取任务结果 |
| TodoWrite | 结构化任务列表管理 |
知识
| 工具 | 描述 |
|---|---|
| Recall | 从记忆系统检索 |
| ToolSearch | 发现可用工具 |
浏览器
| 工具 | 描述 |
|---|---|
| BrowserOpen | 打开浏览器窗口并导航 |
| BrowserClick | 通过 CSS 选择器点击元素 |
| BrowserType | 在输入框中输入文字 |
| BrowserScreenshot | 截取浏览器截图 |
| BrowserRead | 将页面内容读取为 Markdown |
| BrowserReadDom | 列出可交互的 DOM 元素 |
| BrowserEval | 在页面中执行 JavaScript |
Chrome 浏览器中继
控制你真实的 Chrome 浏览器，保留已有的登录状态。需要安装 Chrome Relay 扩展。
| 工具 | 描述 |
|---|---|
| ChromeRelayListTabs | 列出所有打开的 Chrome 标签页 |
| ChromeRelayNavigate | 导航 Chrome 标签页到指定 URL |
| ChromeRelayClick | 在 Chrome 标签页中点击元素 |
| ChromeRelayType | 在 Chrome 标签页中输入文字 |
| ChromeRelayScreenshot | 截取 Chrome 标签页截图 |
| ChromeRelayRead | 将 Chrome 标签页内容读取为 Markdown |
| ChromeRelayReadDom | 列出 Chrome 标签页中的可交互元素 |
| ChromeRelayEval | 在 Chrome 标签页中执行 JavaScript |
| ChromeRelayScroll | 滚动 Chrome 标签页 |
| ChromeRelayBack / Forward | 浏览器前进/后退 |
扩展
| 工具 | 描述 |
|---|---|
| Skill | 执行自定义 Skills |
| SlashCommand | 运行斜杠命令 |
启用工具
自动模式
AI 根据你的请求自动选择合适的工具。推荐大多数用户使用。
- 点击消息输入框中的 工具 图标
- 选择 自动
手动选择
选择要启用的特定工具：
- 点击 工具 图标
- 选择 手动
- 勾选你想启用的工具
全部工具
启用所有可用工具（包括 MCP 工具）。
无工具
禁用所有工具，仅使用文本回复。
工具权限
某些工具在执行前需要你的批准：
自动批准
安全的只读操作自动运行：
- 读取文件
- 搜索内容
- 网页获取
需要权限
可能有影响的操作会请求批准：
- 写入文件
- 运行 Shell 命令
- 删除内容
权限选项
收到提示时，你可以：
- 批准：允许此特定操作
- 全部批准：批准所有待处理操作
- 拒绝：阻止该操作
Tool Model 配置
Alma 使用专门的 Tool Model 处理工具相关操作，与你的主聊天模型分开。这样可以：
- 更快响应：工具分析使用轻量级模型
- 节省成本：频繁的工具操作不消耗昂贵模型的 tokens
- 更高效率：主模型专注于对话质量
Tool Model 处理的内容：
- 分析你的请求需要使用哪些工具
- 提取工具调用的参数
- 记忆操作（存储、检索、相关性判断）
- 自动生成对话标题
- 后台处理任务
推荐模型（快速 + 高质量）：
| 服务商 | 模型 |
|---|---|
| OpenAI | gpt-4o-mini |
| Anthropic | claude-haiku-4-5 |
gemini-2.0-flash, gemini-1.5-flash |
DANGER
永远不要使用推理模型（o1、o3、extended thinking）作为 Tool Model - 它们对于工具操作来说太慢了。
Alma 会根据你的服务商自动检测最佳 tool model。你也可以在 设置 → 通用 → Tool Model 中手动配置。
TIP
如果工具感觉很慢，检查你的 Tool Model 配置。响应时间应该在 2.5 秒以内以获得最佳体验。
详见 Tool Model 设置。
MCP 工具
来自 MCP 服务器的附加工具以 serverName__toolName 格式显示。详见 MCP 集成。
故障排除
"工具不可用"
- 检查工具是否已启用
- 验证工作区是否已设置（用于文件工具）
- 确保 MCP 服务器已连接（用于 MCP 工具）
"权限被拒绝"
- 你拒绝了工具的操作
- 尝试批准权限
"命令失败"
- 检查命令语法
- 验证你是否有必要的权限
- 查看错误消息获取详情