F12 · 管理员如何管理整个平台? - Platform Administration
所属知识库:Agent 全栈技术地图
所属领域:04 · Agent Platform
所属章节:03 · Agent Platform 应该提供哪些产品功能? - Product Architecture
文档类型:专题研究 / 产品架构 / 管理控制台参考设计
版本:v1.3
更新日期:2026 年 11 月 1 日
核心问题:管理员如何通过统一而分权的控制台管理 Agent Platform 的组织、用户、资源、权限、运行、成本、安全与维护,并在高风险操作中实现可审计、可恢复的治理?
专题导读
本篇属 Product Architecture。F12 是 Product Architecture 的管理员视角终篇。P12 Platform Governance 研究策略、配额与执行点等技术机制;F12 研究管理员看到什么、能够做什么、操作产生何种影响、如何确认与追责。本篇也与 F5 Workspace & Project Management、F8 Agent Monitoring、F9 Agent Management、F11 Developer Experience 形成产品分工:管理员控制台不应重复所有业务操作,而应聚焦跨工作空间的配置、监督、例外处置和平台级维护。
本文使用 [规范] 表示来自正式规范的原则,[产品观察] 表示公开产品中的可借鉴做法,[参考设计] 表示本文针对 Studio 提出的尚未实施方案。所有 API、SQL、界面及测试均为参考设计,不能视为已部署能力。
研究结论
- 管理员不是单一超级用户,应将平台运维、组织管理、安全审计、计费运营与支持人员分权,默认最小权限,敏感操作增加审批与二次验证。
- 管理员控制台的主线应是 总览 → 发现异常 → 定位对象 → 评估影响 → 执行受控操作 → 验证结果 → 留存审计,而非简单堆砌设置页面。
- 平台治理至少区分 全局、租户、组织、工作空间、项目、运行 六类作用域;策略覆盖与继承必须可解释、可预览。
- 管理动作必须有明确的影响范围和执行语义:禁用账号、撤销凭证、暂停新 Run、取消已有 Run、停用 Agent、冻结租户并不等价。
- 配额、预算、成本估算和实际结算应分开呈现;用量统计需保留计量来源、时间窗口、计费规则版本和可能的延迟。
- 安全审计日志应防篡改、可查询、可导出并受独立权限控制;运行日志和审计日志是不同数据集。
- Studio 初期优先实现用户与角色、项目配额、运行总览、成本统计、异常处置、审计日志,不必一开始建设完整企业级 IAM 或计费平台。
01 · 概念、角色与产品边界
1.1 管理的对象
平台管理员管理的是平台级资源与风险:身份、组织、租户、策略、执行容量、成本、服务状态、审计与维护。业务项目负责人负责具体项目内容与交付;开发者负责 API 集成;Agent 所有者负责 Agent 版本。管理控制台应允许跨对象导航,但不应默认赋予管理员阅读全部私有 Prompt、知识内容或用户产物的权限。
1.2 管理员角色矩阵
| 角色 | 常见职责 | 默认不应拥有的能力 |
|---|---|---|
| Platform Operator | 服务健康、容量、队列、故障恢复 | 任意读取租户私有内容 |
| Tenant Admin | 本租户成员、工作空间、预算、策略 | 跨租户数据访问 |
| Security Admin | 身份策略、密钥撤销、安全事件 | 无审批修改计费数据 |
| Billing Admin | 用量、价格、账单、预算 | 读取任务正文及凭证 |
| Auditor | 只读审计、导出合规证据 | 更改策略、删除日志 |
| Support Operator | 有限故障排查、工单 | 默认代入用户身份 |
角色应由权限集合定义,以上名称仅为产品建议;实际权限必须细化到 action + resource + scope + condition。
02 · 用户任务、信息架构与导航
2.1 管理员主要任务
管理员日常任务包括开通组织、邀请成员、调整权限、处理配额超限、发现故障、撤销泄漏凭证、审核敏感操作、查询用量、执行维护、核对审计。紧急任务包括租户冻结、隔离失控执行器、暂停外部调用、恢复服务和保全证据。
2.2 参考导航
Administration
├── Overview / 管理总览
├── Organizations & Tenants / 组织与租户
├── Identity & Access / 用户、角色、会话与服务身份
├── Agents & Workflows / 全局资产治理
├── Runtime Operations / Run、Worker、队列与容量
├── Resources & Integrations / 模型、连接器与凭证状态
├── Policies & Approvals / 策略、审批与例外
├── Usage, Quotas & Budgets / 用量、配额、预算
├── Security & Audit / 安全事件与审计
├── Platform Settings / 全局配置与功能开关
└── Maintenance & Support / 维护、备份、工单跨页面保持作用域选择器(平台/租户/工作空间)、时间范围、过滤条件和操作追踪 ID。危险操作必须展示影响对象数和预计结果。
03 · 管理对象与关系模型
平台产品对象必须与 P1 - P2 - P3 - P4 - P5 - P6 - P7 - P8 - P9 - P10 - P11 - P12 技术对象一致:Tenant、Organization、Workspace、Project、User、Membership、Role、Policy、Quota、Budget、Approval、Agent Version、Deployment、Run、Resource Connection、Audit Event。不要另造一个与 Registry 冲突的“管理员版 Agent”。
erDiagram
TENANT ||--o{ WORKSPACE : owns
TENANT ||--o{ MEMBERSHIP : grants
USER ||--o{ MEMBERSHIP : joins
ROLE ||--o{ MEMBERSHIP : assigned
TENANT ||--o{ POLICY_BINDING : scoped
TENANT ||--o{ QUOTA : constrained
TENANT ||--o{ BUDGET : charged
WORKSPACE ||--o{ PROJECT : contains
PROJECT ||--o{ RUN : launches
RUN ||--o{ USAGE_EVENT : meters
USER ||--o{ ADMIN_ACTION : initiates
ADMIN_ACTION ||--o{ AUDIT_EVENT : recorded管理控制台以可授权的操作为核心,后端执行应由原业务服务承担;管理员前端不得直接写 Registry、运行数据库或对象存储。
04 · 管理总览与运营仪表盘
4.1 总览卡片
展示活跃租户、活跃工作空间、进行中/排队/失败 Run、执行队列延迟、模型错误率、工具错误率、Token 用量、估算成本、预算超限和待审批数。指标必须标明时间窗口、数据延迟与统计口径。
4.2 从指标到行动
异常卡片可下钻到租户、Run、Step、Attempt、模型调用和工具调用。每个异常页面同时提供原因证据、影响范围、建议操作及相应权限校验。不得将“错误率升高”直接推断为某一模型供应商故障。
4.3 管理员首页布局
[作用域] [时间范围] [全局搜索] [紧急事件]
[服务健康] [任务积压] [失败率] [成本] [待审批]
[趋势与异常] [容量与配额]
[需要处理的事件与工单]
[近期管理变更] [审计快捷入口]05 · 租户、组织、用户与身份管理
5.1 生命周期
租户:申请/创建 → 配置 → 激活 → 运行 → 限制/冻结 → 恢复或退役。用户:邀请 → 接受 → 加入组织 → 角色变更 → 停用 → 离开。删除须考虑审计保留、账单和数据归属。
5.2 身份功能
管理员应能邀请、批量导入(可选)、调整成员角色、撤销会话、停用账号、管理服务账号和查看最近登录。SSO、SCIM 与 MFA 可在企业阶段加入;不能仅凭前端按钮显示实现身份控制。
5.3 高风险身份操作
禁用用户前显示其拥有的 Agent、活跃 Run、审批任务和服务连接;转移所有权应采用显式流程。支持人员“代入用户”应尽量避免,必要时使用限时、审批、全程审计的受限诊断会话,且明确用户可见性。
06 · 角色、权限与策略配置
6.1 策略产品模型
Policy Definition 表达规则,Policy Binding 表达作用域,Decision 表达一次评估结果,Enforcement 由服务端完成。控制台应展示策略来源、继承关系、冲突解决顺序与最后修改人。
6.2 权限预览
提供“以某用户在某作用域对某对象执行某操作”的权限模拟器,输出允许/拒绝、命中规则、缺少条件与策略版本。模拟仅为诊断,不能替代实际请求时的服务端授权。
6.3 策略发布
策略草稿 → 静态校验 → 影响分析 → 审批 → 小范围启用 → 观察 → 全量生效/回滚。对权限扩大、预算提升、跨租户共享、审计保留缩短等操作设置双人审批。
07 · 配额、预算与计量管理
7.1 三类边界
| 类型 | 示例 | 主要动作 |
|---|---|---|
| Rate Limit | 每分钟请求数 | 429、等待或限速 |
| Quota | 并发 Run、存储容量、月 Token | 拒绝新分配或排队 |
| Budget | 月度估算成本、项目预算 | 告警、审批或阻止新任务 |
7.2 产品操作
配置配额模板、覆盖范围、有效期、例外申请、剩余额度和使用曲线。预算页区分预估、预留、实际、待对账;模型价格变更、缓存折扣、第三方计费延迟均可能影响数值。
7.3 资源公平性
展示每租户排队时长、并发占用和被拒绝次数;管理员可调整优先级,但不能无记录地越过公平调度策略。紧急提额应有到期时间和审批原因。
08 · Agent、Workflow 与部署治理
管理员需要跨项目查找存在安全风险、已撤销、长期未使用或依赖失效的 Agent/Workflow。具体内容编辑仍由 F2、F3、F9 承担。
全局操作包括停用发布渠道、阻止新部署、撤销高危工具绑定、查询依赖影响、查看版本来源。对于“停用 Agent”,界面必须区分阻止新 Run、终止进行中 Run、禁用部署和撤销版本四种影响。
升级前应显示依赖工作流数量、活跃 Run 数、测试结果、版本锁定与回滚方案。已开始的 Run 默认固定版本,不因管理员切换渠道而静默升级。
09 · 运行运维与故障处置
9.1 运维视图
Run 队列、Worker 池、健康状态、租约、重试、死信队列、模型和工具错误率、检查点、SSE 连接及事件延迟。提供按租户、项目、部署、Agent Version 和时间范围筛选。
9.2 受控操作
| 操作 | 前置条件 | 结果与风险 |
|---|---|---|
| 暂停新任务接入 | 平台运维权限 | 仅阻止新任务,不保证现有任务停止 |
| 暂停队列调度 | 执行面支持 | 已运行任务可能继续执行 |
| 取消指定 Run | 对象授权、确认 | 可能已有不可撤销外部副作用 |
| 重试失败 Attempt | 幂等与重试策略 | 不应默认重放非幂等操作 |
| 隔离 Worker | 运维权限、容量评估 | 可能触发租约回收与重试 |
| 切换模型供应商 | 兼容性与策略检查 | 输出质量和成本可能改变 |
9.3 事件处置
检测 → 分类 → 限制影响 → 保全证据 → 恢复 → 复盘。每个操作记录事件编号、操作者、原因、目标作用域和结果。
10 · 模型、工具、连接器与平台资源管理
资源管理员应看到模型供应商连接状态、模型可用性、地区与数据策略、工具健康、连接凭证到期、调用失败和限流。凭证页面仅允许创建、轮换、撤销和查看元数据,不回显明文秘密。
连接器禁用时展示受影响的 Agent、Workflow、Run 和 Workspace;运行时授权仍由 Resource Gateway 负责。平台可以将连接配置与凭证分离,并通过凭证引用进行轮换。跨租户共享连接器时不得自动共享其私有凭证。
11 · 安全事件、审批与审计
11.1 审批队列
待审批项应显示请求人、动作、目标、参数摘要、风险级别、理由、到期时间和影响范围。审批应绑定不可变的操作摘要;参数变化后需重新审批。审批人不得审批自己发起的高风险操作。
11.2 审计事件契约
{
"event_id": "evt_01J...",
"occurred_at": "2026-11-01T08:00:00Z",
"actor": {"type":"user","id":"usr_123"},
"action": "quota.override.create",
"resource": {"type":"tenant","id":"ten_123"},
"scope": {"tenant_id":"ten_123"},
"request_id": "req_123",
"approval_id": "apr_123",
"policy_version": "pol_v4",
"before": {"concurrent_runs": 10},
"after": {"concurrent_runs": 20},
"result": "succeeded",
"reason": "approved_capacity_increase"
}审计记录必须脱敏,避免包含 Token、Prompt 正文或敏感文件内容。写入失败时高风险管理操作应遵循明确的失败策略,不可静默跳过。
12 · 平台配置、变更与维护
12.1 配置分层
平台默认值、租户配置、工作空间覆盖、项目运行参数须有可见的优先级和锁定规则。功能开关应记录环境、作用域、发布时间、操作者和回滚点。
12.2 维护中心
包含计划维护公告、只读模式、任务接入开关、备份状态、恢复演练结果、数据保留、队列排空和版本升级。平台升级应有预检查、兼容性测试、灰度、观察和回滚步骤。
12.3 删除与保留
区分逻辑删除、权限撤销、保留期届满、物理清理和备份过期。管理员界面必须明确删除无法保证已导出副本被召回。
13 · 管理操作的交互与防误操作
高风险操作使用分级确认:普通配置可直接保存;影响多项目的操作需展示影响分析;不可逆或大规模操作需二次确认、原因、审批和可验证的执行结果。不要将所有操作都设计为同样的确认弹窗。
异步管理操作返回 Operation ID,展示 requested → validating → approved → executing → succeeded / failed / partially_succeeded。部分成功时提供对象级结果和安全重试建议。批量操作支持预览、过滤和导出结果,避免“全选”误操作。
14 · 技术架构与职责映射
flowchart TB
UI[Admin Console] --> API[Administration API]
API --> IAM[Identity & Access]
API --> GOV[Policy / Quota / Budget]
API --> OPS[Operations Service]
API --> RES[Resource Management]
API --> AUD[Audit Service]
GOV --> CP[Control Plane]
GOV --> EP[Execution Plane]
GOV --> RG[Resource Gateway]
OPS --> CP
OPS --> EP
CP --> DB[(PostgreSQL)]
EP --> QUEUE[(Durable Queue)]
AUD --> LOG[(Append-only Audit Store)]管理控制台通过服务 API 提交管理命令,执行服务负责事务与状态变更;长任务采用异步 Operation。策略在各服务端强制执行。管理操作与普通业务请求使用相同的身份与追踪体系,但保留独立审计记录。
15 · 参考 API 与错误契约
GET /v1/admin/overview?scope=tenant&tenant_id=ten_123
GET /v1/admin/tenants?cursor=...
GET /v1/admin/tenants/ten_123/members
POST /v1/admin/tenants/ten_123/members/invitations
PATCH /v1/admin/memberships/mem_123
GET /v1/admin/policies/effective?subject=usr_123&action=run.create&resource=prj_123
POST /v1/admin/quotas/overrides
GET /v1/admin/usage?tenant_id=ten_123&from=...&to=...
POST /v1/admin/runs/run_123/cancel
POST /v1/admin/operations/op_123/approve
GET /v1/admin/operations/op_123
GET /v1/admin/audit-events?cursor=...所有写接口要求服务端授权、对象级范围检查、请求 ID 和幂等机制。版本冲突使用 ETag/If-Match 或显式 revision。批量操作异步返回 202 Accepted 与操作 ID。
{
"error": {
"code": "ADMIN_APPROVAL_REQUIRED",
"message": "This operation requires independent approval.",
"request_id": "req_123",
"details": {"approval_policy":"high_risk_quota_change"}
}
}不要将内部异常、凭证、策略源代码或其他租户 ID 暴露在错误响应中。
16 · 参考数据模型与一致性
CREATE TABLE admin_operations (
id UUID PRIMARY KEY,
tenant_id UUID,
actor_id UUID NOT NULL,
action TEXT NOT NULL,
resource_type TEXT NOT NULL,
resource_id TEXT NOT NULL,
request_hash TEXT NOT NULL,
idempotency_key TEXT,
status TEXT NOT NULL,
approval_id UUID,
reason TEXT,
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
);
CREATE UNIQUE INDEX admin_ops_idempotency
ON admin_operations(actor_id, action, idempotency_key)
WHERE idempotency_key IS NOT NULL;
CREATE TABLE audit_events (
id UUID PRIMARY KEY,
operation_id UUID REFERENCES admin_operations(id),
tenant_id UUID,
actor_id UUID,
action TEXT NOT NULL,
resource_type TEXT NOT NULL,
resource_id TEXT NOT NULL,
result TEXT NOT NULL,
payload JSONB NOT NULL,
occurred_at TIMESTAMPTZ NOT NULL DEFAULT now()
);
CREATE INDEX audit_events_scope_time
ON audit_events(tenant_id, occurred_at DESC);此 DDL 仅为教学骨架:生产系统还需数据库级隔离、事件不可篡改方案、保留分区、密钥管理、审计写入可靠性和审批对象表。管理员操作与审计写入若跨存储系统,应考虑事务性 outbox 与最终一致性;不应宣称单条 SQL 能保证端到端原子性。
17 · Studio 场景:从日常运营到事故处理
17.1 日常管理
Studio 平台管理员创建研究组织,邀请研究员,为“Agent 技术地图”工作空间配置项目预算与最大并发数;成员在 F5 创建项目、在 F1 - F2 - F3 - F4 构建 Agent、在 F6 - F7 启动工作流。管理员在总览页观察运行情况,在 F8 下钻到异常 Run,并在 F10 查看交付统计,但不默认读取研究草稿正文。
17.2 异常案例:搜索连接器成本激增
- 预算告警显示某项目检索调用成本异常增长,管理员进入用量页面按 Run/Agent Version/工具归因。
- 管理员检查是否存在重试风暴、异常循环或错误的配额配置,关联 P6 工作流和 P7 资源调用记录。
- 若确认风险,临时限制新的高成本调用,保留已运行任务和外部副作用的可见性;必要时由项目负责人决定取消特定 Run。
- 形成工单,记录策略变更、审批、影响范围和恢复条件。
- 修复后逐步解除限制,观察指标并完成复盘。
17.3 异常案例:凭证泄漏
安全管理员撤销连接凭证、停止受影响工具的新调用、轮换密钥、定位受影响工作空间、查询审计事件,并通知相关责任人。不能仅在 UI 中隐藏凭证而继续允许后端调用。
18 · 分阶段开发路线
| 阶段 | 优先交付 | 验收重点 |
|---|---|---|
| M0 单人内部使用 | Run 总览、错误列表、手动配额、审计基础 | 真实运行状态可定位 |
| M1 小团队 | 用户邀请、工作空间角色、项目预算、受控取消 | 权限边界和成本可见 |
| M2 多租户 | 租户作用域、对象级授权、审计查询、配额模板 | 无跨租户泄漏 |
| M3 生产运营 | 告警、审批、事件处置、容量和备份管理 | 故障可恢复且可追责 |
| M4 平台生态 | SSO/SCIM、复杂策略、账单、支持工单 | 管理复杂度可控 |
建议 Studio 首先实现 M0 - M1,而非为未来的 Marketplace 提前构建完整后台。
19 · 产品指标与可用性评价
| 目标 | 指标 | 注意事项 |
|---|---|---|
| 发现异常 | 平均发现时间 MTTD | 按严重级别分层 |
| 恢复服务 | 平均恢复时间 MTTR | 排除等待第三方的时间需明确口径 |
| 权限正确 | 越权请求拦截率、误拒率 | 需要独立测试集与审计核对 |
| 成本可控 | 超预算事件数、预测偏差 | 价格和计量延迟影响指标 |
| 管理效率 | 常见任务完成时间、操作错误率 | 需真实管理员参与测试 |
| 可追溯 | 高风险操作审计覆盖率 | 记录存在不代表内容完整 |
| 稳定性 | 管理操作失败/部分成功比例 | 不可把重试计为新操作 |
可用性测试任务:邀请成员、撤销 API Key、为项目临时提额、定位失败 Run、查看审批依据、导出审计记录。记录成功率、误操作、理解偏差和恢复成本。
20 · 风险、权衡与适用边界
- 超级管理员过度授权:运维便利与数据最小化之间存在张力;通过分权、临时授权与审批降低风险。
- 治理服务成为单点故障:高风险动作默认拒绝,但须设计明确的灾难恢复与 break-glass 流程。
- 指标延迟:成本、运行状态和审计数据可能采用不同一致性模型,界面必须提示延迟。
- 批量操作误伤:对象数量多时需要预览、分批、限速与恢复计划。
- 隐私与排障冲突:支持人员可见性应最小化,避免默认读取任务正文。
- 管理员功能与普通功能重复:F12 负责平台级监督,F5/F8/F9 负责业务级操作;可共享组件但应保留权限边界。
- 供应商差异:模型用量、工具调用与账单事件无法保证统一精度,必须标注估算。
- 紧急处置并非完全可逆:撤销凭证、取消任务、停用服务可能无法回滚已经产生的外部副作用。
21 · 工程验证与产品验收矩阵
以下均为待执行测试设计,不代表已经验证。测试至少覆盖不同角色、不同租户、并发修改、故障注入和部分成功场景。
| ID | 测试场景 | 预期结果 |
|---|---|---|
| T01 | 普通成员打开管理员入口 | 拒绝或隐藏,并在后端拒绝 |
| T02 | 租户管理员读取其他租户成员 | 403/404 且无数据泄漏 |
| T03 | 审计员尝试修改配额 | 被拒绝 |
| T04 | 安全管理员撤销密钥 | 后续调用不可使用已撤销凭证 |
| T05 | 角色权限变更后旧会话继续请求 | 按新权限重新评估 |
| T06 | 管理员自我审批高风险操作 | 拒绝 |
| T07 | 审批后变更操作参数 | 审批失效,要求重新审批 |
| T08 | 策略发布发生版本冲突 | 返回冲突并保护新版本 |
| T09 | 策略模拟与真实请求差异 | 记录并解释差异 |
| T10 | 配额临时提升到期 | 自动恢复基准限制 |
| T11 | 并发配额请求竞争 | 不超发或按明确误差上限处理 |
| T12 | 预算计量延迟 | UI 显示估算/待对账状态 |
| T13 | 多租户成本查询 | 只返回授权范围数据 |
| T14 | 取消 Run 时外部工具已调用 | 提示无法撤销既有副作用 |
| T15 | Worker 失联后重试 | 防止重复非幂等副作用 |
| T16 | 停用 Agent 存在活跃 Run | 展示影响并遵循明确策略 |
| T17 | 连接器凭证轮换 | 新旧凭证过渡和撤销可验证 |
| T18 | 批量停用部分失败 | 展示逐项结果并允许安全重试 |
| T19 | 管理操作重复提交 | 幂等返回同一 Operation |
| T20 | 审计存储不可用 | 高风险操作按失败策略处理 |
| T21 | 审计日志包含敏感字段 | 脱敏或阻止写入 |
| T22 | 支持人员请求读取私有产物 | 默认拒绝,需独立授权 |
| T23 | 备份恢复演练 | 数据和权限恢复符合目标 |
| T24 | 平台维护暂停接入 | 新 Run 被阻止,既有 Run 状态正确 |
| T25 | 队列恢复后大量积压 | 受配额、公平性和容量约束 |
| T26 | 告警重复与恢复 | 去重、确认、恢复状态正确 |
| T27 | 管理员变更作用域 | 页面和 API 不串租户上下文 |
| T28 | 批量导出审计 | 权限、范围、脱敏与水印/日志正确 |
| T29 | 删除有保留义务的租户 | 阻止非法清理并解释原因 |
| T30 | 管理控制台网络断开 | 不误报操作成功,支持查询最终状态 |
| T31 | 平台全局策略与租户策略冲突 | 冲突规则可解释且符合安全要求 |
| T32 | 受限账户访问系统指标 | 不暴露其他租户身份和内容 |
| T33 | 变更生产发布渠道 | 既有 Run 版本保持固定 |
| T34 | 紧急冻结租户 | 新操作被拒绝,保留必要审计 |
| T35 | 恢复冻结租户 | 授权、预算和连接器状态重新校验 |
| T36 | 跨时区审计查询 | UTC 存储、时区展示与筛选正确 |
| T37 | 费用价格表变更 | 历史账本按对应规则版本解释 |
| T38 | 管理员浏览器重复点击危险按钮 | 不产生重复副作用 |
| T39 | 操作中管理员权限被撤销 | 执行前重新授权或按预定契约中止 |
| T40 | 平台管理员误选租户 | 二次确认展示清晰租户身份 |
验收必须有可复现步骤、测试环境、数据样本、实际结果、责任人和问题记录;仅有上述矩阵不构成验收完成。
附录 A:参考文献与原始资料
以下资料为技术规范与官方产品文档的参考入口。它们分别支持身份管理、策略、审计、监控、计量和运维设计,不直接规定一个统一的 Agent Platform Administration 产品标准。
- NIST. Digital Identity Guidelines, SP 800-63. pages.nist.gov/800-63-4
- NIST. Security and Privacy Controls for Information Systems and Organizations, SP 800-53 Rev. 5. csrc.nist.gov/pubs/sp/800/53/r5/upd1/final
- NIST. Zero Trust Architecture, SP 800-207. csrc.nist.gov/pubs/sp/800/207/final
- OWASP. Application Security Verification Standard. owasp.org/www-project-application-security-verification-standard
- Open Policy Agent. Policy Language and Management. www.openpolicyagent.org/docs/latest
- OpenTelemetry. Documentation. opentelemetry.io/docs
- PostgreSQL. Row Security Policies. www.postgresql.org/docs/current/ddl-rowsecurity.html
- Kubernetes. Role Based Access Control. kubernetes.io/docs/reference/access-authn-authz/rbac
- Kubernetes. Resource Quotas. kubernetes.io/docs/concepts/policy/resource-quotas
- OAuth 2.0 Authorization Framework, RFC 6749. www.rfc-editor.org/rfc/rfc6749
- OAuth 2.0 Security Best Current Practice, RFC 9700. www.rfc-editor.org/rfc/rfc9700
- SCIM Protocol, RFC 7644. www.rfc-editor.org/rfc/rfc7644
- OpenAPI Specification. spec.openapis.org/oas/latest.html
- AWS. AWS Well-Architected Framework. docs.aws.amazon.com/wellarchitected/latest/framework/welcome.html
- Google. Site Reliability Engineering. sre.google/books
证据解释:NIST/OWASP/OAuth/SCIM 等可为安全控制提供规范依据;Kubernetes、OPA、OpenTelemetry 和 PostgreSQL 文档提供可借鉴的工程机制;Studio 的导航结构、权限角色、API 和数据表是本文参考设计,不应误写为这些标准的强制要求。
附录 B:研究证据、验证声明与适用边界
研究性质:基于已知软件工程原则、公开标准与 Agent Platform 前序 P1 - P2 - P3 - P4 - P5 - P6 - P7 - P8 - P9 - P10 - P11 - P12、F1 - F2 - F3 - F4 - F5 - F6 - F7 - F8 - F9 - F10 - F11 的概念体系所作的产品架构研究。
已确认的规范层面:身份与访问控制、最小权限、审计、API 契约等有可查的正式规范或官方文档;本文未逐条完成规范条款映射,因此不能声称完全符合某项合规认证。
参考设计层面:角色划分、管理员控制台 IA、操作状态机、Studio 路线、API、SQL、告警与测试矩阵是建议方案,需依据具体团队规模、法规、业务风险和技术栈修订。
尚未测试:未完成真实系统部署、负载测试、渗透测试、故障注入、管理员可用性测试、跨租户隔离验证或灾难恢复演练。
关键边界:本文研究产品层的 Platform Administration,不替代 P12 的治理策略引擎、P11 的租户隔离实现、P5 的部署运行机制,也不替代企业法务与合规评估。
后续研究:04 · Agent Platform / 04 · 如何开发、部署和维护 Agent Platform? - Engineering & Practice(章节概述),随后进入 01 · 有哪些值得研究的 Agent Platform? - Platform Case Studies。