docs(provider): 补充模型服务商配置说明

2026-09-18 16:48:30 +08:00
parent 6b365d9953
commit 3000274c77
7 changed files with 71 additions and 3 deletions
@@ -94,6 +94,24 @@ replacedBy: null
 - 事件和完成的工具调用设置为只读或限制修改。
 - 人工确认处理必须调用领域服务，不能只修改单个状态字段。

+### 3.7 模型服务商配置
+
+`GET /runs/providers/`
+
+- 返回内置服务商目录、当前用户连接状态、搜索和分类结果。
+- 不返回密文 API Key，已配置密钥只显示末四位提示。
+
+`POST /runs/providers/<provider_code>/configure/`
+
+- 输入：API Key、可选默认模型、是否设为默认服务商。
+- 服务端按固定预设端点请求模型目录；验证成功后才加密保存。
+- 验证失败返回安全错误说明，不透传上游正文，不覆盖旧密钥。
+
+`POST /runs/providers/<provider_code>/disconnect/`
+
+- 只删除当前用户对应配置；删除默认配置后自动选择一个剩余可用配置。
+- GET 请求不得删除或修改配置。
+
 ## 4. 表单契约

 ### 4.1 登录表单