docs/product/tools-and-integrations.md
Last updated: 2026-04
Chatbox Pro 通过工具系统扩展 AI 的能力，使 AI 不仅能生成文本，还能执行搜索、读取文件、查询知识库、调用第三方服务等操作。
启用网页浏览后，AI 可以在对话中调用两类工具：
不同搜索提供方支持的工具能力有差异：
| 提供方 | 网页搜索 | 读取网页 | 说明 |
|---|---|---|---|
| Chatbox AI | ✓ | ✓ | 内置搜索，开箱即用 |
| Bing | ✓ | ✗ | 免费使用，覆盖国际内容 |
| Tavily | ✓ | ✓ | 高质量 AI 搜索，需自备 API Key |
| BoCha | ✓ | ✗ | 国内搜索 API，需自备 API Key |
| Querit | ✓ | ✗ | 多源聚合搜索，需自备 API Key |
设置页（设置 → 网页搜索）会在所选提供方下方明确列出该提供方支持哪些工具，便于用户选择。
使用方式：在会话中开启"网页浏览"模式，AI 在需要搜索或读取网页时会自动调用对应工具。如果当前提供方不支持读取网页（例如 Bing），AI 不会被注入 parse_link 工具，避免出现"调用了但失败"的情况。
当工具因为缺少配置而失败（例如选择了 Tavily 但没有填写 API Key、或选择了 Chatbox AI 但没有 license），消息中的工具气泡会自动展开，显示本地化的错误说明，并提供一键跳转链接（前往设置页输入 API Key、打开 license 页面、升级账户等），不再只是"工具调用失败"的红色提示。
MCP（Model Context Protocol） 是一种开放协议，允许 AI 通过标准化接口调用外部工具。
Chatbox 预置了一组云端 MCP 服务（付费功能），无需配置即可使用：
| 服务 | 功能 |
|---|---|
| Fetch | 抓取网页内容 |
| Sequential Thinking | 结构化思维推理辅助 |
| EdgeOne Pages | 将 HTML 部署为公开网页 |
| arXiv | 学术论文检索 |
| Context7 | 编程库文档与代码示例检索 |
用户可以添加自己的 MCP 服务器，扩展 AI 的能力边界。支持两种连接方式：
| 方式 | 说明 | 适用平台 |
|---|---|---|
| 本地进程 (Stdio) | 在电脑上运行 MCP 服务器程序 | 仅桌面端 |
| HTTP | 通过网络连接远程 MCP 服务器 | 所有平台 |
Agent Skills 是基于 agentskills.io 规范的指令技能系统，适合把高频任务沉淀成可复用能力包（例如翻译、代码审查、写作、数据分析）。
产品侧提供两级控制：
对话时，模型先获得技能目录元数据，再按需调用 load_skill 加载完整技能指令，避免把所有技能全文一次性注入上下文。
Chatbox 支持多种技能来源：
| 来源 | 说明 |
|---|---|
| Chatbox Skills | 通过设置页 Spotlight 搜索安装，或在对话中让 AI 安装 |
| Claude Code Skills | 自动发现 ~/.claude/skills/ 目录中的技能 |
当两个来源的技能同名时，Chatbox Skills 优先。
在 Agent Mode 开启时，AI 可以通过 install_skill 工具安装新技能：在沙箱中下载准备技能文件，然后安装到本地。安装后自动启用。
On 模式下，AI 可在任务需要用户真实环境时通过 user_exec 执行命令，不要求先加载 Skill。该工具受分层审批机制保护：安全只读命令可通过本地白名单，符合条件的低风险命令可由 AI 安全评估自动通过，其余命令暂停等待用户确认；Full Access 会跳过逐次审批。
Skills 当前为桌面端能力，Web/移动端不显示相关入口。
详见 Agent Skills。
在 Chat 模式下，通过 Agent Mode 启用代码执行后，AI 可以在桌面端运行 Node.js 或平台可用的 Shell（Windows 优先 PowerShell，Bash 可选）、处理上传文件、生成可下载文件和 HTML 预览。核心文件工具不依赖 Bash 或 WSL。该能力聚焦简单文件处理和数据计算，不预装 Python 科学计算栈，也不鼓励安装大型依赖包。详见 Chat 代码执行。
用户在对话中上传的文件，AI 可以直接读取和分析：
支持上传代码、文档、数据文件等多种格式。
当会话关联了知识库时，AI 会自动获得知识库查询工具，可以：
详见 知识库。