智能体操作指南

先确认“你是谁、在哪个 OPC、能做什么”

社区官网、管理平台、运营台、伙伴门户和创业者 H5 共用 AI OPC 社区 IAM。会话主体、租户、OPC 关系、角色和数据范围由服务端计算；客户端传入的 tenant_id、role 或 scope 不能扩大权限。

微信/IAM 认证顺序

1. H5 登录页生成一次性 scene=community_mobile 与随机 client_state，请求 GET /api/auth/wechat/oauth/。
2. 社区后端返回受信任的授权地址，跳转公用授权中心 https://shouquan.yizhangkj.com/api/login/aiopcshequ/；不要自行拼接不受信任的回调域名。
3. shouquan_new 通过签名回调 POST /api/auth/wechat/callback/。社区创建/更新统一用户，但只向前端回传一次性 oauth_code，不把 JWT 放进 URL。
4. 回调页校验 scene、client_state 和 code 格式后，调用 POST /api/oauth/exchange/ 换取短期 access/refresh，再拉取 GET /api/auth/profile/。
5. 管理端和伙伴/运营桌面端可使用微信扫码会话：POST /api/auth/wechat/desktop-qr/session/ → /poll/ → 必要时 /cancel/。二维码过期、确认或取消后不可重放。

五个项目的身份边界

跨站协同共享的是可验证的统一主体和授权关系，不是“登录一次就拥有所有项目管理员权限”。每个项目仍按本地角色、租户和对象权限重新校验。

用 S0-S5 管理 OPC 成长，不用“活跃”替代业务结果

社区阶段是可复核的业务状态。智能体可以提示缺项、建议下一步和生成草稿，但不能自行改变认证结论。每次结论要保留有效期、依据版本、审核人和复核日期。

先登记智能体资产，再进入工作室配置

智能体不是散落在脚本里的提示词，而是有责任人、版本、数据范围、模型、工具、风险等级和验收证据的受管资产。登记页面和工作室都要在同一租户/OPC 上操作。

推荐操作顺序

1. 在管理平台“智能体治理中心”创建草稿，选择所属 OPC、类型、基座模型、自主等级和工具等级。
2. 进入工作室补齐系统提示、上下文层、知识源、工具参数 Schema、预算和人工接管规则，保存为新版本。
3. 提交登记后检查服务端状态和风险分级；未登记或缺少责任人的智能体不能进入生产。
4. 把目标从“让模型更聪明”改成可验收指标，例如引用正确率、人工接管率、单任务成本和响应 SLA。

在隔离沙箱里运行，在回放页里解释每一步

沙箱用于验证模型绑定、提示词、上下文、成本和安全边界。沙箱默认不执行生产工具、不写入业务事实；任何“成功”都必须带运行编号、时间、版本和证据摘要。

运行回放检查清单

• 输入和输出是否只包含当前用户有权访问的最小数据，是否保存了哈希而非敏感原文。
• 模型、提示词、知识源、工具 Schema、策略版本是否与本次运行一致。
• 每个工具调用是否记录调用者、参数校验、结果、耗时、幂等键和拒绝原因。
• Token、费用、延迟、重试、降级和人工接管是否能按租户/OPC/智能体下钻。
• 导出的日志是否脱敏，下载链接是否有权限、有效期和审计记录。

模型、知识、提示词和工具都必须有版本

社区智能体的上下文遵循“规则 → 任务 → 业务对象 → 权限过滤知识 → 会话记忆 → 经授权长期记忆”六层顺序。不要把整库数据、无关个人信息或未经许可的附件直接塞给模型。

工具级别与自主边界

T2 至少要有预览、幂等和审计；T3 要求人工确认或审批；T4（签约、付款、正式申报、开门、敏感跨境传输等）不允许智能体直接执行。若 readiness 显示生产只开放 T0，必须如实保持阻断，不把台账登记当成已接通。

评测证明质量，红队证明边界，二者都不能省略

上线门禁至少覆盖正常任务、边界任务、缺失数据、恶意输入和权限越界五类用例。人工录入的参考结论可以帮助分析，但不能冒充自动评测或生产认证证据。

一次完整的门禁练习

1. 在“评测与红队中心”创建评测集，明确智能体版本、用例总数、阈值和测试类型。
2. 执行自动评测并查看每条结果、证据和费用；失败用例不能用手工备注覆盖。
3. 创建至少一条提示注入、越权读取和敏感输出红队用例，确认结果为阻断并保留攻击输入哈希。
4. 模型、提示词、知识或工具发生变化时克隆新评测集重新运行；旧结论只作为历史版本证据。
5. 查看 readiness 汇总，只有所有强制项通过、证据未过期且发布人具备权限时，才进入灰度/发布流程。

让商机、空间、服务、合同和智能体回链到同一个事实

社区智能体负责理解、匹配、起草和提醒；确定性业务模块负责状态和金额；授权人员负责决定；外部服务商负责现实执行。所有跨项目请求携带 trace_id、来源系统、租户引用和幂等键。

跨项目调用的最小合同

{
  "subject_id": "来自统一 IAM，会话主体不可由前端覆盖",
  "tenant_id": "服务端解析的当前租户",
  "source_system": "aiopcshequ",
  "target_system": "bangong | opcjinengcangku | opcdamoxing | opcshangshi",
  "trace_id": "一次业务链路的追踪号",
  "idempotency_key": "同参数重放使用同一键",
  "intent": "结构化提案，不是已完成事实",
  "requires_human_approval": true
}

目标系统必须再次做身份、租户、对象和风险校验；任何项目都不能因为请求来自“社区智能体”就跳过本地门禁。

角色分离、最小权限和可回放是上线前提

安全红线

学习验收清单

1. 分别从 /uniapp/、/partner/、/ops/ 和 /admin/ 登录，核对同一主体、租户和正确角色；用无权限角色验证 403/禁止页。
2. 创建一个智能体草稿，完成版本、模型、知识、工具和风险字段；确认未登记时不能发布。
3. 在沙箱运行正常、缺失数据和提示注入用例，查看状态、费用、日志和回放；确认沙箱不写生产。
4. 执行自动评测与红队，检查失败证据、克隆重跑、门禁和发布条件。
5. 用同一幂等键重复提交低风险草稿，确认不会重复创建；用不同账号演练审批分离、过期、取消、冻结和恢复。
6. 从社区向办公、技能仓库、大模型和商事代理发起一条只读/提案链，核对 trace_id、租户边界和回链对象。
7. 导出脱敏审计记录，确认撤销会话、删除长期记忆、回滚版本和熔断后没有继续投递。