# 工具中心与联网搜索

> Cube Agent 2.2.0 正式版（构建 2002007）使用说明。
> 分类：模型与 AI 能力。内容基准：2026-11-07。
> 网页：https://cubeagent.app/docs/tools/

## 工具中心是什么

工具中心列出了可供模型调用的内置工具。启用后,模型可以在需要时调用工具补充信息或完成操作。

## 联网搜索

联网搜索分为两种:

- **外部搜索服务**:需要先在工具中心选择并配置搜索服务,填入对应密钥或参数。配置完成后,支持工具调用的模型可以在需要时调用搜索工具获取资料再作答。
- **内置搜索**:由模型服务商直接提供,不使用工具中心里配置的 Exa、Tavily 等搜索服务。只有当前服务商接口和当前模型都支持“内置联网”时,聊天输入框的联网菜单里才会显示“内置搜索”。你也可以在模型编辑页调整“内置联网”能力开关。

## 可选择的外部搜索服务

- **Exa**:偏 AI 搜索 API,适合给模型补充网页结果与摘要。官网:[https://exa.ai](https://exa.ai)
- **Tavily**:面向 AI Agent 的搜索 API,配置简单,适合通用联网检索。官网:[https://www.tavily.com](https://www.tavily.com)
- **DeepSeek**:使用 DeepSeek API Key 提供网页搜索与 Markdown 正文抓取，可单独配置搜索密钥和 Base URL。文档:[https://api-docs.deepseek.com/zh-cn/guides/search/](https://api-docs.deepseek.com/zh-cn/guides/search/)
- **Firecrawl**:偏网页抓取、解析和内容提取,适合需要读取网页正文的场景。官网:[https://www.firecrawl.dev](https://www.firecrawl.dev)
- **秘塔搜索 / Metaso**:适合中文搜索场景,可在搜索 API 控制台申请和查看用量。入口:[https://metaso.cn/search-api/playground](https://metaso.cn/search-api/playground)

这些服务通常都会提供一定免费额度,轻量个人使用一般足够。具体额度、重置周期和计费方式会调整,以服务商控制台和最新价格页为准。

## MCP 工具

服务地址末尾的斜杠会保留，部分服务的 /mcp/ 与 /mcp 不是同一个端点。若旧版保存时已裁剪地址，请按服务商提供的完整地址补回并刷新工具。零工具、鉴权失败和无效响应会分别提示；HTTP 成功不等于已发现可用工具。

MCP Server 可以把外部系统能力接入为工具。打开 **设置 → 助手与能力 → 工具服务**,切到 **MCP 服务** Tab,点 **新增** 进入 MCP 服务编辑页,填写服务地址、认证方式和请求头;也可在编辑页使用 **JSON 快速导入**,直接粘贴标准 MCP JSON,应用会自动识别可导入的服务并填入连接配置。

JSON 导入兼容根级 `mcpServers`(Claude 等)与 `servers`(Cursor / VS Code Copilot 等);`type=http` / `sse` / `streamable-http` 等常见别名也可识别;也可省略 type,按 url 或 command 自动推断传输方式。华为等标准远程 MCP 配置一般可直接粘贴导入。

支持三种连接方式：
- **流式 HTTP**：大多数远程服务，地址一般以 `/mcp` 结尾。
- **旧式 SSE**：地址以 `/sse` 结尾时自动按 SSE 连接，魔搭、百炼等 MCP 广场的 SSE 地址可以直接用。
- **本机运行（stdio）**：地址栏直接填启动命令，例如 `uvx mcp-server-time`，或粘贴带 `command` / `args` / `env` 的 JSON。服务会在应用内置的 Python 环境里运行，首次保存时自动安装，需要的 API Key 填在「环境变量」里。只支持 Python 写的服务（`uvx`、`pipx run`、`python -m`）；需要 Node.js（`npx`）、Docker 的服务无法在手机上运行，可改用它的远程地址。依赖需要编译的原生库时也可能装不上，编辑页会显示具体原因。

进入某个 MCP Server 详情后,顶部更多菜单提供刷新、编辑和删除。工具列表支持按名称或描述搜索。每个工具右侧的 **询问 | 允许** 决定调用前是否先问你,开关只控制工具是否启用。聊天中对某个工具点 **始终允许** 后会立刻生效,无需退出重进页面。所有 MCP 服务和工具的授权也可在 **工具服务 → 授权** 统一查看和修改。

在聊天里按对话开启 MCP：打开输入框工具栏的 **工具 → 选择工具**，在 **MCP 服务 · 仅当前对话** 中打开某个服务的开关，应用会立即连接它并获取工具列表，卡片上显示 **已连接 · N 个工具**；连接失败时卡片会给出原因，并提供 **重试连接** 等按钮。只有为本对话开启的服务才会连接。当前对话已开启的服务排在前面。

为避免工具过多导致渲染、持久化或请求体过大,单个 MCP Server 最多保留 256 个工具;新发现的工具默认只启用前 64 个,其余可在详情页手动启用。

## OAuth 授权与连接恢复

服务要求网页登录授权时，在认证方式中选择 OAuth，按服务方要求填写 Client ID、权限范围等信息，再从应用进入授权流程。预注册 Client ID 与客户端元数据地址是不同配置：同时填写时优先使用预注册 ID；两者均留空时是否可用取决于服务是否支持动态注册。不要自行猜测这些值。

授权完成后应用复用有效令牌；权限不足或授权失效时，按提示重新授权。连接失败会保留服务配置，可修正地址、认证或网络后重试。授权成功不代表所有工具自动获准执行，仍需设置工具开关和「询问／允许」。当前不承诺支持 MCP 的任务、采样或交互式表单等可选扩展。

## 常用内置工具，各做什么

- **文件操作**：直接创建、读取、精确编辑、追加、合并、复制、移动和删除工作区文件。TXT/Markdown 可按指定顺序在本地合并，不需要模型重新输出全文。只改一段文字时用编辑，复制文件不需要先读出全文再写回。模型调用名是 `file_operations`。
- **Office 文档**：读取、生成、修改 Word / Excel / PPT，生成离线预览并交付文件。只开启这一个工具即可使用，操作说明由工具按需提供，无需另外开启技能或代码工作台。
- **代码工作台**：默认用 Python 运行代码，适合表格筛选统计、数据分析、画图和批量处理文件；技能里写的命令行（如 `python scripts/x.py`、`pip install`）用 bash 执行。JavaScript 只在需要代管服务商密钥或无痕会话时使用。模型调用名是 `run_code`，旧版 `eval_javascript` 配置仍兼容。
- **网络请求**：访问网络服务、上传或下载文件，调用名是 `http_request`。单次联网优先用它；需要多步计算时才由 JavaScript 编排。外部目标、局域网或凭据使用按本次操作确认。
- **生成图片**：用你选择的生图模型生成或修改图片，图片直接显示在对话里并保存到本对话的 `outputs/`，网页、文档等后续任务可以直接引用。生图模型在本行的 **换模型** 中切换，与图像生成工作台共用同一个设置。
- **向用户提问**：需要你做决定或补充信息时，提问卡会直接占据输入区，一次最多 3 题、左右切换作答，离开对话后已填的回答会保留，支持单选、多选、下拉选择（选项较多时）、滑块取值（如时长、数量、比例）和文字回答，可以只答一部分或整轮跳过。滑块回答会告诉 AI 你是否调整过默认值。模型调用名是 `ask_user`。

## 工作区与文件交付

当前会话通过 `/workspace` 虚拟工作区访问文件，写入 `outputs/` 的产物会显示为可打开、保存的附件。输入附件和已启用的 Skill 资源只读；其他会话、应用数据库和内部配置不属于脚本的访问范围。共享资料可按需读取；AI 删除共享文件免费，复用文件操作的本次允许或始终允许，授权后无需额外确认。存入、新建目录和移动共享文件需要 Pro 与用户授权；共享根目录、输入附件和 Skill 资源仍受保护。

创建文件只需提供正文与目标路径，不必先在回复里重复粘贴正文。写入成功后，通常无需再读一遍或再次列目录来确认；用户要求内容校验、结果不明确或确有结构验证需要时才检查。成功写入不等于已经验证内容质量。

## 结果与详情为什么不同

文件写入等操作默认展示简洁回执，例如成功状态、相对路径、实际新建或修改以及字节数；后续请求也使用这份回执，减少重复附件信息和设备内部路径进入上下文。展开后的 **详情** 保留本地执行记录，附件仍可打开、保存；查看详情和复制不会重新执行操作，也不额外调用模型。

正在读取的正文、计算结果、非空日志、HTTP 响应和关键错误会保留。结果较大时按工具已有范围读取或落盘规则处理，截断会明确标识，不能把一段预览当成完整内容。MCP 与不认识的历史结果不按内置工具规则删字段。文件已部分修改后发生失败或取消，不代表先前操作自动回滚。

这不是新的付费或配置选项，也不会再用模型总结工具结果。节省的是部分工具回执进入请求的开销，文件正文参数仍需传给模型服务；实际费用以服务商返回的用量为准，不保证固定节省比例。

## 代码工作台支持范围

Python 是完整的 Python 3.12，自带 pandas、numpy、openpyxl、matplotlib（已配中文字体）、Pillow 等常用库；python-docx、python-pptx、pypdf、pdfplumber 等常见库在首次用到时自动安装（需要联网），装好后长期保留。在「设置 → Python 运行环境」可以查看已安装的包或一键清理。不能运行系统程序（如 LibreOffice、Node.js），需要编译的 Python 包也装不上，AI 会改用纯 Python 的办法。

bash 不是系统 Shell，而是在应用内模拟常用命令：python、pip、git、ls、cat、grep、find、cp、mv、zip、curl 等。不支持 `$(...)`、heredoc 和后台任务，遇到不支持的程序会提示改用 Python。

git 可以克隆、提交、切换分支、合并和推送，只支持 HTTPS 地址，不支持 SSH。私有仓库或推送需要在地址里带上访问令牌（如 `https://令牌@github.com/用户/仓库.git`），令牌会保存在这个仓库的配置里。仓库里的符号链接会变成内容为链接目标的普通文件。

JavaScript 使用 QuickJS，没有网页 DOM 或 Node.js 运行时，主要用于代管服务商密钥的接口调用和无痕会话里的计算。

**Word / Excel / PPT 生成**无需 Pro。在当前聊天的工具选择中勾选 **Office 文档**，即可用自然语言要求生成文件。无需另开技能或代码工作台。完整步骤、示例和限制见帮助篇目「如何生成 Word、Excel 和 PPT 文件？」。

## 联网、下载与取消

如脚本返回 **E_JS_TIMEOUT**，先检查循环是否正常推进，不要原样重试或只增加超时时间。生成 Office 文件失败后先检查工作目录中是否已有完整产物，再修改脚本重试，避免重复生成；诊断信息可帮助模型定位耗时步骤。

JavaScript 的联网目标需要明确授权；网络请求与代码工作台共用文件和网络检查。保持 TLS 校验，不自动跟随重定向；返回跳转地址后，新的目标需要重新确认。大响应优先保存文件，再按范围读取，不要为查看详细结果重复下载。

代码执行有时间、内存和输出限制。点击停止后会通知执行器取消，未提交的文件不会覆盖原文件；已完成的操作仍可能保留。不要把停止后的一条错误当成可以无条件重复执行写入、上传或发布的理由。

## 助手配置与当前会话工具开关

工具是否可用还取决于助手配置和当前会话选择。在 **助手 → 编辑助手 → 工具** 中配置助手的工具；聊天页输入框工具栏的 **工具 → 选择工具** 调整当前会话的内置工具和 MCP Server，不会改写助手配置。代码工作台需要在当前会话中明确勾选，启用技能不会自动代为开启。

两处工具都按用途分组：基础能力、处理文件、创作、联网与设备、进阶（默认收起）。不知道选哪些时，点顶部 **推荐组合 → 一键开启**，推荐组合包含获取时间、向你提问、查看图片、资料目录、文件操作、Office 文档和代码工作台（获取时间和向你提问只在助手编辑页开关），只增加、不关闭已开的工具。新建助手默认就选好这一组，已有助手不受影响。工具上的 **可修改** 标签表示它可能改动文件、日程等数据；浏览器和远程连接需要 Pro。

其中 **管理技能** 和 **管理知识库** 是助手级写工具,只能在助手编辑页开关,不出现在聊天页的工具选择器里。开启后模型可以在对话中创建/更新 Skill、维护知识库笔记,管理技能写入仍需草稿确认；知识库写入默认询问，可在工具服务的授权页按操作设置全局默认和助手覆盖。未授予始终允许时，可在草稿卡修改内容或取消。「管理知识库」的查阅动作(列出知识库、读取笔记)是只读的,不会打断你。

## 接口密钥与助手环境变量

在 **助手 → 编辑助手 → 提示词 → 变量** 保存所需值后，网络请求可按授权让宿主代用指定变量；也可申请使用某个服务商的凭据。凭据与本次目标绑定，由应用附加到请求，不以明文交给脚本或模型。JavaScript 的 `process.env` 默认为空，不再使用旧版直接读取密钥的写法。不要将凭据粘贴到正文、脚本、输出文件或日志中。

## 注意事项

外部搜索服务、MCP 工具和代码工作台是否可用，取决于当前模型是否支持工具调用、工具配置和当前会话选择。内置搜索不要求模型支持普通工具调用，但必须启用模型的“内置联网”能力，并且服务商接口本身支持。