AgentbaseDocs
文档目录

用户管理

截图未公开:原图可能包含账号或资源标识。

入口:项目侧栏 Auth → Users。列表与管理操作需要 users.write 权限。

用户列表

创建用户

点击 Create user 打开弹窗。所有字段均可留空:

字段校验与说明
Name最长 128 字符
Email合法邮箱格式;创建时统一转小写,且在项目内唯一(重复时返回 USER_EMAIL_ALREADY_EXISTS)
Phone必须以 + 开头并带国家码,+ 后最多 15 位数字(如 +14155552671)
Password至少 8 个字符(服务端校验 8–256 位);项目开启密码字典 / 个人信息策略后约束更严
User ID默认自动生成;可展开自定义输入:仅允许 a-z A-Z 0-9、句点、连字符、下划线,最长 36 字符,不能以特殊字符开头

成功结果:通知 "{name} has been created",并跳转到该用户详情页。创建时系统自动为用户生成一个 Email 类型的 target(填写了手机号时同时生成 SMS target),供 Messaging 使用(见下文 Targets)。

用户详情

用户详情页(/auth/user-{userId})包含六个页签:Overview / Memberships / Identities / Targets / Sessions / Activity。

Overview 卡片

卡片操作与规则
StatusBlock account 封禁 / Unblock account 解封(立即生效)。同时存在邮箱与手机号时提供 Verify 下拉:分别验证 / 取消验证 Email 与 Phone
Email输入新邮箱后点 Update 直接更换(不发送确认邮件)
Phone同上;格式要求 + 开头、+ 后最多 15 位
Password重设提示:至少 8 个字符
Labels选择或输入用户标签;仅允许字母数字字符
Preferences键值偏好,逐条编辑
User impersonation开关:允许该用户通过 Client SDK 冒充项目内其他用户。仅授予受信任的运营 / 支持账号;操作记录在发起冒充的账号下
Multi-factor authentication开关用户 MFA;已启用验证器显示 TOTP (One-time code),可 Delete authenticator 删除 TOTP 因子——该操作不可逆
Delete user永久删除用户及其全部关联数据,不可逆。确认后删除并返回用户列表

Sessions(会话)

Memberships(团队成员关系)

Identities(OAuth 身份)

Activity

批量删除风险

用户列表支持勾选批量删除,提示该操作不可逆并将永久移除所选用户及其全部数据。删除用户会同时移除其会话、memberships、identities、targets 与所属数据,不可恢复。