Skywork AI Tool Calling教程：高效工具集成实战指南

让大模型真正“动手干活”的关键，其实就三步：注册工具、打开权限、绑定规则。这三步一个都不能少，否则模型就算嘴上答应你“好的，我来执行”，实际上啥也不会干——它会静悄悄地把你的请求丢进垃圾桶里。

先别急着写代码，先把全局开关打开。Skywork 桌面版默认是关掉 Tool Calling 功能的，为的就是防止在你不注意的时候乱跑命令——尤其是在 Windows 系统下，进程权限需要你主动点头。

启动桌面版后，点右上角头像 → 进「Settings」→ 左侧切到「AI Agent」。找到那个叫「Enable Tool Execution」的开关，果断给它拨到 ON。同时别忘了勾上下面两项：「Allow local command execution」和「Enable Skill-based tool binding」。

⚠️ 这里有一个特别容易踩的坑：改完设置后，必须右键点任务栏图标选 Quit 彻底退出，再双击图标重新启动。关窗口再开？没用，配置不会被加载。

怎么注册 git 和 python 这两个 CLI 工具？

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

执行完之后，左侧「Tool Explorer」面板里，git 和 python 应该显示为绿色的「Ready」。如果显示灰色「Not detected」，说明你的系统 PATH 环境变量里没装对应的命令。这时候在终端里输一下 where git（Windows）或 which git（macOS/Linux），看看能不能找到。

集成腾讯地图 Skill（给 Web 前端用的）

这个 Skill 已经帮你封装好了 HTTP 请求逻辑、密钥注入和 DOM 自动挂载，所以你不用自己写 fetch 或者引入 SDK 了。简单说，你只需要告诉模型“在页面上加一个带标记的地图”，它就能自动插一段 HTML 出来。

第一步：去腾讯位置服务官网（https://lbs.qq.com/）登录腾讯云账号，进「应用管理」创建一个新应用，开通「Ja vaScript API」服务，把生成的 Key 复制下来。

第二步：回到 Skywork，按 Ctrl+Shift+P，输入「Skywork: Register Skill」并回车，在弹出的框里粘贴 Key，类型选「Web Frontend」，点 Confirm。

第三步：验证一下。Skywork 会在项目根目录下面生成 .skywork/skills/tencent-map.json，右下角弹出一个「Skill registered successfully」的提示。这时你在聊天框里输入“帮我加一个北京天安门的地图标记”，模型就会输出一段包含

怎么测试 Tool Calling 好不好使？

前面配置了一堆，最终还是要看能不能跑起来。试试这几个验证方式：

① 在聊天框里输入一句明确的指令：“运行 git status 并告诉我有没有未提交文件”

② 看底部状态栏，有没有出现「Executing git…」这样的提示。同时终端窗口应该会有一个瞬间闪现的 git 输出。

③ 如果模型回复“我无法运行命令”之类的纯文本，说明要么 Tool Calling 开关没开，要么 tools.json 的路径写错了。如果它返回类似“On branch main\nyour branch is up to date…”这种原始输出，那恭喜你，CLI 工具链打通了。

④ 最后再测一下地图 Skill：输入“在页面上渲染一个深圳腾讯大厦的地图”。等待地图容器 DOM 插入完成，页面应该会自动初始化地图并显示标记点。

来源：互联网