# 两步判断API定义

## 第一步：有效性判断API

```json
{
  "Validity_Assessment": {
    "Check_Request_Validity": {
      "API_ValidityCheck": {
        "description": "判断买家请求是否在商业对话范围内",
        "parameters": {
          "is_valid": {
            "type": "boolean",
            "description": "请求是否有效 - true为有效商业询问，false为超范围请求"
          },
          "confidence": {
            "type": "number",
            "range": [0, 1],
            "description": "判断信心度，0-1之间的数值"
          },
          "reasoning": {
            "type": "string", 
            "description": "判断理由的简要说明"
          }
        }
      }
    }
  }
}
```

## 第二步：异常分类API

```json
{
  "Invalid_Request_Classification": {
    "Classify_Invalid_Request": {
      "API_ClassifyInvalidRequest": {
        "description": "对无效请求进行分类并生成适当回复",
        "parameters": {
          "category": {
            "type": "string",
            "enum": [
              "irrelevant_info",
              "beyond_capability", 
              "scope_violation",
              "impossible_request"
            ],
            "description": "无效请求的分类"
          },
          "subcategory": {
            "type": "string",
            "description": "更具体的子分类（可选）"
          },
          "rejection_response": {
            "type": "string",
            "description": "给买家的礼貌拒绝回复"
          },
          "redirect_suggestion": {
            "type": "string",
            "description": "建议的合理替代话题（可选）"
          }
        }
      }
    }
  }
}
```

## 组合使用示例

### Valid请求处理
```json
{
  "validity": "valid",
  "action_list": ["API_QueryPrice"],
  "confidence": 0.95,
  "response": "这款手机的售价是2800元，成色9成新。"
}
```

### Invalid请求处理  
```json
{
  "validity": "invalid", 
  "category": "irrelevant_info",
  "action_list": ["API_ValidityCheck", "API_ClassifyInvalidRequest"],
  "confidence": 0.92,
  "response": "很抱歉，我专门负责产品咨询服务。关于这款手机，我可以为您介绍价格、配置或使用状况，有什么需要了解的吗？"
}
```

## 分类详细说明

### 1. irrelevant_info (无关信息)
- **触发场景**: 完全与产品无关的话题
- **示例**: "今天天气怎么样？" "你知道附近哪里有好吃的吗？"
- **响应策略**: 简洁拒绝 + 引导回产品话题

### 2. beyond_capability (超出能力)  
- **触发场景**: 需要专业技术知识或复杂操作指导
- **示例**: "帮我修复这个软件bug" "如何重新安装主板驱动？"
- **响应策略**: 说明能力界限 + 建议寻求专业帮助

### 3. scope_violation (范围违规)
- **触发场景**: 涉及竞品对比、专业建议等
- **示例**: "这个比iPhone怎么样？" "我该投资什么股票？"  
- **响应策略**: 明确服务范围 + 专注当前产品

### 4. impossible_request (不可能请求)
- **触发场景**: 物理上不可能或矛盾的需求
- **示例**: "能让这个2GB的手机变成128GB吗？" "这个耳机能防水还能透气吗？"
- **响应策略**: 解释现实限制 + 提供可行替代方案

## 质量控制

### 判断标准
- **准确性**: 正确识别valid/invalid (目标>90%)
- **一致性**: 同类请求分类稳定 (变异<5%)
- **适当性**: 响应语气专业友善 (评分>8/10)

### 常见错误避免
- 过度严格：将合理询问判为invalid
- 过度宽松：将明显超范围请求判为valid  
- 分类模糊：在分类边界上犹豫不决
- 响应生硬：机械化拒绝缺乏人性化