Skip to content

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、界面及测试均为参考设计,不能视为已部署能力。

研究结论 ​

  1. 管理员不是单一超级用户,应将平台运维、组织管理、安全审计、计费运营与支持人员分权,默认最小权限,敏感操作增加审批与二次验证。
  2. 管理员控制台的主线应是 总览 → 发现异常 → 定位对象 → 评估影响 → 执行受控操作 → 验证结果 → 留存审计,而非简单堆砌设置页面。
  3. 平台治理至少区分 全局、租户、组织、工作空间、项目、运行 六类作用域;策略覆盖与继承必须可解释、可预览。
  4. 管理动作必须有明确的影响范围和执行语义:禁用账号、撤销凭证、暂停新 Run、取消已有 Run、停用 Agent、冻结租户并不等价。
  5. 配额、预算、成本估算和实际结算应分开呈现;用量统计需保留计量来源、时间窗口、计费规则版本和可能的延迟。
  6. 安全审计日志应防篡改、可查询、可导出并受独立权限控制;运行日志和审计日志是不同数据集。
  7. 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 参考导航 ​

text
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”。

mermaid
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 管理员首页布局 ​

text
[作用域] [时间范围] [全局搜索] [紧急事件]
[服务健康] [任务积压] [失败率] [成本] [待审批]
[趋势与异常]       [容量与配额]
[需要处理的事件与工单]
[近期管理变更]     [审计快捷入口]

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 审计事件契约 ​

