提示：WPS Comate Token自动管理让网关自动维护 Token 生命周期，无需人工运维。
为什么需要 Token自动管理？
很多业务系统（尤其是采用 OAuth 应用授权的数据服务）返回的访问令牌 access_token 都有有效期，过期后需要刷新。如果人工维护，要定时获取新 Token、处理刷新逻辑，工作量大且容易出错。
Token自动管理就是解决这个问题的钥匙——网关自动完成 Token 的获取、提取、注入和刷新，AI 助手调用时始终使用有效 Token，全程无需人工干预。
准备工作
在开始配置 Token自动管理之前，需要准备以下内容：
- 拥有 WPS 365 管理员账号，并已开通 Comate Studio 平台权限
- 获取目标系统的接口文档，确认其采用 OAuth 应用授权
- 获取 client_id 等应用凭证
- 用 Postman 调一次 Token 接口，确认返回的 JSON 结构
操作步骤
Step 1：进入连接模板
打开浏览器，访问 Comate Studio 平台，使用管理员账号登录。进入左侧菜单栏的「APIHub 连接开发」→「连接模板」。
Step 2：创建连接模板
点击「新建连接模板」，填写模板名称、上游地址。鉴权方式选择 OAuth 2.0 应用授权（client_credentials），配置应用凭证。
Step 3：配置 Token 路径
在模板中配置 Token 管理参数：
- Token 路径：填写 access_token 在返回 JSON 中的字段位置，如
access_token或data.access_token - 过期时间路径：填写 expires_in 的字段位置
注意：Token 路径和过期时间路径必须与 Token 接口返回的实际 JSON 结构完全一致，否则网关无法提取 Token。
Step 4：配置 API 接口
在连接模板中添加需要暴露给 AI 助手的 API 接口，配置请求方法、路径参数、请求体和响应格式。
Step 5：创建连接器
创建凭证（填写 client_id、refresh_token），创建连接器实例，然后从模板同步 Skill 到连接器。
Step 6：调用验证
在客户端启用连接器，对话输入测试："帮我查一下某股票的实时行情"——AI 助手调用接口，网关自动获取/注入/刷新 Token，返回数据。
效果展示
配置完成后，团队成员可以在 Comate 中通过自然语言与 AI 助手交互，AI 会自动调用连接器配置的 API 接口。网关在后台自动完成 Token 的获取、注入和刷新，用户完全无感知。
例如，配置了金融数据连接器后，可以直接问："帮我查一下贵州茅台的实时行情"——AI 助手自动调用接口，网关自动处理 Token，返回实时股价数据。
常见问题（FAQ）
问：Token 路径填错了会怎样？
答： 如果 Token 路径与实际 JSON 结构不一致，网关无法提取 access_token，API 调用会失败。因此接入前务必用 Postman 验证一次返回结构。
问：Token 自动刷新需要额外配置吗？
答： 不需要。配置好 Token 路径和过期时间路径后，网关自动根据 expires_in 在到期前用 refresh_token 刷新，无需额外配置。
问：可以随时修改 Token 路径吗？
答： 可以。在连接模板编辑页面可以随时修改 Token 路径和过期时间路径。修改后，引用该模板的连接器会自动应用新配置。
问：Token 泄露了怎么办？
答： Token 由网关统一管理、加密托管，大模型不接触原始凭证。如果担心泄露，可以在业务系统侧吊销并重新签发 Token，然后更新连接器凭证。
注：部分内容由 AI 匹配目标关键词，结合WPS 365 官方知识库智能生成，如有疑问或者建议可以联系我们。
