内置工具一览
内置工具是 DesireCore 自带的基础能力，随客户端一起安装。智能体会根据当前操作系统、已启用的权限、可用工具和任务上下文自动选择工具；不可用的工具不会进入智能体的能力声明。
文件操作类
Read — 读取文件
读取文本、代码、配置、图片和 Notebook 内容。支持指定行范围、分页读取、图片识别和 Notebook 单元格读取。
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
| 典型场景 | 查看代码、阅读文档、检查配置、预览图片 |
Write — 写入文件
创建新文件或完整覆盖已有文件。目录不存在时会自动创建。
| 属性 | 值 |
|---|---|
| 风险等级 | 中 |
| 需要确认 | 是 |
| 典型场景 | 创建文档、保存报告、生成配置文件 |
Edit — 编辑文件
对文件做精确文本替换，适合小范围修改。相比整文件覆盖，它更容易审查差异，也更适合修改代码和文档。
| 属性 | 值 |
|---|---|
| 风险等级 | 中 |
| 需要确认 | 是 |
| 典型场景 | 修复代码片段、更新配置项、修改文档中的局部内容 |
NotebookEdit — 编辑 Jupyter Notebook
替换、插入或删除 Jupyter Notebook 的指定单元格。
| 属性 | 值 |
|---|---|
| 风险等级 | 中 |
| 需要确认 | 是 |
| 典型场景 | 调整数据分析 Notebook、补充实验代码、整理计算步骤 |
搜索与浏览类
Glob — 搜索文件名
按 glob 模式查找文件，支持 **/*.ts 这类递归匹配，并会优先使用高性能文件搜索工具。
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
| 典型场景 | 查找配置文件、定位测试文件、浏览项目结构 |
Grep — 搜索文件内容
在文件中搜索文本或正则表达式，支持上下文行、文件类型过滤、大小写控制和多种输出模式。
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
| 典型场景 | 查找函数调用、定位错误信息、搜索文档关键词 |
Ls — 列出目录内容
列出目录中的文件和子目录，可按需递归显示。
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
| 典型场景 | 浏览工作区、确认文件位置、查看目录结构 |
ToolSearch — 搜索可用工具
在可延迟加载的工具和集成能力中搜索匹配项，帮助智能体发现当前任务可能需要的扩展工具。
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
| 典型场景 | 查找 GitHub、浏览器调试、文档查询等延迟工具 |
命令执行类
Bash — 执行 Shell 命令
在 macOS/Linux 上执行 Shell 命令；Windows 场景下通常优先使用 PowerShell 或 Git Bash。支持超时、后台运行和输出截断。
| 属性 | 值 |
|---|---|
| 风险等级 | 高 |
| 需要确认 | 是 |
| 典型场景 | 运行测试、构建项目、安装依赖、执行脚本 |
命令执行可能修改系统状态或访问外部网络。确认前请检查命令内容、工作目录和操作意图。
PowerShell — 执行 Windows PowerShell 命令
仅在 Windows 上可用。用于执行 PowerShell 命令和脚本，支持版本感知提示、超时控制、后台运行和大输出处理。
| 属性 | 值 |
|---|---|
| 风险等级 | 高 |
| 需要确认 | 是 |
| 典型场景 | Windows 系统管理、运行 PowerShell 脚本、检查本机环境 |
Which — 检查命令是否可用
检查一个或多个命令行工具是否存在，并返回可执行路径。
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
| 典型场景 | 执行命令前确认依赖是否安装 |
Sleep — 等待一段时间
让智能体在当前会话中等待 0.1 到 300 秒，等待结束后继续原任务链。它不占用 Shell 进程，并支持用户中断。
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
| 典型场景 | 等待构建完成、轮询部署状态、控制请求频率 |
Sleep 是当前会话内的阻塞等待，适合“等几秒后继续检查”。CreateSchedule 是后台异步调度，到点后创建新的执行任务，适合提醒、定期检查和独立汇报。
网络类
WebFetch — 获取网页
获取网页内容并转换为 Markdown，支持正文提取、缓存和超时控制。
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
| 典型场景 | 阅读在线文档、查看 API 参考、摘取网页正文 |
WebSearch — 网页搜索
搜索互联网并返回结果，支持结果数量和域名过滤。
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
| 典型场景 | 获取最新资料、检索公开信息、查找问题解决方案 |
HttpRequest — 发起 HTTP 请求
仅在 Windows 上注册，用于在缺少常用命令行网络工具时发起 HTTP 请求。
| 属性 | 值 |
|---|---|
| 风险等级 | 中 |
| 需要确认 | 取决于请求内容 |
| 典型场景 | 调用 API、检查服务状态、获取结构化数据 |
智能体协作类
Delegate — 委派任务
将任务委派给其他智能体、团队或预设子流程。支持同步、异步、handoff 和 Explore 等模式。
| 属性 | 值 |
|---|---|
| 风险等级 | 中 |
| 需要确认 | 取决于权限和任务内容 |
| 典型场景 | 跨专业分工、并行调研、让 Explore 预设只读分析代码库 |
spawn_agent — 启动子智能体
启动临时子智能体处理明确的子任务。子智能体拥有独立上下文，适合并行处理独立问题。
| 属性 | 值 |
|---|---|
| 风险等级 | 中 |
| 需要确认 | 取决于权限和任务内容 |
| 典型场景 | 并行阅读多个模块、拆分大型问题、隔离探索任务 |
handoff — 转交会话
将当前会话交给另一个智能体，并携带原因和上下文摘要。
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
| 典型场景 | 当前智能体判断另一个专业智能体更适合继续处理 |
request_help — 请求协助
向另一个持久智能体请求意见或帮助，可选择等待对方回复。
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
| 典型场景 | 向领域专家智能体征询建议 |
SendMessage — 智能体间发送消息
向另一个智能体发送消息，可携带上下文、意图和等待策略。
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
| 典型场景 | 多智能体协作、任务结果回传、团队内沟通 |
SendUserMessage — 向用户发送消息
智能体主动向你发送 Markdown 消息，可附带文件附件，并能以普通或主动通知状态展示。
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
| 典型场景 | 汇报阶段性结果、发送带附件的说明、主动提醒你关注事项 |
AskUserQuestion — 向用户提问
在当前会话中显示结构化问题卡片，让智能体向你收集确认、选择或补充信息。
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
| 典型场景 | 澄清需求、确认方案、收集多个字段的答案 |
ManageTeam — 管理团队
创建和调整智能体团队，设置主管智能体、成员和团队任务。
| 属性 | 值 |
|---|---|
| 风险等级 | 中 |
| 需要确认 | 取决于操作内容 |
| 典型场景 | 组建专业团队、调整团队成员、分配团队任务 |
工作空间与数据类
ManageWorkDirs — 管理工作目录
管理智能体可访问的工作目录，包括列出、添加、移除和设置主目录。
| 属性 | 值 |
|---|---|
| 风险等级 | 中 |
| 需要确认 | 是 |
| 典型场景 | 添加项目目录、切换主工作区、移除不再使用的路径 |
GenerateUUID — 生成唯一标识
生成一个或多个 UUID v4。
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
| 典型场景 | 创建唯一 ID、生成测试数据、命名资源 |
RecallConversation — 检索对话历史
用于按关键词和时间范围检索历史对话记录。
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
| 典型场景 | 回顾之前的讨论、查找历史决策、恢复上下文 |
JsonRepair — 修复 JSON
修复常见的 JSON 格式问题，并可按预期结构进行整理。
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
| 典型场景 | 修复模型生成的 JSON、整理配置片段 |
记忆、技能与调度类
Skill — 加载技能
加载并执行指定技能包。技能包可声明可用工具、触发方式、上下文模式、模型和供应商偏好。
| 属性 | 值 |
|---|---|
| 风险等级 | 继承技能配置 |
| 需要确认 | 继承技能和其调用工具配置 |
| 典型场景 | 执行专业流程、调用自定义能力、应用内置全局技能 |
CreateSchedule — 创建调度任务
创建后台定时任务，支持指定时间、延迟、固定间隔和 Cron 规则。
| 属性 | 值 |
|---|---|
| 风险等级 | 中 |
| 需要确认 | 取决于审批策略 |
| 典型场景 | 设置提醒、定期生成报告、安排独立 Prompt 检查 |
MCP 资源类
McpListResources / McpReadResource
列出或读取 MCP Server 暴露的资源。
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
| 典型场景 | 查看外部服务资源、读取连接器提供的数据 |
McpListPrompts / McpGetPrompt
列出或获取 MCP Server 提供的 Prompt 模板。
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
| 典型场景 | 复用外部服务提供的标准提示模板 |
工作流类
WorkflowCreate — 创建工作流
根据 DSL 创建工作流文件，并可同时写入说明文档。
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
| 典型场景 | 新建可复用自动化流程 |
WorkflowValidate — 校验工作流
校验工作流 DSL 的结构、节点、边和引用关系。
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
| 典型场景 | 保存前检查工作流配置是否有效 |
WorkflowTest — 测试工作流
使用参数测试工作流执行路径，帮助确认节点配置和输入输出是否正确。
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
| 典型场景 | 调试自动化流程、验证节点输出 |
WorkflowRun — 运行工作流
执行工作流并返回结构化结果。
| 属性 | 值 |
|---|---|
| 风险等级 | 中 |
| 需要确认 | 否 |
| 典型场景 | 执行包含代码、LLM、Agent 或人工确认节点的流程 |
WorkflowView — 打开工作流
打开工作流画布进行查看，不直接编辑内容。
| 属性 | 值 |
|---|---|
| 风险等级 | 低 |
| 需要确认 | 否 |
| 典型场景 | 查看流程结构、审查节点配置 |