前言
WPS Comate 连接器用于将企业业务系统接入 AI Agent，让 AI 能够直接调用外部 API 执行真实业务操作。本教程带你完成从零配置到专家调用的全流程，以接入 GitLab 为例。
Step 1：创建连接模板
- 登录 Comate Studio 平台
- 进入左侧菜单「连接」→「连接模板」
- 点击右上角「新建连接模板」
- 填写基础信息：
- 模板名称：
GitLab 代码仓 - 连接类型：
API 连接 - 上游地址：
https://gitlab.example.com - 描述：GitLab 代码仓库管理系统的 API 接口
- 配置凭据类型：
- 认证方式选择
bearer_token - 配置 Header Key 为
Private-Token
- 点击「创建模板」
Step 2：配置 API 接口
- 进入刚创建的模板详情页，点击「新增 API」
- 填写 API 基础信息：
- API 名称：
获取项目列表 - 请求方法：
GET - 请求路径：
/api/v4/projects
- 如果有 OpenAPI 文档，可以直接粘贴 YAML 内容，系统自动解析参数
- 手动配置请求参数（如需要分页：per_page、page）
- 配置响应参数：状态码 200、JSON 格式
- 可选：绑定预处理脚本，用 Lua 实现动态鉴权逻辑
- 重复以上步骤添加更多 API（获取提交记录、创建 Issue 等）
- 绑定 Skill 能力定义，供专家识别调用
Step 3：创建连接凭证
- 进入「连接」→「连接凭证」
- 点击「新建凭证」
- 选择关联模板：
GitLab 代码仓 - 填写凭证名称：
GitLab 生产环境 Token - 填写 Token 值（从 GitLab 获取的 Access Token）
- 可选设置过期时间
- 点击「创建凭证」
凭证集中托管密钥，与模板配置解耦，更换密钥时只需更新凭证，无需修改模板。
Step 4：创建连接器实例
- 进入「连接」→「连接器」
- 点击「新建连接器」
- 选择模板：
GitLab 代码仓 - 填写连接器名称：
GitLab（专家版） - 选择凭证：
GitLab 生产环境 Token - 点击「创建连接器」
Step 5：专家调用验证
连接器创建后自动注册到 Comate 专家。在对话中通过专家发起请求：
- "查询 GitLab 上 comate-web 项目的最新提交记录"
- "列出我负责的所有 Issue"
- "创建一个新的 Merge Request"
AI Agent 会自动识别匹配的连接器 API 并执行调用，返回真实业务数据。
常见问题
Q：连接模板和连接器有什么区别？
模板是标准配置（不含密钥），连接器是基于模板创建的实例（关联具体凭证）。一个模板可以创建多个连接器。
Q：OpenAPI 导入有什么好处？
自动生成请求/响应参数文档，减少手动配置工作量，尤其适合接口数量多的系统。
Q：预处理脚本用什么语言？
支持 Lua 编写，主要用于动态鉴权、参数转换、数据预处理等场景。
注：部分内容由 AI 匹配目标关键词"WPS Comate 连接器"自动生成，仅供参考。
