租户开发设置

租户开发设置用于配置当前租户的域名、企业微信与企业自有 AI 模型等运行时参数。

概述

从 开发中心 → 开发设置 → 系统设置 进入租户开发设置页面。所有设置项均作用于当前租户，修改后自动保存（输入停止约 500ms 后提交）。

页面按功能划分为三个卡片：

卡片	作用
域名设置	配置租户的自定义访问域名
企业微信设置	配置企业微信应用凭证，用于企业微信登录与通讯录同步
AI 模型设置	开启并配置租户自有的 OpenAI 兼容模型，并查看/重置模型使用量

自动保存

除开关类设置外，文本类设置均为自动保存，无需点击保存按钮。

配置项

域名设置

配置项	说明
自定义域名	租户的独立访问域名，最长 100 字符

企业微信设置

配置项	说明
企业微信 CorpAppId	企业 ID，示例 `wwb7e36b32e01e0041`
企业微信 CorpAgentId	应用 AgentId，示例 `1000004`
企业微信 AuthSecret	应用 Secret，用于获取应用访问令牌
企业微信 ContactSecret	通讯录 Secret，用于同步通讯录

各项的获取方式详见企业微信配置。

AI 模型设置

配置项	说明
启用自定义 AI 模型	开启后使用租户自有模型，关闭则使用平台默认模型
AI 模型类型	模型提供方类型，当前支持 `OpenAiCompatible`
AI 模型名称	模型名称，如 `gpt-4o-mini`
AI 模型接口地址	兼容 OpenAI 协议的接口地址，示例 `https://api.openai.com/v1`
AI 模型 API Key	调用模型所需的密钥
模型使用量	以进度条展示当前租户的模型使用量占比
重置模型使用量	重置当前租户所有用户的模型使用量

密钥安全

AI 模型 API Key、企业微信 Secret 等均为敏感信息，系统以密码框形式展示，请勿外泄。

下一步

企业微信登录 - 配置完成后启用企业微信登录
租户配置文件 - 以 JSON 形式预置更多租户配置
租户管理 - 维护租户的授权与数据库

设置项明细

以下内容面向技术实现与 AI 检索。

设置项读写

设置项统一以键值形式存储在 system_tenantsetting（实体 TenantSetting），由 TenantDevSettingCmp 组件读写：

项目	说明
读取	`GET /api/TenantSetting/GetTenantDevSettings`，返回 `Dictionary<string, string>`
保存	`POST /api/TenantSetting/EditTenantSetting`，请求体为 `{ Key, Value, IsDev }`，其中开发设置 `IsDev = true`
保存时机	表单字段变化后防抖 500ms 提交一次

设置项属性

属性名（Key）	类型	含义	取值/存储值	长度限制
`CustomDomain`	string	自定义域名	域名文本	100
`WeComCorpAppId`	string	企业微信企业 ID	文本	50
`WeComCorpAgentId`	string	企业微信应用 AgentId	文本	50
`WeComAuthSecret`	string	企业微信应用 Secret	文本	50
`WeComContactSecret`	string	企业微信通讯录 Secret	文本	50
`AiCustomModelEnable`	string	是否启用自定义 AI 模型	`"true"` / `"false"`	-
`AiModelType`	string	AI 模型类型	`OpenAiCompatible`	-
`AiModel`	string	AI 模型名称	文本	50
`AiModelEndpoint`	string	AI 模型接口地址	URL 文本	50
`AiModelApiKey`	string	AI 模型 API Key	文本（密码框）	50

字符串布尔值

设置值统一以字符串存储，布尔开关以 "true" / "false" 表示，例如 AiCustomModelEnable 的值为 "true" 时才会展示模型明细字段。

存储示例

{
  "CustomDomain": "acme.example.com",
  "WeComCorpAppId": "wwb7e36b32e01e0041",
  "WeComCorpAgentId": "1000004",
  "WeComAuthSecret": "********",
  "WeComContactSecret": "********",
  "AiCustomModelEnable": "true",
  "AiModelType": "OpenAiCompatible",
  "AiModel": "gpt-4o-mini",
  "AiModelEndpoint": "https://api.openai.com/v1",
  "AiModelApiKey": "********"
}

模型使用量接口

接口	方法	说明
`/api/Ai/TenantUsage`	GET	获取当前租户的模型使用量（数值）
`/api/Ai/ResetTenantUsage`	POST	重置当前租户所有用户的模型使用量

概述​

配置项​

域名设置​

企业微信设置​

AI 模型设置​

下一步​

设置项明细​

设置项读写​

设置项属性​

存储示例​

模型使用量接口​

概述

配置项