想把企业系统的能力一键交给 AI 使用？这篇文章以接入一个外部系统为例，带你走完从创建连接模板、绑定 Skill 到发布后自动同步的全流程。
为什么需要 Skill 同步
很多企业已经接入了连接器，把系统 API 都打通了，却发现 AI 并不知道该怎么调用这些接口。原因就是缺少"技能"这一层：AI 不认识连接器能做什么。
WPS Comate Skill同步正是为了解决这个问题。它让连接模板上绑定的 Skill 能力，在连接器发布后自动同步到 AI 对话，AI 自动识别并调用，真正实现即装即用。
准备工作
开始之前，请确认以下几点：
- 拥有 Comate Studio 平台的管理员或开发者权限
- 已确定要接入的外部系统地址、API 接口信息
- 准备好对应的认证凭据（API Key、Token、OAuth 等）
- 如需上传自定义 Skill 包，请准备好符合格式要求的 zip 文件
操作步骤
第一步：创建连接模板
进入 Comate Studio 左侧菜单「连接」→「连接模板」，点击右上角「新建连接模板」。
填写基本信息：模板名称、连接类型（API 连接或 MCP 连接）、上游服务地址、描述等。接着配置凭据类型，从下拉列表选择认证方式，并按要求填写凭证字段。
点击「创建模板」，一个连接模板就建好了。这个模板会成为后续所有连接器的标准配置单元。
第二步：管理模板下的 API
进入连接详情页，点击右上角「新增 API」。填写 API 名称、请求方法（GET/POST/PUT/DELETE）、请求路径和功能描述。
如果你有现成的接口定义，可以粘贴 OpenAPI 3.x 规范的 YAML 内容，系统会自动解析并生成请求参数、响应参数和数据模型，大幅减少手动配置成本。
第三步：配置 Skill 能力
这是 Skill 同步的关键一步。在连接模板的「Skill能力」标签下，可以为模板绑定 Skill 能力包。系统支持下载默认模板，也可以上传 zip 格式的 Skill 包，为连接扩展自定义能力。
绑定后，基于该模板创建的所有连接器都会继承这份技能能力。
第四步：创建连接凭证
进入「连接」→「连接凭证」，点击「新建凭证」。选择关联的模板，填写凭证名称（如"GitLab 生产环境 Token"），再按模板配置的字段填写身份信息。可选设置过期时间，到期后凭证自动失效。
凭证集中托管于服务端，调用时由网关自动注入，AI 不会直接触达密钥。
第五步：创建连接器实例
进入「连接」→「连接器」，点击「新建连接器」。选择刚才创建的连接模板，填写连接器名称，再选择对应的凭证。点击「创建连接器」，实例就创建完成了。
第六步：发布后 Skill 自动同步
连接器创建并发布后，其上绑定的 Skill 会自动同步到 Comate 的 AI 对话环境。此时在 AI 专家对话中，AI 会自动识别已同步的技能并调用对应 API，实现即装即用。
第七步：在 AI 对话中验证调用
回到 Comate 对话，用一个自然语言问题测试，比如"查一下最近的项目列表"。如果配置正确，AI 会调用同步好的 Skill 对应 API，返回真实业务数据。
效果展示
完成 Skill 同步后，你会看到：
- AI 对话中可以直接调用企业系统能力，无需人工翻接口文档
- 同一套技能可在专家、对话、API、数据建模等多种场景复用
- 系统更新时，只需调整连接模板，技能和 AI 调用逻辑保持稳定
- 每次调用都有全链路日志，方便追溯和审计
常见问题（FAQ）
问：Skill 上传后格式有要求吗？
答： 支持上传 zip 格式的 Skill 包。系统也提供默认模板可供下载，作为自定义能力的起点。
问：多个连接器能复用同一个 Skill 模板吗？
答： 可以。连接模板是标准配置单元，多个连接器可以复用同一个模板及其绑定的 Skill 能力，实现统一管理。
问：发布后 Skill 多久能同步到对话？
答： 连接器发布后，Skill 会随之自动同步到 Comate 对话环境，即时生效，无需额外等待或手动配置。
问：凭证信息会被 AI 看到吗？
答： 不会。凭证集中加密存储在服务端，调用时由网关自动注入，鉴权信息不进入大模型上下文，避免泄露和越权。
注：部分内容由 AI 匹配目标关键词，结合WPS 365 官方知识库智能生成，如有疑问或者建议可以联系我们。
