AgentbaseDocs
文档目录

组织与账号中心

在 Agentbase 的 账号(Account) → 组织(Organization) → 项目(Project) 三级资源治理体系中,账号中心负责开发者个人身份、多因素认证(MFA 与一次性恢复码)、活跃会话、账号级配额用量、待清理项目恢复(Restore)及表模式转换记录的统一管理;组织中心则作为企业多项目与多团队协作的顶层容器,承载项目创建、成员邀请、六级角色授权(RBAC)、组织级 30 日聚合计量以及不活跃项目的批量治理。

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

界面参考:沿用已登记的历史截图,演示数据与当前项目可能不同;本次未重新取图。

功能概述

随着企业 AI 应用规模的扩大,一个组织(如 Agentbase 企业智能中台,ID:69c6d1aa00062e6bb60)下往往同时运行着智能客服生产项目(enterprise-ai-hub-210)、算法评测沙箱项目与各业务线子项目。组织与账号中心为个人开发者和团队管理员解决以下四类核心治理问题:

治理维度开发者账号中心(/console/account)组织管理中心(/console/organization-{organization})
管理主体任何已登录的 Console 开发者本人组织成员(写操作需 Owner 或 Admin,清理与删组织仅限 Owner)
核心安全能力修改密码/邮箱、开启 MFA、绑定 3 类验证因子、生成一次性恢复码、踢出异常设备会话查看全体成员 2FA 开启状态、按角色控制项目读写边界、管理组织自定义域名
项目治理能力查看并 Restore(恢复) 待物理删除的项目、追踪项目表模式转换任务历史创建新项目、按不活跃阈值批量提交项目清理(单次最多 50 个)
用量与账单能力账号级 30 日 UTC 用量聚合、Rate limits / Quota limits 只读视图、云端支付方式组织级 30 日 UTC 用量聚合(过滤已删项目)、云端账单(Billing)与发票(Invoices)

核心概念与架构

下图展示了开发者账号、组织成员角色、项目生命周期治理(特别是组织级发起清理 → 账号中心物理清理前恢复的闭环)以及三级用量聚合之间的架构关系:

flowchart TB
    subgraph AccountCenter["开发者账号中心 (/console/account)"]
        ProfileMFA["个人资料与 MFA 安全<br/>Authenticator / Email / SMS + 一次性恢复码"]
        SessAct["Sessions 会话 & Activity 审计<br/>单设备登出 / Sign out all sessions"]
        AccUsage["账号级用量与配额<br/>Rate limits / Quota limits / 30 日 Usage"]
        AccCleanup["Project cleanup (恢复与审计台)<br/>Pending -> Purging / Purge failed<br/>物理清理前可执行 Restore"]
        TableConv["Table mode conversions<br/>共享表 / 独占表 / Shared V2 转换记录"]
    end

    subgraph OrgCenter["组织管理中心 (/console/organization-69c6d1aa00062e6bb60)"]
        OrgProjects["Projects 项目容器<br/>例如: 企业智能客服与知识中台 (enterprise-ai-hub-210)"]
        OrgMembers["Members 成员与 6 级 RBAC<br/>Owner / Admin / Developer / Editor / Billing / Analyst"]
        OrgUsage["Usage / Metering 组织聚合用量<br/>最近 30 个 UTC 日 (自动过滤删除态项目)"]
        OrgCleanup["Project cleanup (不活跃项目检索与提交)<br/>Inactive days + New project grace days<br/>达标满 24h 后列出 -> 单次最多勾选 50 个"]
    end

    ProfileMFA --> OrgMembers
    OrgCleanup -- "1. Owner 填写原因并提交批量删除" --> AccCleanup
    AccCleanup -- "2a. 物理清理开始前点击 Restore" --> OrgProjects
    AccCleanup -- "2b. 到达计划清理时间执行 Purging" --> Purged["物理彻底清除 (不可逆)"]
    OrgProjects -- "发起表模式转换" --> TableConv

组织六级角色(RBAC)权限边界详表

在 Organization → Members 中为团队成员分配角色时,该角色将直接决定成员在组织管理面以及组织下所有 Project 内的操作权限:

组织角色组织设置与成员邀请删除组织 / 不活跃项目清理项目内资源读写(DB / 知识库 / 记忆 / 网关 / 函数)项目高危操作(列删除开关)账单发票与用量观测
Owner(所有者)允许(修改组织名、邀请/移除成员、变更角色)允许(唯一可执行删组织与批量清理不活跃项目的组织角色)全部读写(含创建/查看/吊销 API Key)允许(与平台管理员共同拥有列删除开关权限)全部可见可管
Admin(管理员)允许(修改组织名、邀请/移除成员、变更角色)禁止(不可删除组织)全部读写(含创建/查看/吊销 API Key)禁止全部可见
Developer(开发者)只读查看成员列表禁止全部读写(具备 projects.write、keys.write、platforms.write 等研发权限)禁止用量与观测可见
Editor(编辑者)只读查看成员列表禁止允许读写业务数据、知识库文档、词库与配置禁止用量与观测可见
Billing(财务专员)只读查看成员列表禁止只读(无权创建或修改任何项目业务资源与密钥)禁止管理账单、发票、计划与查看用量
Analyst(分析师)只读查看成员列表禁止只读(无权创建或修改任何项目业务资源与密钥)禁止只读查看用量聚合、AgentOps 轨迹与评估报告

