跳到主要内容

内置工具参考

DesireCore 的内置工具会随客户端版本更新。本文按能力域列出常用工具和用户需要理解的边界;实际可用工具会根据智能体、已启用技能、权限策略和当前平台动态变化。

文件与搜索

工具功能风险确认
Read读取文本、图片、PDF 和大文件片段
Write创建或覆盖文件默认需要
Edit精确替换文件中的文本片段默认需要
NotebookEdit编辑 Jupyter Notebook 单元格默认需要
Ls列出目录内容
Glob按文件名模式搜索
Grep按文本或正则搜索文件内容
ToolSearch搜索延迟加载的工具、连接器和外部能力

Read 会按文件类型选择策略:文本走分页读取,图片走视觉输入,PDF 会在文本提取、按页渲染、目录定位和大文件分段读取之间切换。

系统与工作目录

工具功能风险确认
Bash执行 Shell 命令
PowerShell在 Windows 上执行 PowerShell 命令
Which检查命令是否可用
ManageWorkDirs添加、移除或设置工作目录默认需要
GenerateUUID生成 UUID
JsonRepair修复常见 JSON 格式问题

命令执行始终需要你查看完整命令后确认。工作目录决定智能体可以安全操作哪些本地文件。

网络与浏览器

工具功能风险确认
WebFetch获取网页并转换为 Markdown
WebSearch搜索互联网
HttpRequest发起 HTTP 请求,主要用于 Windows 环境视请求而定
Browser*控制浏览器标签页、点击、滚动、截图低 - 中视操作而定
SitePattern*读取或写入站点经验低 - 中写入时可能需要
LocalBookmarks查询本机浏览器书签和历史线索

Browser*SitePattern*LocalBookmarks 属于 Web Access v2 的 Skill-scoped 工具,只有对应技能启用后才会暴露。详见 Web Access

协作与任务

工具功能风险确认
Delegate委派任务给其他智能体、团队或预设流程视任务而定
SpawnAgent创建临时子智能体默认需要
Handoff把任务移交给另一个智能体默认需要
RequestHelp向持久智能体请求协助默认需要
SendMessage / SendUserMessage智能体间沟通或主动向用户发送消息
AskUserQuestion向用户发起结构化问答
ManageTeam创建或调整智能体团队视操作而定
TaskCreate / TaskUpdate维护悬浮任务板
TaskList / TaskGet查询任务板状态

任务工具用于让长任务透明可见,不会自行执行外部副作用。真正有影响的文件、命令、网络或服务调用仍受对应工具权限控制。

上下文、记忆与技能

工具功能风险确认
RecallConversation检索历史对话
CompactSession压缩长会话上下文
Skill加载或调用技能视技能而定视技能而定

CompactSession 会保留可见历史,只改变后续模型读取旧消息的方式。技能可以携带自己的工具声明和风险策略。

自动化

工具功能风险确认
CreateSchedule创建延迟、指定时间、间隔或 cron 调度
HeartbeatRespond提交心跳巡检结果、通知和文件链接
WorkflowCreate创建工作流定义默认需要
WorkflowValidate / WorkflowTest校验或测试工作流定义
WorkflowRun运行已定义工作流默认需要
WorkflowView打开工作流画布查看结构

监控类需求优先使用心跳;定时执行类需求使用调度。调度触发后会在新会话里执行,不继承你当前输入框里的临时上下文。

文档、PDF 与媒体

工具功能风险确认
ExportDocument导出 PDF、DOCX 等文档低 - 中视目标路径而定
GenerateImage生成或编辑图片视费用和 provider 而定
GenerateVideo生成视频视费用和 provider 而定
BeautifyImage美化、裁切或优化图片视费用和 provider 而定
UnderstandImage调用视觉理解 provider低 - 中视 provider 而定
MathCalc高精度确定性计算

媒体生成工具需要对应的 image_genvideo_gen 或图像处理 provider。详见 媒体生成

MCP 资源

工具功能风险确认
McpListResources / McpReadResource列出和读取 MCP 资源
McpListPrompts / McpGetPrompt列出和展开 MCP Prompt

MCP 工具来自你连接的外部服务。它们的权限、风险和审批策略由服务声明与 DesireCore 的本地权限层共同决定。