json
{
  "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 · 技术架构与职责映射 ​

mermaid
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 与错误契约 ​

http
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。

json
{
  "error": {
    "code": "ADMIN_APPROVAL_REQUIRED",
    "message": "This operation requires independent approval.",
    "request_id": "req_123",
    "details": {"approval_policy":"high_risk_quota_change"}
  }
}

不要将内部异常、凭证、策略源代码或其他租户 ID 暴露在错误响应中。

16 · 参考数据模型与一致性 ​

sql
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 异常案例:搜索连接器成本激增 ​

  1. 预算告警显示某项目检索调用成本异常增长,管理员进入用量页面按 Run/Agent Version/工具归因。
  2. 管理员检查是否存在重试风暴、异常循环或错误的配额配置,关联 P6 工作流和 P7 资源调用记录。
  3. 若确认风险,临时限制新的高成本调用,保留已运行任务和外部副作用的可见性;必要时由项目负责人决定取消特定 Run。
  4. 形成工单,记录策略变更、审批、影响范围和恢复条件。
  5. 修复后逐步解除限制,观察指标并完成复盘。

17.3 异常案例:凭证泄漏 ​

安全管理员撤销连接凭证、停止受影响工具的新调用、轮换密钥、定位受影响工作空间、查询审计事件,并通知相关责任人。不能仅在 UI 中隐藏凭证而继续允许后端调用。

18 · 分阶段开发路线 ​

阶段优先交付验收重点
M0 单人内部使用Run 总览、错误列表、手动配额、审计基础真实运行状态可定位
M1 小团队用户邀请、工作空间角色、项目预算、受控取消权限边界和成本可见
M2 多租户租户作用域、对象级授权、审计查询、配额模板无跨租户泄漏
M3 生产运营告警、审批、事件处置、容量和备份管理故障可恢复且可追责
M4 平台生态SSO/SCIM、复杂策略、账单、支持工单管理复杂度可控

建议 Studio 首先实现 M0 - M1,而非为未来的 Marketplace 提前构建完整后台。

19 · 产品指标与可用性评价 ​

目标指标注意事项
发现异常平均发现时间 MTTD按严重级别分层
恢复服务平均恢复时间 MTTR排除等待第三方的时间需明确口径
权限正确越权请求拦截率、误拒率需要独立测试集与审计核对
成本可控超预算事件数、预测偏差价格和计量延迟影响指标
管理效率常见任务完成时间、操作错误率需真实管理员参与测试
可追溯高风险操作审计覆盖率记录存在不代表内容完整
稳定性管理操作失败/部分成功比例不可把重试计为新操作

可用性测试任务:邀请成员、撤销 API Key、为项目临时提额、定位失败 Run、查看审批依据、导出审计记录。记录成功率、误操作、理解偏差和恢复成本。

20 · 风险、权衡与适用边界 ​

  1. 超级管理员过度授权:运维便利与数据最小化之间存在张力;通过分权、临时授权与审批降低风险。
  2. 治理服务成为单点故障:高风险动作默认拒绝,但须设计明确的灾难恢复与 break-glass 流程。
  3. 指标延迟:成本、运行状态和审计数据可能采用不同一致性模型,界面必须提示延迟。
  4. 批量操作误伤:对象数量多时需要预览、分批、限速与恢复计划。
  5. 隐私与排障冲突:支持人员可见性应最小化,避免默认读取任务正文。
  6. 管理员功能与普通功能重复:F12 负责平台级监督,F5/F8/F9 负责业务级操作;可共享组件但应保留权限边界。
  7. 供应商差异:模型用量、工具调用与账单事件无法保证统一精度,必须标注估算。
  8. 紧急处置并非完全可逆:撤销凭证、取消任务、停用服务可能无法回滚已经产生的外部副作用。

21 · 工程验证与产品验收矩阵 ​

以下均为待执行测试设计,不代表已经验证。测试至少覆盖不同角色、不同租户、并发修改、故障注入和部分成功场景。

ID测试场景预期结果
T01普通成员打开管理员入口拒绝或隐藏,并在后端拒绝
T02租户管理员读取其他租户成员403/404 且无数据泄漏
T03审计员尝试修改配额被拒绝
T04安全管理员撤销密钥后续调用不可使用已撤销凭证
T05角色权限变更后旧会话继续请求按新权限重新评估
T06管理员自我审批高风险操作拒绝
T07审批后变更操作参数审批失效,要求重新审批
T08策略发布发生版本冲突返回冲突并保护新版本
T09策略模拟与真实请求差异记录并解释差异
T10配额临时提升到期自动恢复基准限制
T11并发配额请求竞争不超发或按明确误差上限处理
T12预算计量延迟UI 显示估算/待对账状态
T13多租户成本查询只返回授权范围数据
T14取消 Run 时外部工具已调用提示无法撤销既有副作用
T15Worker 失联后重试防止重复非幂等副作用
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 产品标准。

  1. NIST. Digital Identity Guidelines, SP 800-63. pages.nist.gov/800-63-4
  2. 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
  3. NIST. Zero Trust Architecture, SP 800-207. csrc.nist.gov/pubs/sp/800/207/final
  4. OWASP. Application Security Verification Standard. owasp.org/www-project-application-security-verification-standard
  5. Open Policy Agent. Policy Language and Management. www.openpolicyagent.org/docs/latest
  6. OpenTelemetry. Documentation. opentelemetry.io/docs
  7. PostgreSQL. Row Security Policies. www.postgresql.org/docs/current/ddl-rowsecurity.html
  8. Kubernetes. Role Based Access Control. kubernetes.io/docs/reference/access-authn-authz/rbac
  9. Kubernetes. Resource Quotas. kubernetes.io/docs/concepts/policy/resource-quotas
  10. OAuth 2.0 Authorization Framework, RFC 6749. www.rfc-editor.org/rfc/rfc6749
  11. OAuth 2.0 Security Best Current Practice, RFC 9700. www.rfc-editor.org/rfc/rfc9700
  12. SCIM Protocol, RFC 7644. www.rfc-editor.org/rfc/rfc7644
  13. OpenAPI Specification. spec.openapis.org/oas/latest.html
  14. AWS. AWS Well-Architected Framework. docs.aws.amazon.com/wellarchitected/latest/framework/welcome.html
  15. 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。