角色、入口与关联关系

1. 账号中心全量页签路由速查(前缀 /console/account)

点击控制台顶部导航栏右侧的 Account 入口,即可进入账号中心(如图 1 所示),顶部包含以下子页签:

页签名称浏览器路由路径核心承载内容与操作权限
Overview/console/account修改姓名、修改邮箱(需验证当前密码)、修改密码、管理外部关联身份(Identities)、配置 MFA 与一次性恢复码、永久注销账号
Sessions/console/account/sessions查看所有活跃登录会话的设备浏览器、地理位置与 IP 地址,支持单条登出或 Sign out all sessions
Activity/console/account/activity按时间倒序查看当前账号的操作审计事件流水
Organizations/console/account/organizations查看所属全部组织卡片、新建组织入口;自托管部署下可在此管理组织成员配额(Member quotas)
Payments/console/account/payments维护账号绑定的支付方式(仅云端商业化部署显示)
Rate limits / Quota limits/console/account/rate-limits · .../quota-limits只读查看当前账号适用的 API 请求速率限制(Ratelimit)与资源配额(Quota)明细
Usage / Metering/console/account/usage · .../metering账号级最近 30 个 UTC 日的四项核心计量(存储、带宽、用户数、函数执行)趋势与数据完整性状态
Project cleanup/console/account/project-cleanup查看待删除项目列表(Pending deletion)与清理审计日志(Audit log);在物理清理开始前可执行 Restore 恢复
Table mode conversions/console/account/table-mode-conversions查看账号下各项目发起的表存储模式(共享表 / 独占表 / Shared V2)转换任务进度与历史结果

2. 组织中心全量页签路由速查(前缀 /console/organization-{organization})

在顶部组织切换器中选择目标组织(如 Agentbase 企业智能中台 69c6d1aa00062e6bb60),即可通过顶部页签切换各组织治理模块:

页签名称浏览器路由路径核心承载内容与操作权限
Projects/console/organization-{organization}查看组织下全部项目列表与所在区域(Region),点击 Create project 创建新项目
Members/console/organization-{organization}/members查看成员列表(含 2FA 状态列)、按成员 ID 或邮箱搜索、邀请成员、修改角色、重发邀请或移除成员
Domains/console/organization-{organization}/domains管理组织级自定义域名(云端部署支持)
Usage / Metering.../usage · .../metering组织级最近 30 个 UTC 日用量聚合(自动过滤已处于删除态的项目,删除中项目不计入组织账单用量)
Billing / Invoices.../billing · .../invoices · .../change-plan查看云端账单明细、下载发票、变更组织订阅套餐(云端部署显示)
Project cleanup/console/organization-{organization}/project-cleanup按不活跃天数与新项目豁免天数检索闲置项目,批量勾选(最多 50 个)并填写原因提交删除
Settings/console/organization-{organization}/settings修改组织显示名称、查看成员配额卡片、执行不可逆的 Delete organization

功能详解与操作指南

1. 配置账号多因素认证(MFA)与一次性恢复码(Recovery Codes)

为保障生产环境安全,强烈建议组织内所有具备写权限的成员(特别是 Owner、Admin 与 Developer)开启 MFA,使组织成员列表中的 2FA 列全部达标:

2. 管理组织成员、邀请协作与角色调整

3. 不活跃项目批量清理(Project Cleanup)与误删恢复(Restore)

针对大型企业组织中长期积累的测试沙箱或废弃原型项目,Organization Owner 可通过两阶段安全清理机制回收资源:

第一阶段:在组织中心检索并提交不活跃项目(/console/organization-{organization}/project-cleanup)

检索参数名称含义说明防误判安全机制
Inactive days(不活跃天数)项目连续无有效业务活动的天数阈值24 小时冷静期保护:项目首次达到不活跃阈值后,必须持续满 24 小时才会出现在可清理结果列表中,防止偶发流量低谷导致误判。
New project grace days(新项目豁免天数)新建项目的保护豁免天数创建时间在该天数以内的新项目(即使暂无调用)绝不会被列入清理清单。

第二阶段:在账号中心追踪清理状态或执行误删恢复(/console/account/project-cleanup)

4. 组织设置、跨组织迁移项目与删除组织

常见问题与排障

Q1:启用 MFA 后更换了新手机,验证器 App 里的动态码没了,也收不到短信,如何登录控制台?

原因与排查步骤:

Q2:为什么我的组织角色是 Admin,却无法在组织页面执行不活跃项目清理或删除组织?

原因与排查步骤: 按照 Agentbase 的职责分离安全规范,Admin 角色拥有日常组织设置修改、邀请/管理成员以及项目内全部资源的读写权限,但**破坏性组织级治理操作(包括删除整个组织 Delete organization、批量清理不活跃项目 Project cleanup 以及开启项目级数据库列删除开关 Column deletion)严格保留给组织 Owner(及平台级管理员)**。如需执行上述操作,请联系组织 Owner 处理,或由 Owner 在 Members 页将你的角色提升为 Owner。

Q3:在组织 Project cleanup 中勾选项目提交清理后,为什么組織的 Usage 用量立刻下降了,但项目在 Account 的 Project cleanup 里还看得到?

原因与排查步骤: 这是平台的预期设计:

相关文档