多租户管理
多租户管理
欣悦互通采用多租户架构，支持一套系统服务多个独立客户（租户）。每个租户拥有独立的数据空间、用户体系、配置和品牌定制，互不干扰。
本篇介绍租户管理、域名配置、系统设置和 Agent 管理四部分内容。
多租户概念
多租户架构的核心是「数据隔离」与「独立配置」：
- 数据隔离：每个租户的用户、项目、内容、订单等数据完全独立，A 租户无法访问 B 租户的数据。
- 独立配置：每个租户可独立配置 AI 供应商、品牌信息、套餐方案、计费规则等。
- 独立计费：每个租户独立订阅套餐、独立计量用量、独立结算费用。
平台管理员（超管）可创建和管理所有租户；租户管理员只能管理自己租户内的资源。
!NOTE 多租户隔离通过中间件在请求层面自动完成，每次请求会携带租户标识，数据库查询自动附加租户过滤条件，无需业务代码关心。
租户管理
查看租户列表
- 以平台管理员身份登录，进入「系统管理 → 租户管理」。
- 列表展示所有租户的名称、联系人、套餐、状态、创建时间。
- 支持按租户名称、状态搜索筛选。
租户列表通过 GET /api/system/tenants 获取。
创建租户
- 在租户列表页点击「新增」按钮。
- 填写租户基本信息：
- 租户名称（必填）
- 联系人姓名
- 联系邮箱（必填）
- 联系电话
- 套餐方案
- 到期时间
- 点击「确定」保存。
系统调用 POST /api/system/tenants 创建租户，同时初始化该租户的管理员账号和默认配置。
!NOTE 新建租户时，管理员初始密码由系统随机生成并通过邮件发送至联系邮箱，不再使用固定密码
admin123，以提升安全性。
查看和更新租户
- 点击租户名称或「详情」查看租户完整信息。
- 点击「编辑」修改租户信息、套餐、状态（启用/禁用）。
- 禁用租户后，该租户下所有用户将无法登录。
租户详情和更新通过 GET/PUT /api/system/tenants/{id} 操作。
!WARNING 禁用租户是即时生效的，所有该租户的在线用户会被强制下线。如需临时停用某租户，建议提前通知其管理员。
租户域名管理
每个租户可绑定独立域名，实现品牌定制访问入口。
- 在租户详情页切换到「域名管理」标签。
- 点击「新增域名」填写要绑定的域名。
- 在域名服务商处添加 CNAME 解析记录指向欣悦互通的服务地址。
- 系统自动校验解析状态，校验通过后域名生效。
域名生效后，用户通过该域名访问时，系统会自动识别对应租户并加载其品牌配置（Logo、主题色、页面文案等）。
!TIP 域名需提前完成 ICP 备案和 SSL 证书配置。平台支持自动申请 Let's Encrypt 免费证书，详情联系技术支持。
系统设置
系统设置用于管理租户级别的全局配置，包括：
- 品牌信息（名称、Logo、主题色）
- AI 供应商配置（API Key、模型选择）
- 短信和邮件网关配置
- 文件存储配置（S3 或本地）
- 速率限制参数
- 进入「系统管理 → 系统设置」。
- 切换不同配置分类标签进行编辑。
- 修改后点击「保存」生效。
系统设置通过 GET/PUT /api/system/settings 读写，配置变更即时生效，无需重启服务。
!WARNING 修改 AI 供应商配置或存储配置可能影响正在进行的任务，建议在业务低峰期调整，并提前测试新配置是否可用。
Agent 管理
Agent 是 AAO 自动化体系的核心执行单元，可在「系统管理 → Agent 管理」中维护租户级 Agent。
- 进入 Agent 列表页查看当前租户的所有 Agent。
- 点击「新增」创建 Agent，填写：名称、描述、关联模型、系统 Prompt。
- 点击「编辑」修改 Agent 配置，或「删除」移除 Agent。
Agent 管理通过 GET/POST /api/agents、GET/PUT/DELETE /api/agents/{id} 操作。Agent 创建后可在 AAO 工作流、团队协作、AI 对话等场景中调用。
!NOTE Agent 的详细使用请参考 AAO 自动化 分类文档。