Files
pingtai_agent/devils_advocate_agent/USAGE.md
T
2026-02-05 16:01:34 +00:00

3.6 KiB
Raw Blame History

反对意见 Agent(Devil's Advocate)


本 Agent 提供基于 批判性思维模型 的对抗性分析能力,通过 HTTP API 与 MCP(Model Context Protocol) 对外提供服务。

核心能力:

  • 对抗性分析:系统性挑战假设、质疑前提、暴露逻辑漏洞
  • 风险识别:多维度识别潜在问题、盲点与失败模式
  • 批判性反馈:提供结构化的反驳论点与改进建议

功能概览

提供观点、方案、想法的 逻辑验证、假设挑战、风险评估 能力,返回结构化批判分析结果。

支持能力:

  • 逻辑漏洞与认知偏差识别
  • 可行性与风险压力测试
  • 假设前提的系统性质疑
  • 盲点与失败模式挖掘

1⃣ challenge — 批判性对抗分析

功能说明

对输入内容执行 Devil's Advocate 分析范式,系统性识别论证缺陷、隐含假设、潜在风险与逻辑盲点,返回结构化批判报告。


REST API 调用

POST /api/v1/challenge
Content-Type: application/json
api-key: {your-api-key}
{
  "content": "我们计划使用微服务架构重构现有单体应用,预计3个月内完成迁移",
  "focus_area": "可行性"
}

MCP 调用

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "challenge",
    "arguments": {
      "content": "我们计划使用微服务架构重构现有单体应用,预计3个月内完成迁移",
      "focus_area": "可行性"
    }
  }
}

参数说明

参数 类型 必需 默认值 说明
content string ✅ - 待分析的内容(观点、方案、代码、文档等)
focus_area string ❌ null 聚焦领域:逻辑漏洞 / 可行性 / 安全性 / 成本 / 用户体验 等

聚焦领域说明

领域 分析维度
逻辑漏洞 推理谬误、因果混淆、循环论证、过度泛化
可行性 资源约束、时间估算、技术依赖、执行风险
安全性 攻击面、数据泄露、权限漏洞、合规风险
成本 隐性成本、机会成本、维护成本、规模效应
用户体验 认知负荷、操作摩擦、边界场景、可访问性

返回结果

{
  "success": true,
  "content": "我们计划使用微服务架构重构现有单体应用,预计3个月内完成迁移",
  "focus_area": "可行性",
  "critique": "## 批判性分析\n\n### 🔴 高风险问题\n1. **时间估算过于乐观**:...\n\n### 🟡 潜在风险\n1. **团队技能缺口**:...\n\n### 🔍 隐含假设\n1. 假设现有代码边界清晰...\n\n### 💡 改进建议\n1. 采用渐进式迁移策略..."
}

返回字段说明

字段 类型 说明
success boolean 处理状态
content string 原始输入内容(截断显示)
focus_area string 聚焦领域
critique string 结构化批判分析报告

统一错误格式

成功:

{
  "success": true,
  "data": {}
}

失败:

{
  "success": false,
  "error": "错误描述"
}

服务端点

端点 方法 说明
/ GET 服务状态
/health GET 健康检查
/mcp POST MCP JSON-RPC
/mcp/sse GET/POST MCP SSE 流式
/api/v1/challenge POST 批判性分析

部署信息

配置项 值
镜像地址 agnettaiji.azurecr.io/ai-agents/devils-advocate-agent:latest
服务端口 8000
健康检查 /health