Enterprise
API 端点与网关配置
管理私有部署的模型 API 端点,支持 Anthropic 与 OpenAI 协议。
API 端点与网关配置
WinCode 不绑定单一模型提供商。通过 endpoint 模块,可以把公司内部统一提供的模型网关,或第三方提供的 API 入口,都作为"端点"管理起来,并在聊天时随时切换。
核心概念
一个"端点"(ApiEndpoint) 对应一个可用的模型入口,至少包含:
name- 在 UI 中显示的名字url- 请求的基地址apiKey- 访问该端点的密钥protocol-anthropic或openai,决定请求格式models- 该端点下可用的模型列表defaultModel- 默认用于主对话的模型defaultSubagentModel- 默认用于子代理的模型status-connected/error/pending
管理操作
endpoint 服务提供了以下能力:
| 操作 | 函数 | 说明 |
|---|---|---|
| 列出所有端点 | endpointList() | 获取本地数据库中的端点列表 |
| 新增 / 修改 | endpointSave(endpoint) | 保存一个端点(新增或更新) |
| 删除 | endpointDelete(id) | 按 ID 删除一个端点 |
| 测试连接 | endpointTest(id) | 验证端点可用性,返回延迟毫秒数 |
| 发现模型 | endpointDiscoverModelsByUrl(url, apiKey, protocol?) | 按 URL 拉取该端点暴露的模型列表 |
| 增加 / 移除模型 | endpointAddModel / endpointRemoveModel | 在端点下手动维护模型 |
AddEndpointDialog
新增端点时,AddEndpointDialog 提供了一步到位的体验:输入 URL 与 API Key 后,点击保存会自动调用 endpointDiscoverModelsByUrl 抓取该端点可用的模型列表,并把第一个模型设为默认主对话模型、第二个模型设为默认子代理模型。如果抓取失败(比如端点不支持模型发现接口),用户可以手动在 ApiEndpointCard 里添加模型。
ApiEndpointCard
每张卡片展示一个端点的详情:状态指示灯、展开后的模型列表、"测试连接""编辑""删除""刷新模型"等操作。测试连接会返回延迟毫秒数,便于判断私有网关的可达性。
私有部署场景
公司内部通常会有一个统一的模型网关(例如基于 LiteLLM / OneAPI 之类的聚合层),对所有开发者暴露同一个 url,用同一个 apiKey。运维只需要把这个端点信息分发给团队,开发者在设置页一键添加,就能立即使用。
对于需要区分主对话与子代理模型的场景,可以在端点下配置多个模型,并分别指定 defaultModel 和 defaultSubagentModel,让 WinCode 在不同任务上选择最合适的模型。