必须完成工具注册、权限激活与结构化绑定三步闭环,否则模型只会“说”而无法“做”;需开启「enable tool execution」开关并勾选子选项,新建tools.json注册git/python工具,通过ctrl+shift+p注册腾讯地图skill,最后用指令测试执行状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在 Skywork AI 桌面版中让大模型真正调用外部工具(如执行 Python 脚本、运行 git 命令、查询本地文件或接入腾讯地图等 Skill),必须完成工具注册、权限激活与结构化绑定三步闭环,缺一不可——否则模型只会“说”而无法“做”,所有工具调用请求将被静默丢弃。
启用 Skywork 桌面版 Tool Calling 核心开关
这一步是全局闸门,不开启则后续所有工具定义均无效。Skywork 默认关闭 Tool Calling 以防止误执行命令,尤其在 Windows 环境下需显式授权进程调用权限。
启动 Skywork 桌面版后,在右上角点击用户头像 → 选择「Settings」→ 左侧菜单切换至「AI Agent」标签页。
找到「Enable Tool Execution」开关,将其置为 【ON】;下方同步勾选「Allow local command execution」和「Enable Skill-based tool binding」两项子选项。
⚠️ 注意:修改后必须完全退出应用(任务栏右键→Quit,而非仅关闭窗口),再双击桌面图标重启——仅刷新页面或重开窗口不会加载新配置。
注册自定义 CLI 工具(git / python)
CLI 工具通过解析项目根目录下的 tools.json 文件动态加载,文件名与路径必须严格匹配,否则 Skywork 启动时直接跳过识别。
方法一:手动创建注册文件
在你要使用的项目文件夹内新建文件 tools.json,内容格式如下:
{ "git": { "path": "git", "description": "执行版本控制操作", "args": ["status", "add", "commit", "push"] }, "python": { "path": "python", "description": "运行 Python 脚本或内置模块", "args": ["-c", "-m", "http.server"] } }
方法二:使用内置命令行工具自动注入
打开 Skywork 内置终端(Ctrl+`),cd 进入项目根目录后执行:
skywork tool register --from-cli git,python
天工 Skywork 桌面版是专为 Mac 用户打造的本地 AI 办公助手,被称为“macOS版Claude Cowork”。它无需上传云端,即可直接读取并处理本地复杂文件。产品采用本地虚拟机隔离技术保障数据安全,并创新支持 Claude 与 Gemini 双模型智能路由。内置超百项精选技能,轻松实现跨格式办公与多模态内容创作,全面赋能桌面生产力。
执行成功后,左侧「Tool Explorer」面板中 git 和 python 应显示绿色「Ready」状态;若为灰色「Not detected」,请检查系统 PATH 中是否真能调用 git 或 python —— 在终端输入 where git(Windows)或 which git(验证路径有效性)。
集成腾讯地图 Skill(Web 前端场景专用)
该 Skill 已预封装 HTTP 请求逻辑、密钥注入与 DOM 自动挂载能力,适用于“在当前网页插入带标记的地图”类指令,无需手写 fetch 或引入 SDK。
第一步:获取合法腾讯位置服务 Key
访问 https://lbs.qq.com/ → 登录腾讯云账号 → 进入「应用管理」→ 创建新应用 → 开通「JavaScript API」服务 → 复制生成的 Key。
第二步:在 Skywork 中注册 Skill
按下 Ctrl+Shift+P → 输入「Skywork: Register Skill」→ 回车 → 在弹出框中粘贴 Key → 选择类型为「Web Frontend」→ 点击 Confirm。
第三步:验证集成结果
Skywork 自动在项目根目录下生成 .skywork/skills/tencent-map.json,且右下角弹出「Skill registered successfully」提示;此时在聊天框输入“帮我加一个北京天安门的地图标记”,模型将输出含 的 HTML 片段并自动注入当前页面 DOM。
测试 Tool Calling 是否生效
① 在聊天界面输入明确触发指令:“运行 git status 并告诉我有没有未提交文件”
② 观察底部状态栏是否出现「Executing git…」提示,同时终端窗口短暂闪现 git 输出结果
③ 若返回纯文本“我无法运行命令”,说明 Tool Calling 开关未启用或 tools.json 路径错误;若返回类似“On branch main\nYour branch is up to date…”的原始输出,则证明 CLI 工具链已打通
④ 输入“在页面上渲染一个深圳腾讯大厦的地图”,等待地图容器 DOM 插入完成并自动初始化










