创建用户并分配智能体

什么时候用

需要给团队成员、外部开发者或业务系统创建访问账号时——无论是普通用户还是管理员，都从「创建用户」开始。用户创建后可以分配可访问的智能体、配置 API Key、设置模型白名单。

你需要准备

• 管理员权限（只有 admin 可以创建和管理用户）
• 用户名（同一空间内唯一）
• 符合强度要求的密码（至少 12 位，包含大写字母、小写字母、数字和特殊字符）
• （可选）手机号（全局唯一）

操作步骤

第 1 步：进入用户管理

左侧菜单 -> 用户管理。

页面以表格展示你下的所有用户。点击右上角「新增用户」按钮，进入创建表单。

第 2 步：填写用户信息

表单字段说明：

填写完成后点击「确定」。

注意：密码创建时只会在前端做强度校验，系统会再次校验。请确保密码满足所有要求。

第 3 步：分配智能体（可选但推荐）

在用户列表中找到刚创建的用户，点击右侧「更多」下拉菜单，选择「智能体」。

在弹出的「分配业务智能体」对话框中：

1. 在「选择智能体（多选）」下拉框中，勾选要分配给该用户的智能体
2. 点击「确定」保存

智能体分配是替换式操作：每次保存都会覆盖之前的分配。如果想取消所有分配，清空选择后保存即可。

第 4 步：启用/禁用用户（可选）

在用户列表中找到用户，点击右侧「更多」下拉菜单，选择「禁用」或「启用」：

• 禁用后用户无法登录、无法调用 API
• 不能禁用当前登录的账号自己

第 5 步：编辑用户（可选）

在用户列表中点击用户行右侧的「编辑」按钮，可以修改：

• 用户名
• 手机号
• 角色
• 密码（留空则不修改）
• 每日 Token 限额（仅在 Token Counter 插件启用时可见）

第 6 步：删除用户（谨慎操作）

在用户列表中找到用户，点击右侧「更多」下拉菜单，选择「删除」。

确认后用户将被永久删除，关联的 API Key 也会失效。

怎么验证成功了

1. 回到「用户管理」列表，能看到刚创建的用户
2. 点击用户的「更多」->「智能体」，确认分配的智能体正确
3. （可选）为用户创建 API Key 并测试调用（见下一章）

常见问题

创建用户返回 422「密码强度不足」

密码要求很严格：至少 12 位，且必须同时包含大写字母、小写字母、数字和特殊字符（如 !@#$%^&*）。请检查是否满足所有条件。

创建用户返回 409「用户名已存在」或「手机号已被占用」

• 用户名同一空间内不能重复
• 手机号全局不能重复（包括其他账号）
• 请更换用户名或手机号后重试

普通用户看不到分配的智能体

请确认：

1. 智能体分配已保存成功
2. 用户没有被禁用
3. 用户使用的是正确的账号登录

分配智能体时为空

先在「智能体管理」中创建智能体，再来分配。

深入

核心概念

用户角色

• 新创建的用户默认角色为「普通用户」
• 租户注册时自动创建的管理员角色为「管理员」

用户状态

权限边界

安全审计

以下操作会记录安全事件：

常见坑

1. 跨租户操作返回「用户不存在」不是「无权限」

   删除或查看其它租户的用户时，系统返回「用户不存在」，而不是「无权限」。这是安全设计——防止通过响应状态码枚举有效的用户 ID。

2. 密码规则严格且前后端双重校验

   密码要求至少 12 位且同时包含大写字母、小写字母、数字和特殊字符。不满足会返回错误。

3. 分配智能体是全量替换

   智能体分配是替换式操作。如果只是想增加一个智能体，需要先读取现有分配、合并后再保存。

排错速查

• 想了解如何为用户创建 API Key？见 管理用户 API Key
• 想了解如何配置用户模型白名单？见 配置用户模型白名单