498 lines
29 KiB
Python
498 lines
29 KiB
Python
"""Business-scene contracts for the platform AI routing console."""
|
||
|
||
from __future__ import annotations
|
||
|
||
from typing import Any
|
||
|
||
|
||
AI_SCENE_REGISTRY: dict[str, dict[str, Any]] = {
|
||
"project_launch": {
|
||
"label": "项目启动草案",
|
||
"summary": "快速起草，失败后深度修复，结果必须进入确认",
|
||
"scene_family": "project_lifecycle",
|
||
"scene_owner": "PMFlow 项目启动链",
|
||
"lifecycle": "active",
|
||
"function_names": ["pmflow_launch_draft_v1", "project_from_text_analysis", "project_from_text_charter"],
|
||
"default_slot": "structured",
|
||
"required_slots": ["structured"],
|
||
"allowed_slots": ["structured"],
|
||
"protected": True,
|
||
"business_goal": "把一句话想法转成可确认的项目草案、初始任务和项目真相种子。",
|
||
"input_contract": "原始想法、空间上下文、已有项目约束",
|
||
"output_contract": "结构化草案 + 人工确认",
|
||
"success_criteria": ["草案字段完整", "缺失问题显式列出", "确认前不创建项目"],
|
||
"failure_policy": "结构化失败必须显式失败或进入待确认，禁止模板句冒充成功。",
|
||
"confirmation_policy": "必须进入人工确认后才写入项目主链。",
|
||
"evidence_policy": "需要结构化输出与 JSON Schema 探测证据。",
|
||
"protected_reason": "该场景会生成项目初始事实和任务，错误写入会污染后续执行主链。",
|
||
"expected_slot_key": "structured",
|
||
"expected_slot_label": "结构化槽",
|
||
},
|
||
"requirement_structuring": {
|
||
"label": "需求结构化",
|
||
"summary": "深度优先，保护项目真相层入口",
|
||
"scene_family": "project_lifecycle",
|
||
"scene_owner": "PMFlow 需求主链",
|
||
"lifecycle": "active",
|
||
"function_names": ["project_requirement_extraction", "pmflow_requirement_plan_draft", "pmflow_requirement_plan_round"],
|
||
"default_slot": "structured",
|
||
"required_slots": ["high", "structured"],
|
||
"allowed_slots": ["high", "structured"],
|
||
"protected": True,
|
||
"business_goal": "把用户需求沉淀为可追踪、可确认、可拆解的结构化需求草案。",
|
||
"input_contract": "需求文本、追问上下文、reply/thread 锚点",
|
||
"output_contract": "JSON Schema + 缺字段追问",
|
||
"success_criteria": ["业务字段来自 requirement_card", "缺字段进入追问", "不从 prose 反推业务字段"],
|
||
"failure_policy": "结构化不足时返回待确认或追问，禁止掉回普通问答链。",
|
||
"confirmation_policy": "需求 draft confirm 必须有明确锚点或卡片按钮。",
|
||
"evidence_policy": "需要结构化输出、JSON Schema 与上下文锚点证据。",
|
||
"protected_reason": "需求草案是后续任务拆解和执行确认的业务真源。",
|
||
"expected_slot_key": "structured",
|
||
"expected_slot_label": "结构化槽",
|
||
},
|
||
"task_breakdown": {
|
||
"label": "任务拆解",
|
||
"summary": "快速结构化，失败后深度修复，仍失败则标记待补充",
|
||
"scene_family": "project_lifecycle",
|
||
"scene_owner": "PMFlow 执行队列",
|
||
"lifecycle": "active",
|
||
"function_names": ["generate_task_breakdown", "decompose_tasks_from_charter", "sstc_ai_breakdown"],
|
||
"default_slot": "structured",
|
||
"required_slots": ["structured"],
|
||
"allowed_slots": ["structured"],
|
||
"protected": True,
|
||
"business_goal": "把已确认需求拆成可执行任务、依赖、责任边界和 pending 项。",
|
||
"input_contract": "需求草案、项目目标、团队能力图谱",
|
||
"output_contract": "结构化任务 + pending 标记",
|
||
"success_criteria": ["任务边界清晰", "不确定项标记 pending", "失败不冒充拆解完成"],
|
||
"failure_policy": "低阶结构化失败可升级；仍失败时必须显式 pending。",
|
||
"confirmation_policy": "高风险任务写入前需要人工确认。",
|
||
"evidence_policy": "需要结构化输出、JSON Schema 和任务字段完整性证据。",
|
||
"protected_reason": "任务拆解会直接影响执行队列和后续协同。",
|
||
"expected_slot_key": "structured",
|
||
"expected_slot_label": "结构化槽",
|
||
},
|
||
"assignee_matching": {
|
||
"label": "人员匹配",
|
||
"summary": "深度分析，必须结合人员能力图谱",
|
||
"scene_family": "execution",
|
||
"scene_owner": "PMFlow 人员能力图谱",
|
||
"lifecycle": "active",
|
||
"function_names": ["recommend_assignees_for_task"],
|
||
"default_slot": "high",
|
||
"required_slots": ["high"],
|
||
"allowed_slots": ["high"],
|
||
"protected": True,
|
||
"business_goal": "基于人员能力图谱、负载和任务要求推荐可解释负责人。",
|
||
"input_contract": "任务要求、技能图谱、团队负载",
|
||
"output_contract": "能力图谱 + 可解释推荐",
|
||
"success_criteria": ["推荐理由可解释", "能力缺口显式展示", "不跳过人员能力图谱"],
|
||
"failure_policy": "证据不足时只给待确认候选，不自动派发。",
|
||
"confirmation_policy": "负责人变更属于执行决策，需要用户确认或 reviewer 审核。",
|
||
"evidence_policy": "需要人员能力图谱、负载和任务匹配证据。",
|
||
"expected_slot_key": "high",
|
||
"expected_slot_label": "深度槽",
|
||
},
|
||
"internal_qa": {
|
||
"label": "内部问答",
|
||
"summary": "先走受控内部查询，再按复杂度组织答案",
|
||
"scene_family": "knowledge",
|
||
"scene_owner": "PMFlow 内部问答链",
|
||
"lifecycle": "active",
|
||
"function_names": ["adaptive_rag_answer_normal", "adaptive_rag_answer_deep", "rag_db_project_semantic_retrieval"],
|
||
"default_slot": "mixed",
|
||
"required_slots": ["low", "high"],
|
||
"allowed_slots": ["low", "high"],
|
||
"protected": False,
|
||
"business_goal": "基于项目真相、语义事实和知识库回答内部问题。",
|
||
"input_contract": "问题、对象绑定、内部上下文包",
|
||
"output_contract": "内部证据优先 + 来源摘要",
|
||
"success_criteria": ["先走内部证据", "来源中文化展示", "证据不足时澄清或显式不确定"],
|
||
"failure_policy": "不得让 LLM 自由编造内部结论；证据不足时返回 uncertain/clarify。",
|
||
"confirmation_policy": "只读回答不需要确认，涉及写入动作必须进入待确认。",
|
||
"evidence_policy": "需要 semantic facts、项目真相或受控检索证据。",
|
||
"expected_slot_key": "mixed",
|
||
"expected_slot_label": "快速/深度混合",
|
||
},
|
||
"external_query": {
|
||
"label": "外部实时查询",
|
||
"summary": "外部查询必须经过计划、来源校验和答案验证",
|
||
"scene_family": "external",
|
||
"scene_owner": "PMFlow 外部查询链",
|
||
"lifecycle": "active",
|
||
"function_names": ["external_query_plan", "external_query_dashscope_responses", "adaptive_rag_answer"],
|
||
"default_slot": "external_query",
|
||
"required_slots": ["external_query"],
|
||
"allowed_slots": ["external_query", "high"],
|
||
"protected": True,
|
||
"business_goal": "在需要新鲜外部信息时检索、验证并用中文业务摘要呈现。",
|
||
"input_contract": "外部问题、freshness 需求、来源策略",
|
||
"output_contract": "实时来源 + verifier + freshness guard",
|
||
"success_criteria": ["来源过滤 fail-closed", "verifier 可用", "无法确认时不编造最新结论"],
|
||
"failure_policy": "外部查询失败必须显式失败或返回 freshness guard。",
|
||
"confirmation_policy": "只读外部回答不确认；接入或入库动作需要确认。",
|
||
"evidence_policy": "需要外部 provider、source filtering、verifier 和 freshness 证据。",
|
||
"protected_reason": "外部事实错误会直接影响策略判断和推荐质量。",
|
||
"expected_slot_key": "external_query",
|
||
"expected_slot_label": "外部查询槽",
|
||
},
|
||
"pmflow_ai_route_planning": {
|
||
"label": "旧 PMFlow AI 路由规划（已下线）",
|
||
"summary": "历史 route_plan/source_strategy 规划场景，仅用于旧日志归类和迁移审计",
|
||
"scene_family": "knowledge",
|
||
"scene_owner": "PMFlow AI 双脑入口",
|
||
"lifecycle": "deprecated",
|
||
"function_names": ["pmflow_ai_route_planner"],
|
||
"default_slot": "low",
|
||
"required_slots": ["low"],
|
||
"allowed_slots": ["low", "high"],
|
||
"protected": False,
|
||
"business_goal": "保留旧日志与 Prompt 运营清单可解释性；Space 用户侧主链已由 TurnState + Action Loop 取代。",
|
||
"input_contract": "旧日志兼容字段，不再作为运行时输入合同。",
|
||
"output_contract": "旧 route_plan/source_strategy/allowed_executors，仅用于历史 replay，不得驱动 Space API。",
|
||
"success_criteria": ["不再出现在 Space 用户侧运行时调用", "旧日志仍可归类", "不能恢复为 action/source/answer 主控"],
|
||
"failure_policy": "不得恢复旧 planner fallback；运行时必须进入 Turn Runtime 或非 Space RAG 兼容链。",
|
||
"confirmation_policy": "无运行时动作授权。",
|
||
"evidence_policy": "仅保留旧日志归类证据。",
|
||
"protected_reason": "已下线场景不参与 active 槽位发布门禁。",
|
||
"expected_slot_key": "low",
|
||
"expected_slot_label": "快速槽",
|
||
},
|
||
"rag_query_semantics": {
|
||
"label": "RAG 问答语义与来源策略（非 Space）",
|
||
"summary": "把非 Space query.answer 只读问题结构化为对象、来源策略和回答形态",
|
||
"scene_family": "knowledge",
|
||
"scene_owner": "AdaptiveRAG",
|
||
"lifecycle": "active",
|
||
"function_names": ["rag_query_semantics"],
|
||
"default_slot": "low",
|
||
"required_slots": ["low"],
|
||
"allowed_slots": ["low", "high"],
|
||
"protected": True,
|
||
"business_goal": "服务非 Space RAG 兼容主链；Space 用户侧不得通过该场景绕开 Turn Runtime。",
|
||
"input_contract": "用户原始问题、workflow bundle、业务对象绑定、上下文与 source policy hint。",
|
||
"output_contract": "query.answer 语义结构、目标对象、答案形态和来源策略。",
|
||
"success_criteria": ["只服务非 Space RAG 主链", "输出结构化语义而不是最终答案", "下游不能再做词面拍板"],
|
||
"failure_policy": "结构化失败时显式 degraded/uncertain，不得伪装成证据不足。",
|
||
"confirmation_policy": "只读语义治理；涉及写入或接入动作必须交给后续确认链。",
|
||
"evidence_policy": "需要 business frame、source policy hint 与对象锚点证据。",
|
||
"protected_reason": "RAG 来源策略误判会导致内部/外部答案混用。",
|
||
"expected_slot_key": "low",
|
||
"expected_slot_label": "快速槽",
|
||
},
|
||
"pmflow_ai_context_governance": {
|
||
"label": "上下文与语义治理",
|
||
"summary": "绑定对象、线程、续问和主链边界",
|
||
"scene_family": "knowledge",
|
||
"scene_owner": "PMFlow AI 语义治理层",
|
||
"lifecycle": "active",
|
||
"function_names": [
|
||
"pmflow_semantic_context_decision",
|
||
"rag_followup_anchor_semantics",
|
||
"rag_pending_clarification_selection_semantics",
|
||
"rag_answer_scene_semantics",
|
||
],
|
||
"default_slot": "low",
|
||
"required_slots": ["low"],
|
||
"allowed_slots": ["low", "high"],
|
||
"protected": True,
|
||
"business_goal": "把当前消息、历史线程、显式锚点和业务对象统一成可审计的 SemanticDecision，保护 requirement、query 和 follow-up 主链不串线。",
|
||
"input_contract": "SemanticContextPacket、上一轮 QA/clarify 状态、reply/thread/work_item 锚点、业务对象候选",
|
||
"output_contract": "topic/workflow/interaction boundary/anchor decision JSON",
|
||
"success_criteria": ["显式锚点优先", "需求模式不掉回普通 QA", "无证据时保留 uncertain/clarify"],
|
||
"failure_policy": "语义规划失败只能带 degraded 标记降级到中性 query.answer 或澄清，禁止强行进入写链。",
|
||
"confirmation_policy": "只做语义边界裁决，不直接写 Project Memory、ChangeSet 或任务。",
|
||
"evidence_policy": "需要 SemanticContextPacket、conversation scope、显式锚点和 active workspace 证据。",
|
||
"protected_reason": "该场景保护 PMFlow AI 上下文和主链边界，误判会造成旧草稿回捞、线程串线或错误写入。",
|
||
"expected_slot_key": "low",
|
||
"expected_slot_label": "快速槽",
|
||
},
|
||
"pmflow_ai_answer_presentation": {
|
||
"label": "客户答案呈现与质检",
|
||
"summary": "把 customer-safe evidence packet 渲染成客户可见答案并做泄露检查",
|
||
"scene_family": "knowledge",
|
||
"scene_owner": "PMFlow AI 客户答案层",
|
||
"lifecycle": "active",
|
||
"function_names": [
|
||
"customer_answer_composer",
|
||
"space_ai_interaction_option_planner",
|
||
"customer_answer_verifier",
|
||
],
|
||
"default_slot": "low",
|
||
"required_slots": ["low"],
|
||
"allowed_slots": ["low", "high"],
|
||
"protected": True,
|
||
"business_goal": "只基于客户安全证据包生成中文答案，并在返回前检查是否泄露内部术语、trace、prompt key 或供应商信息。",
|
||
"input_contract": "customer_evidence_packet、用户问题、候选答案",
|
||
"output_contract": "客户可见中文答案 / verifier JSON",
|
||
"success_criteria": ["只消费 display_label/display_summary/business_values", "不暴露 raw source 或内部实现", "证据不足时明确不确定"],
|
||
"failure_policy": "呈现或质检失败时回退确定性 renderer 或显式失败，禁止用模板话术冒充成功。",
|
||
"confirmation_policy": "只读答案不确认；任何写入动作必须进入待确认链。",
|
||
"evidence_policy": "需要 customer_evidence_packet、answer_process_packet 和 verifier 结果。",
|
||
"protected_reason": "该场景直接决定用户看到什么，错误会暴露内部实现或把无证据结论包装成确定答案。",
|
||
"expected_slot_key": "low",
|
||
"expected_slot_label": "快速槽",
|
||
},
|
||
"space_pmflow_ai_operating_runtime": {
|
||
"label": "Space AI Operating Mission",
|
||
"summary": "把 Space 用户输入升级为可经营 mission，供后续 Agent OS 工作循环消费",
|
||
"scene_family": "knowledge",
|
||
"scene_owner": "PMFlow AI Operating Runtime",
|
||
"lifecycle": "active",
|
||
"function_names": ["pmflow_ai_operating_mission"],
|
||
"default_slot": "low",
|
||
"required_slots": ["low"],
|
||
"allowed_slots": ["low", "high"],
|
||
"protected": True,
|
||
"business_goal": "把用户输入转成可审计的 OperatingMission，明确对象范围、业务交付、专业 agent、确认边界和下一轮触发。",
|
||
"input_contract": "用户原始问题、conversation context、客户安全 surface context、specialist capability contracts。",
|
||
"output_contract": "OperatingMission JSON，不生成最终答案、不执行写入、不调用工具。",
|
||
"success_criteria": ["使用 active prompt release", "输出符合 OperatingMission schema", "确认边界和禁止动作显式写入", "失败时回到确定性 mission fallback"],
|
||
"failure_policy": "模型失败只影响 mission 丰富度，不得阻塞后续确定性 fallback；禁止 code_fallback prompt 和同步 low->high 拖长等待。",
|
||
"confirmation_policy": "只生成 mission；Project Memory、ChangeSet、任务、handoff、发布和外部动作必须由后续确认链路处理。",
|
||
"evidence_policy": "需要 prompt active release、runtime profile、路由规则、provider request payload 和 agent_run/step 归因证据。",
|
||
"protected_reason": "OperatingMission 是 Space AI 后续工作循环的目标合同，错误会影响 agent 选择、证据读取和最终答案边界。",
|
||
"expected_slot_key": "low",
|
||
"expected_slot_label": "快速槽",
|
||
},
|
||
"space_pmflow_ai_agent_runtime": {
|
||
"label": "Space AI Agent Runtime 节点",
|
||
"summary": "Operating Runtime 的只读交付子循环，负责目标框架、工具规划、证据归一、状态审查和终局表达",
|
||
"scene_family": "knowledge",
|
||
"scene_owner": "PMFlow AI Agent Runtime",
|
||
"lifecycle": "active",
|
||
"function_names": [
|
||
"pmflow_ai_agent_goal_frame",
|
||
"pmflow_ai_agent_step_planner",
|
||
"pmflow_ai_agent_evidence_normalizer",
|
||
"pmflow_ai_agent_state_critic",
|
||
"pmflow_ai_agent_answer_composer",
|
||
"pmflow_ai_agent_answer_reviser",
|
||
],
|
||
"default_slot": "low",
|
||
"required_slots": ["low"],
|
||
"allowed_slots": ["low", "high"],
|
||
"protected": True,
|
||
"business_goal": "把本轮工具观察转成客户安全的 claim、boundary、gap、action ledger，并生成不泄露内部实现的自然回答。",
|
||
"input_contract": "用户原始问题、Agent Workspace、客户安全 surface context、白名单工具合同和 Observation Ledger。",
|
||
"output_contract": "Agent node JSON 或客户安全自然答案；不写 Project Memory、不提交 ChangeSet、不发起执行。",
|
||
"success_criteria": ["节点调用写入 function runtime profile 归因", "证据归一保留可核验具体事实", "终局表达只消费客户安全 ledger", "质量失败时 fail-closed"],
|
||
"failure_policy": "节点模型失败只能进入确定性只读 fallback 或 terminal boundary，禁止旧链路模板抢答。",
|
||
"confirmation_policy": "只读回答不确认；任何写入、提交、派发、发布或执行交接必须由后续确认链处理。",
|
||
"evidence_policy": "需要 prompt active release、runtime profile、Agent step、Observation Ledger、Answer Runtime 和 verifier 归因证据。",
|
||
"protected_reason": "该场景直接决定 Space AI 回答的具体性和安全边界，参数错误会造成空泛回答或内部实现泄露。",
|
||
"expected_slot_key": "low",
|
||
"expected_slot_label": "快速槽",
|
||
},
|
||
"feishu_understanding": {
|
||
"label": "飞书消息理解",
|
||
"summary": "快速理解与分流，低置信度进入澄清",
|
||
"scene_family": "collaboration",
|
||
"scene_owner": "PMFlow 飞书集成",
|
||
"lifecycle": "active",
|
||
"function_names": ["feishu_level_classification", "feishu_signal_extraction"],
|
||
"default_slot": "low",
|
||
"required_slots": ["low"],
|
||
"allowed_slots": ["low"],
|
||
"protected": False,
|
||
"business_goal": "从飞书消息、回复线程和卡片回流中恢复正确业务上下文。",
|
||
"input_contract": "飞书消息、reply/thread、卡片按钮、source_message_id",
|
||
"output_contract": "上下文锚点 + 主链选择",
|
||
"success_criteria": ["优先 canonical reply/thread", "不按同群旧草稿回捞", "主链选择可审计"],
|
||
"failure_policy": "锚点不足时澄清或回到中性问答，不强行进入需求链。",
|
||
"confirmation_policy": "draft confirm 必须来自显式锚点或卡片动作。",
|
||
"evidence_policy": "需要 reply/thread、work_item_id 或 active draft workspace 证据。",
|
||
"expected_slot_key": "low",
|
||
"expected_slot_label": "快速槽",
|
||
},
|
||
"feishu_reply": {
|
||
"label": "飞书回复",
|
||
"summary": "快速润色，不改变业务结论",
|
||
"scene_family": "collaboration",
|
||
"scene_owner": "PMFlow 飞书集成",
|
||
"lifecycle": "active",
|
||
"function_names": ["feishu_humanized_reply", "feishu_qa_direct_natural_reply"],
|
||
"default_slot": "low",
|
||
"required_slots": ["low"],
|
||
"allowed_slots": ["low"],
|
||
"protected": False,
|
||
"business_goal": "把业务结论改写成适合飞书对话的中文自然表达。",
|
||
"input_contract": "业务结论、回复场景、对象上下文",
|
||
"output_contract": "中文自然表达 + 不改变结论",
|
||
"success_criteria": ["不新增未证实事实", "不改变业务结论", "语气适合协作场景"],
|
||
"failure_policy": "润色失败时返回原结论或显式失败，不编造补充信息。",
|
||
"confirmation_policy": "只读回复不确认；写入项目状态仍需确认。",
|
||
"evidence_policy": "需要上游业务结论与来源摘要。",
|
||
"expected_slot_key": "low",
|
||
"expected_slot_label": "快速槽",
|
||
},
|
||
"release_review": {
|
||
"label": "发布评审",
|
||
"summary": "候选场景：发布前汇总变更、风险、验证和回滚建议",
|
||
"scene_family": "project_lifecycle",
|
||
"scene_owner": "PMFlow 发布增长链",
|
||
"lifecycle": "candidate",
|
||
"function_names": [],
|
||
"default_slot": "",
|
||
"required_slots": [],
|
||
"allowed_slots": [],
|
||
"protected": False,
|
||
"business_goal": "把一次发布前的变更、验证证据、风险和回滚方案组织成可审查结论。",
|
||
"input_contract": "变更集、验证记录、失败样本、项目目标",
|
||
"output_contract": "发布评审摘要 + 风险清单 + 回滚建议",
|
||
"success_criteria": ["风险可追踪", "验证证据可解释", "回滚建议不冒充自动发布"],
|
||
"failure_policy": "证据不足时标记待补充，不生成发布通过结论。",
|
||
"confirmation_policy": "发布结论必须由负责人确认。",
|
||
"evidence_policy": "需要变更集、测试/验证和失败样本证据。",
|
||
"expected_slot_key": "high",
|
||
"expected_slot_label": "深度槽",
|
||
},
|
||
"retrospective_summary": {
|
||
"label": "项目复盘摘要",
|
||
"summary": "候选场景：从执行记录和结果信号生成复盘草案",
|
||
"scene_family": "project_lifecycle",
|
||
"scene_owner": "PMFlow 复盘链",
|
||
"lifecycle": "candidate",
|
||
"function_names": [],
|
||
"default_slot": "",
|
||
"required_slots": [],
|
||
"allowed_slots": [],
|
||
"protected": False,
|
||
"business_goal": "把项目结果、执行轨迹和关键偏差整理为可确认复盘。",
|
||
"input_contract": "项目目标、任务结果、发布数据、团队反馈",
|
||
"output_contract": "结构化复盘草案 + 改进行动",
|
||
"success_criteria": ["结论有证据", "改进项可执行", "不把推测写成事实"],
|
||
"failure_policy": "证据不足时只输出待补充项。",
|
||
"confirmation_policy": "复盘写回项必须人工确认。",
|
||
"evidence_policy": "需要执行、发布和反馈证据。",
|
||
"expected_slot_key": "long_context",
|
||
"expected_slot_label": "长上下文槽",
|
||
},
|
||
"change_review": {
|
||
"label": "变更审查",
|
||
"summary": "从项目主链消息抽取待审变更，写回前必须人工确认",
|
||
"scene_family": "project_lifecycle",
|
||
"scene_owner": "PMFlow Change Review",
|
||
"lifecycle": "active",
|
||
"function_names": ["pmflow_change_review_extraction_v1"],
|
||
"default_slot": "structured",
|
||
"required_slots": ["structured"],
|
||
"allowed_slots": ["structured"],
|
||
"protected": True,
|
||
"business_goal": "把项目主链里的新增诉求、风险、任务和决策抽取成 ChangeSet 待审对象。",
|
||
"input_contract": "项目线程消息、附件摘要、可选对象锚点",
|
||
"output_contract": "结构化 proposed_items + evidence + missing_info",
|
||
"success_criteria": ["候选对象来自本轮消息证据", "风险分级清楚", "不自动提交变更"],
|
||
"failure_policy": "结构化失败或证据不足时显式失败/待补充，禁止创建模板 ChangeSet。",
|
||
"confirmation_policy": "写回或提交变更必须确认。",
|
||
"evidence_policy": "需要项目线程消息证据和结构化输出证据。",
|
||
"protected_reason": "该场景会生成可写回项目事实和任务的待审对象，误抽取会污染项目主链。",
|
||
"expected_slot_key": "structured",
|
||
"expected_slot_label": "结构化槽",
|
||
},
|
||
"project_memory_writeback": {
|
||
"label": "项目记忆写回",
|
||
"summary": "候选场景：把已确认结论写入项目记忆和语义事实",
|
||
"scene_family": "knowledge",
|
||
"scene_owner": "PMFlow 记忆层",
|
||
"lifecycle": "candidate",
|
||
"function_names": [],
|
||
"default_slot": "",
|
||
"required_slots": [],
|
||
"allowed_slots": [],
|
||
"protected": False,
|
||
"business_goal": "把已确认业务结论转成可审计、可撤销的项目记忆写回计划。",
|
||
"input_contract": "确认后的业务结论、来源摘要、对象绑定",
|
||
"output_contract": "写回计划 + 证据引用 + 待确认",
|
||
"success_criteria": ["只写确认事实", "来源可追踪", "可撤销"],
|
||
"failure_policy": "来源不足时禁止写回。",
|
||
"confirmation_policy": "写回动作必须人工确认。",
|
||
"evidence_policy": "需要确认卡片、来源摘要和对象绑定证据。",
|
||
"expected_slot_key": "structured",
|
||
"expected_slot_label": "结构化槽",
|
||
},
|
||
"mcp_execution_planning": {
|
||
"label": "MCP 执行规划",
|
||
"summary": "候选场景：为本地或外部工具执行生成受控计划",
|
||
"scene_family": "execution",
|
||
"scene_owner": "PMFlow 工具执行层",
|
||
"lifecycle": "candidate",
|
||
"function_names": [],
|
||
"default_slot": "",
|
||
"required_slots": [],
|
||
"allowed_slots": [],
|
||
"protected": False,
|
||
"business_goal": "把用户意图转成受控工具执行计划、权限边界和确认点。",
|
||
"input_contract": "用户意图、工具目录、权限和环境约束",
|
||
"output_contract": "工具执行计划 + 权限确认",
|
||
"success_criteria": ["命令可解释", "权限边界清楚", "危险动作确认"],
|
||
"failure_policy": "工具能力或权限不足时显式失败。",
|
||
"confirmation_policy": "本机执行、写操作和外部副作用必须确认。",
|
||
"evidence_policy": "需要工具目录、权限和运行环境证据。",
|
||
"expected_slot_key": "tool",
|
||
"expected_slot_label": "工具槽",
|
||
},
|
||
"contract_sync": {
|
||
"label": "合同同步",
|
||
"summary": "候选场景：把外部规范或契约同步为内部可用上下文",
|
||
"scene_family": "knowledge",
|
||
"scene_owner": "PMFlow 契约同步",
|
||
"lifecycle": "candidate",
|
||
"function_names": [],
|
||
"default_slot": "",
|
||
"required_slots": [],
|
||
"allowed_slots": [],
|
||
"protected": False,
|
||
"business_goal": "把外部文档、接口契约或流程规范同步成可审计上下文。",
|
||
"input_contract": "外部文档、接口契约、同步来源",
|
||
"output_contract": "结构化契约摘要 + 差异说明",
|
||
"success_criteria": ["来源明确", "差异可审查", "不覆盖未确认契约"],
|
||
"failure_policy": "解析或来源校验失败时不写入。",
|
||
"confirmation_policy": "同步写入必须确认。",
|
||
"evidence_policy": "需要来源、版本和解析证据。",
|
||
"expected_slot_key": "long_context",
|
||
"expected_slot_label": "长上下文槽",
|
||
},
|
||
}
|
||
|
||
|
||
def scene_contract(scene_key: str) -> dict[str, Any]:
|
||
scene = AI_SCENE_REGISTRY.get(str(scene_key or "").strip())
|
||
if not scene:
|
||
return {
|
||
"scene_key": scene_key,
|
||
"label": scene_key,
|
||
"business_goal": "该场景由 PMFlow AI 运行层按业务语义触发。",
|
||
"input_contract": "业务上下文",
|
||
"output_contract": "显式成功 / 显式失败 / 待确认",
|
||
"success_criteria": ["输出可解释", "失败显式表达", "不绕过保护边界"],
|
||
"failure_policy": "证据不足或结构化不足时必须显式失败、澄清或进入待确认。",
|
||
"confirmation_policy": "涉及写入、派发或发布的动作必须人工确认。",
|
||
"evidence_policy": "需要对应场景的上下文、能力槽位和运行证据。",
|
||
"protected_reason": None,
|
||
"expected_slot_key": "",
|
||
"expected_slot_label": "按场景所需能力选择槽位",
|
||
"scene_family": "unknown",
|
||
"scene_owner": "PMFlow AI 运行层",
|
||
"lifecycle": "active",
|
||
"protected": False,
|
||
}
|
||
return {
|
||
"scene_key": scene_key,
|
||
"label": scene["label"],
|
||
"business_goal": scene["business_goal"],
|
||
"input_contract": scene["input_contract"],
|
||
"output_contract": scene["output_contract"],
|
||
"success_criteria": list(scene["success_criteria"]),
|
||
"failure_policy": scene["failure_policy"],
|
||
"confirmation_policy": scene["confirmation_policy"],
|
||
"evidence_policy": scene["evidence_policy"],
|
||
"protected_reason": scene.get("protected_reason"),
|
||
"expected_slot_key": scene.get("expected_slot_key", ""),
|
||
"expected_slot_label": scene.get("expected_slot_label", "按场景所需能力选择槽位"),
|
||
"scene_family": scene.get("scene_family", "unknown"),
|
||
"scene_owner": scene.get("scene_owner", "PMFlow AI 运行层"),
|
||
"lifecycle": scene.get("lifecycle", "active"),
|
||
"protected": bool(scene.get("protected", False)),
|
||
}
|