Skywork自动化工作流集成第三方工具授权实践

第一步：开启全局工具执行开关——这道闸门你别忘了

这是最常见，也最容易被忽略的“第一道防线”。Skywork 出于安全性考虑，默认状态下禁止本地命令调用，尤其在 Windows 操作系统下，需要你主动授予权限。 具体操作如下： 1. 点击右上角的用户头像，进入「Settings」设置页面。 2. 切换到「AI Agent」标签页。 3. 打开「Enable Tool Execution」主开关。完成这一步后，务必同时勾选下方两个子选项：**Allow local command execution** 和 **Enable Skill-based tool binding**。 4. 必须特别强调：**修改完设置后，一定要完全退出应用程序**（在任务栏右键选择退出，而非仅仅关闭窗口），然后双击图标重新启动。如果只关闭窗口，此开关不会生效。这是最容易卡住的环节，请务必注意。

第二步：注册CLI工具（以git和python为例）

简单来说，CLI 工具就是你的命令行程序，例如 git、python 等。Skywork 需要通过一个名为 `tools.json` 的配置文件来识别这些工具。路径和文件名必须完全一致，否则启动时会被自动忽略。 具体操作方法有两种： **方法一：手动创建 `tools.json` 文件** 在你的项目根目录下新建一个 `tools.json` 文件，内容格式可参考如下（支持 git、python 等常用命令）： ```json { "git": { "path": "git", "description": "执行版本控制操作", "args": ["status", "add", "commit", "push"] }, "python": { "path": "python", "description": "运行 Python 脚本或内置模块", "args": ["-c", "-m", "http.server"] } } ``` **方法二：使用内置命令行注入** 如果你觉得手动创建文件较为繁琐，可以直接在 Skywork 的命令行中输入： `skywork tool register --from-cli git,python` 注意，请先确认你的命令行当前目录正位于项目根目录下。 **验证是否成功的方法很简单**：在左侧的「Tool Explorer」面板中，对应的工具会显示绿色的「Ready」状态。如果显示灰色的「Not detected」，那么问题通常出现在系统 PATH 环境变量配置上——Windows 用户可以在命令行执行 `where git`，macOS/Linux 用户执行 `which git`，检查你的系统是否能直接调用这些命令。

第三步：绑定Skill类工具（比如腾讯地图、PPT/Excel）

Skill 是 Skywork 面向办公场景的高级能力模块，与 CLI 工具不同，它不依赖 JSON 配置文件，而是通过快捷键注册和启用。 * 按下 **Ctrl+Shift+P** 调出命令面板，输入并选择「Register Tencent Map Skill」即可完成腾讯地图的接入。 * PPT、Excel、Document 这三类 Skill 是 Skywork 内置的，你无需手动注册，但需要进入 Settings → AI Agent 确认它们的开关已经打开。 * **使用时直接用自然语言指令触发**，例如：“用 Skywork PPT 给我生成一份周报，风格选商务简约，包含封面、目录和3页数据图表”，它就会自动开始工作。

测试与调试：怎么知道它到底通不通？

工具集成完毕后，先别急着执行复杂任务。建议先用最小可执行指令跑一遍，确认全链路是否畅通。 * **先测试基础CLI**：直接输入“帮我运行 git status”，看看它是否能正确返回你仓库的状态信息。 * **再测试Skill**：输入“用 Skywork Excel 生成一个销售统计表，包含柱状图和异常值提醒”，检查它是否能正常生成一个 .xlsx 文件并弹出预览。 如果执行失败，不必慌张，先查看右下角状态栏是否有红色报错提示。常见的坑无非以下几个方面：权限开关修改后未重启生效、系统 PATH 路径不正确导致 Skywork 找不到命令、Skill 对应的子功能未被勾选启用。逐一排查这些问题，基本都能解决。 总的来说，这三个步骤构成了一个完整的授权闭环。走完这套流程，你的 Skywork 桌面版才能真正从一个“聊天机器人”转变为一个“能干活的智能助理”。