模型与连接器

区分两类连接

模型配置决定 AI 工作台调用哪个模型；连接器用于授权访问外部服务的数据和操作。配置模型不会自动授权第三方数据，完成连接器 OAuth 也不会让它变成登录方式。

配置模型

从用户菜单进入模型管理（/agent/llm），按服务商填写接口地址、模型标识及访问凭证。实际可填字段和可用模型以当前实例页面及服务商配置为准。

保存后在工作台进行一次小范围请求，确认连接、模型标识和配额正常，再用于长任务。如果失败，先查看错误信息，检查地址、密钥有效期、模型访问权限和服务商配额。

管理连接器提供商

管理员在 系统设置 → 连接器 管理提供商。设置页展示回调地址以及各提供商的配置和启用状态。

1. 在外部服务创建对应应用。
2. 复制当前实例显示的回调地址到外部应用设置。
3. 按提供商要求填写应用配置，保存并启用。
4. 需要使用外部服务的用户再到连接器页面完成自己的授权。

提供商列表不代表每个服务的所有 API 都已经支持。实际可用操作以实例中的连接器能力为准。

授权异常

回调错误时先核对域名、协议和路径；授权过期时重新连接。模型错误和连接器错误应分别排查，避免通过修改另一类配置来反复重试。

仅授予业务所需权限，使用专用凭证；不要把密钥放进工作空间公开说明或截图。