内置工具参考
DesireCore 的内置工具随客户端提供，智能体无需额外安装即可使用。工具是否出现在智能体上下文中取决于平台、权限、审批策略、当前运行环境和任务上下文；例如 PowerShell 与 HttpRequest 主要面向 Windows 环境。
快速索引
| 类别 | 工具 |
|---|---|
| 文件操作 | Read、Write、Edit、NotebookEdit |
| 搜索与发现 | Glob、Grep、Ls、ToolSearch |
| 命令、等待与网络 | Bash、PowerShell、Which、Sleep、WebFetch、WebSearch、HttpRequest |
| 智能体协作 | Delegate、spawn_agent、handoff、request_help、SendMessage、SendUserMessage、AskUserQuestion、ManageTeam |
| 工作空间与数据 | ManageWorkDirs、GenerateUUID、RecallConversation、JsonRepair |
| 技能与调度 | Skill、CreateSchedule |
| MCP | McpListResources、McpReadResource、McpListPrompts、McpGetPrompt |
| 工作流 | WorkflowCreate、WorkflowValidate、WorkflowTest、WorkflowRun、WorkflowView |
风险和确认
| 风险等级 | 常见工具 | 默认确认 |
|---|---|---|
| 低 | Read、Glob、Grep、Ls、Which、Sleep、WebFetch、WebSearch、GenerateUUID、JsonRepair | 通常不需要 |
| 中 | Write、Edit、NotebookEdit、ManageWorkDirs、CreateSchedule、WorkflowRun、HttpRequest | 写入、目录管理或后台任务类通常需要更谨慎 |
| 高 | Bash、PowerShell | 通常需要确认 |
| 继承配置 | Skill、MCP 工具、工作流节点 | 取决于技能、MCP Server 或工作流节点声明 |
实际确认行为还会受到你的权限设置、审批模式和操作内容影响。命令执行、文件写入、外部发送和高影响操作应在确认前检查工作目录、命令内容和意图。
文件操作
Read（读取文件）
| 属性 | 说明 |
|---|---|
| 功能 | 读取文本、代码、配置、图片和 Notebook 内容；支持范围读取和分页 |
| 风险等级 | 低 |
| 需要确认 | 否 |
| 使用场景 | 查看代码、阅读文档、检查配置、预览图片、理解 Notebook |
Write（写入文件）
| 属性 | 说明 |
|---|---|
| 功能 | 创建新文件或完整覆盖已有文件；目录不存在时可自动创建 |
| 风险等级 | 中 |
| 需要确认 | 通常需要 |
| 使用场景 | 创建文档、生成报告、保存配置、写入完整文件 |
Edit（编辑文件）
| 属性 | 说明 |
|---|---|
| 功能 | 对文件做精确文本替换，适合局部修改 |
| 风险等级 | 中 |
| 需要确认 | 通常需要 |
| 使用场景 | 修复代码片段、更新配置项、修改文档中的特定段落 |
NotebookEdit（编辑 Jupyter Notebook）
| 属性 | 说明 |
|---|---|
| 功能 | 替换、插入或删除 Jupyter Notebook 的指定单元格 |
| 风险等级 | 中 |
| 需要确认 | 通常需要 |
| 使用场景 | 调整数据分析 Notebook、补充实验代码、整理计算步骤 |
搜索与发现
Glob（搜索文件名）
| 属性 | 说明 |
|---|---|
| 功能 | 使用 glob 模式搜索文件名，支持 **/*.ts 这类递归匹配 |
| 风险等级 | 低 |
| 需要确认 | 否 |
| 使用场景 | 查找配置文件、定位测试文件、浏览项目结构 |
Grep（搜索文件内容）
| 属性 | 说明 |
|---|---|
| 功能 | 在文件内容中搜索文本或正则表达式，支持上下文和文件类型过滤 |
| 风险等级 | 低 |
| 需要确认 | 否 |
| 使用场景 | 查找函数调用、定位错误信息、搜索文档关键词 |
Ls（列出目录）
| 属性 | 说明 |
|---|---|
| 功能 | 列出目录中的文件和子目录，可按需递归显示 |
| 风险等级 | 低 |
| 需要确认 | 否 |
| 使用场景 | 浏览工作区、确认文件位置、查看目录结构 |
ToolSearch（搜索延迟工具）
| 属性 | 说明 |
|---|---|
| 功能 | 搜索可延迟加载的工具、连接器和外部能力 |
| 风险等级 | 低 |
| 需要确认 | 否 |
| 使用场景 | 查找 GitHub、浏览器调试、文档查询等按需加载工具 |
命令、等待与网络
Bash（执行 Shell 命令）
| 属性 | 说明 |
|---|---|
| 功能 | 在 macOS/Linux 或支持 Shell 的环境中执行命令；支持超时、后台运行和输出截断 |
| 风险等级 | 高 |
| 需要确认 | 通常需要 |
| 使用场景 | 运行测试、构建项目、安装依赖、执行脚本 |
PowerShell（执行 Windows PowerShell 命令）
| 属性 | 说明 |
|---|---|
| 功能 | 在 Windows 上执行 PowerShell 命令和脚本 |
| 风险等级 | 高 |
| 需要确认 | 通常需要 |
| 使用场景 | Windows 系统管理、运行 PowerShell 脚本、检查本机环境 |
Which（检查命令是否可用）
| 属性 | 说明 |
|---|---|
| 功能 | 检查一个或多个命令行工具是否存在，并返回可执行路径 |
| 风险等级 | 低 |
| 需要确认 | 否 |
| 使用场景 | 执行命令前确认依赖是否安装 |
Sleep（当前会话等待）
| 属性 | 说明 |
|---|---|
| 功能 | 在当前会话中等待 0.1 到 300 秒，等待结束后继续原任务链 |
| 风险等级 | 低 |
| 需要确认 | 否 |
| 使用场景 | 等待构建完成、轮询部署状态、控制请求频率 |
Sleep 与 CreateSchedule
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（打开工作流）
| 属性 | 说明 |
|---|---|
| 功能 | 打开工作流画布进行查看，不直接编辑内容 |
| 风险等级 | 低 |
| 使用场景 | 查看流程结构、审查节点配置 |