{
  "schema": "aiopc.agent-operation-guide.v1",
  "project": "aiopcshequ",
  "title": "AI OPC 社区智能体操作指南",
  "version": "2026.09",
  "updated": "2026-09-02",
  "canonical_url": "https://aiopcshequ.yizhangkj.com/agent-guide/",
  "purpose": "统一社区身份、角色、智能体治理、业务协同和学习验收口径",
  "disclaimer": "登记、授权、评测或沙箱成功不等于真实生产执行；生产状态以服务端门禁、审批和可核验回执为准。",
  "surfaces": [
    {"name": "管理与招商平台", "path": "/admin/", "roles": ["platform_admin", "招商/产业运营", "财务/法务/风控"]},
    {"name": "运营工作台", "path": "/ops/", "roles": ["community_operator", "现场运营"]},
    {"name": "生态伙伴门户", "path": "/partner/", "roles": ["chain_leader", "mentor", "investor", "university", "service_partner"]},
    {"name": "OPC 创业者门户", "path": "/uniapp/", "roles": ["opc_owner", "authorized_collaborator"]}
  ],
  "authentication": {
    "provider": "shouquan_new + AI OPC IAM",
    "h5": [
      "GET /api/auth/wechat/oauth/?scene=community_mobile&client_state=<random>",
      "跳转 https://shouquan.yizhangkj.com/api/login/aiopcshequ/",
      "POST /api/auth/wechat/callback/ 返回一次性 oauth_code",
      "POST /api/oauth/exchange/ 换取 access/refresh",
      "GET /api/auth/profile/ 获取服务端用户、租户和角色"
    ],
    "desktop_qr": [
      "POST /api/auth/wechat/desktop-qr/session/",
      "POST /api/auth/wechat/desktop-qr/poll/",
      "POST /api/auth/wechat/desktop-qr/cancel/"
    ],
    "rules": [
      "subject、tenant、role 和 scope 由服务端计算",
      "授权 code、JWT 和密钥不得放入 URL、prompt 或日志",
      "二维码和一次性 code 过期、确认或取消后不可重放",
      "高权限角色按要求使用 MFA"
    ]
  },
  "lifecycle": [
    {"stage": "S0", "name": "线索", "evidence": ["来源", "联系方式", "授权记录"], "agent": "去重、补字段、生成联系待办"},
    {"stage": "S1", "name": "候选", "evidence": ["核心自然人", "AI 主营", "人员/案例初稿"], "agent": "列缺项、风险和访谈问题"},
    {"stage": "S2", "name": "认证", "evidence": ["审核单", "依据版本", "有效期", "责任人"], "agent": "生成入驻清单和服务计划"},
    {"stage": "S3", "name": "成长", "evidence": ["MVP/用户反馈", "商机或订单"], "agent": "拆解 90 日计划、匹配导师和场景"},
    {"stage": "S4", "name": "规模化", "evidence": ["SOP", "报价", "验收件", "成本/复购"], "agent": "分析瓶颈和渠道"},
    {"stage": "S5", "name": "标杆", "evidence": ["经营结果", "生态贡献", "合规案例"], "agent": "生成脱敏案例和贡献报告"}
  ],
  "agent_lifecycle": ["draft", "registered", "sandbox", "active", "paused", "suspended"],
  "autonomy_levels": {
    "L0": "检索/只读",
    "L1": "建议或草稿",
    "L2": "待确认的结构化动作",
    "L3": "规则内、可撤销的低风险自动动作",
    "L4": "高风险动作，社区智能体禁止直接执行"
  },
  "tool_levels": {
    "T0": "只读公开",
    "T1": "只读内部，透传用户权限",
    "T2": "可撤销写入，预览、幂等和审计",
    "T3": "重要写入，逐次确认或审批",
    "T4": "签约、付款、正式申报、开门、敏感跨境传输等高风险动作，禁止智能体直接执行"
  },
  "governance_routes": {
    "agent_registry": "/admin/#/agent",
    "agent_studio": "/admin/#/agent/studio",
    "sandbox": "/admin/#/mvp-lab",
    "replay": "/admin/#/agent/run",
    "model_gateway": "/admin/#/model-gateway",
    "knowledge": "/admin/#/knowledge",
    "prompt": "/admin/#/prompt",
    "tools": "/admin/#/tools",
    "evaluation": "/admin/#/evaluation",
    "release": "/admin/#/deploy",
    "integration_health": "/admin/#/integration-health"
  },
  "run_states": {
    "queued": "等待调度",
    "running": "执行中",
    "succeeded": "隔离运行完成，不等同生产发布",
    "blocked": "门禁或权限阻断",
    "failed": "模型、网关或校验失败",
    "cancelled": "用户停止或会话过期",
    "unknown": "回执不完整，停止重试并转人工对账"
  },
  "evaluation": {
    "required_sets": ["正常任务", "边界任务", "缺失数据", "恶意输入", "权限越界"],
    "dimensions": ["任务质量", "事实性", "安全", "可控性", "成本/性能"],
    "release_rules": ["严重安全问题为 0", "高风险动作 100% 进入人工环节", "证据未过期且版本一致", "readiness 和发布权限均通过"],
    "manual_evidence_note": "人工参考结论不能冒充自动评测或生产认证证据"
  },
  "cross_project_contract": {
    "required_fields": ["subject_id", "tenant_id", "source_system", "target_system", "trace_id", "idempotency_key", "intent", "requires_human_approval"],
    "projects": {
      "aiopcshequ": "IAM、社区成员、园区、伙伴/运营和智能体治理",
      "bangong": "任务、文档、会议、审批和通知",
      "opcjinengcangku": "技能包、能力契约、证据和资源复用",
      "opcdamoxing": "模型、GEO、知识和受控推理",
      "opcshangshi": "主体、账户、合同、支付、税务台账和服务商回执"
    },
    "rule": "目标项目必须再次校验身份、租户、对象和风险，不得直接写数据库。"
  },
  "learning_checklist": [
    "四类入口登录后核对同一主体、租户和正确角色",
    "创建智能体草稿并确认未登记不能发布",
    "在沙箱运行正常、缺失数据和提示注入用例并回放",
    "执行自动评测与红队，检查 readiness 和发布条件",
    "演练幂等、审批分离、过期、取消、冻结和恢复",
    "跨五项目发起只读/提案链并核对 trace_id 和租户边界",
    "导出脱敏审计并验证撤销、删除、回滚和熔断"
  ],
  "related_guides": [
    {"project": "bangong", "url": "https://bangong.yizhangkj.com/agent-guide/"},
    {"project": "opcjinengcangku", "url": "https://opcjinengcangku.yizhangkj.com/agent-guide/"},
    {"project": "opcdamoxing", "url": "https://opcdamoxing.yizhangkj.com/agent-guide/"},
    {"project": "opcshangshi", "url": "https://opcshangshi.yizhangkj.com/agent-guide/"}
  ]
}