多智能体编排：让多个角色 Agent 一起做分析

1. 登录 AIP（admin / admin1），打开多智能体编排页 /orchestrate（或直接调接口）
2. 创建任务：POST /api/v1/orchestrations，description="Q3 营收下滑归因分析"，strategy="parallel"
3. 等待同步执行完成，查看返回的任务视图（sub_tasks + result_summary）
4. GET /api/v1/orchestrations/:id 查看每个子任务的 agent_name / status / result_summary

{
  "code": 0,
  "data": {
    "orchestration_id": "9d1f...", "description": "Q3 营收下滑归因分析",
    "strategy": "parallel", "status": "completed", "agent_count": 2,
    "sub_tasks": [
      { "description": "从销售视角分析 Q3 营收下滑原因", "required_role": "sales",
        "status": "completed", "agent_id": "...", "agent_name": "销售分析 Agent",
        "result_summary": "销量下降 12%，主要来自华东区手机线，其中中端机型出货同比 -30%..." },
      { "description": "从财务视角分析 Q3 营收下滑原因", "required_role": "finance",
        "status": "completed", "agent_id": "...", "agent_name": "财务分析 Agent",
        "result_summary": "Q3 均价同比下降 8%，促销折扣率上升 5pct，收入端承压..." }
    ],
    "result_summary": "综合销售与财务双视角：Q3 营收下滑 12%，主因华东区手机线销量下滑（-30%）叠加均价走低，建议聚焦中端机型补货与折扣收紧。",
    "created_by": "admin"
  },
  "trace_id": "..."
}

1. 登录 AIP，进入多智能体编排页
2. 创建任务：POST /api/v1/orchestrations，description="手机线应提价保毛利还是降价抢份额？"，strategy="debate"
3. 等待执行完成，查看返回的融合报告（含争议标注）
4. GET /orchestrations/:id/result 获取最终仲裁结果

{
  "code": 0,
  "data": {
    "orchestration_id": "7ab2...", "description": "手机线应提价保毛利还是降价抢份额？",
    "strategy": "debate", "status": "completed",
    "sub_tasks": [
      { "description": "正方视角：提价保毛利", "status": "completed",
        "agent_name": "通用分析 Agent", "result_summary": "提价 5% 可回补毛利率约 3pct，但需求弹性大时销量 -8%..." },
      { "description": "反方视角：降价抢份额", "status": "completed",
        "agent_name": "通用分析 Agent", "result_summary": "中端机型竞品压价，降价 8% 可保份额但毛利 -4pct..." }
    ],
    "result": "仲裁结论：建议分机型差异化——旗舰提价 5%、中端保持价格并控折扣，预计整体毛利率 +1.5pct 且份额不丢。争议点：需求弹性假设差异较大，需以销售数据验证。",
    "created_by": "admin"
  }
}

1. 登录 admin，调 GET /api/v1/orchestrations/agents 查看现有 4 个内置 Agent
2. POST /api/v1/orchestrations/agents 注册"inventory_agent"（role=supply_chain，自定义 System Prompt + capabilities）
3. PUT /api/v1/orchestrations/agents/:id 把它的 priority 调高、max_concurrency 设为 5
4. GET /api/v1/orchestrations/agents/export 导出声明式 YAML（agent_definitions.yaml）

-- POST /orchestrations/agents 返回（示意）
{ "code": 0, "data": { "name": "inventory_agent", "display_name": "库存分析 Agent",
  "role": "supply_chain", "capabilities": ["inventory","turnover","stock_out"],
  "model_id": "deepseek-v4-flash", "is_enabled": true, "priority": 20, "max_concurrency": 5 } }

-- GET /orchestrations/agents/export 返回 YAML（节选）
agent_definitions:
  - name: inventory_agent
    display_name: 库存分析 Agent
    role: supply_chain
    capabilities: [inventory, turnover, stock_out]
    system_prompt: "你是资深供应链分析助手，擅长库存周转率、缺货率、呆滞库存分析..."
    priority: 20
    max_concurrency: 5
    eval_suite_ref: aip_rag_golden_20