# Special Case API Definitions for Out-of-Scope Request Handling

## Out-of-Scope API Tools

### 1. Inappropriate Content Rejection
```json
{
  "Handle_OutOfScope_Requests": {
    "Reject_Inappropriate": {
      "API_RejectInappropriate": {
        "description": "Politely decline inappropriate, offensive, or personal requests while maintaining professional tone and redirecting to product-related topics",
        "parameters": {
          "rejection_reason": {
            "type": "string",
            "enum": ["personal_information", "harassment", "offensive_language", "inappropriate_content", "privacy_violation"],
            "description": "Specific reason for rejection"
          },
          "redirect_to_product": {
            "type": "boolean", 
            "description": "Whether to redirect conversation back to product topics"
          },
          "response_tone": {
            "type": "string",
            "enum": ["professional", "firm_but_polite", "helpful_redirect"],
            "default": "professional"
          }
        }
      }
    }
  }
}
```

### 2. Technical Limitation Rejection  
```json
{
  "Handle_OutOfScope_Requests": {
    "Reject_Technical": {
      "API_RejectTechnicalSupport": {
        "description": "Decline requests that exceed basic product information and require advanced technical expertise, professional services, or complex troubleshooting",
        "parameters": {
          "limitation_type": {
            "type": "string", 
            "enum": ["advanced_troubleshooting", "professional_installation", "technical_configuration", "repair_guidance", "enterprise_setup"],
            "description": "Type of technical limitation"
          },
          "suggest_alternative": {
            "type": "string",
            "description": "Suggested alternative resource or professional service"
          },
          "basic_info_offered": {
            "type": "boolean",
            "description": "Whether basic product specifications can still be provided"
          }
        }
      }
    }
  }
}
```

### 3. Scope Boundary Violation Rejection
```json
{
  "Handle_OutOfScope_Requests": {
    "Reject_ScopeViolation": {
      "API_RejectScopeViolation": {
        "description": "Decline requests outside commercial dialogue scope including competitor information, non-product services, legal/medical advice, or unrelated topics",
        "parameters": {
          "violation_type": {
            "type": "string",
            "enum": ["competitor_inquiry", "unrelated_service", "legal_advice", "medical_advice", "financial_planning", "third_party_integration"],
            "description": "Type of scope boundary violation"
          },
          "scope_clarification": {
            "type": "string", 
            "description": "Brief explanation of agent's actual scope"
          },
          "refocus_conversation": {
            "type": "boolean",
            "description": "Whether to actively redirect to appropriate product topics"
          }
        }
      }
    }
  }
}
```

### 4. Impossible Request Rejection
```json
{
  "Handle_OutOfScope_Requests": {
    "Reject_Impossible": {
      "API_RejectImpossibleRequest": {
        "description": "Handle requests for contradictory specifications, non-existent features, physically impossible modifications, or unrealistic product capabilities",
        "parameters": {
          "impossibility_type": {
            "type": "string",
            "enum": ["contradictory_specs", "non_existent_feature", "physical_impossibility", "unrealistic_modification", "fictional_capability"],
            "description": "Type of impossible request"
          },
          "reality_check": {
            "type": "string",
            "description": "Brief explanation of what is actually possible"
          },
          "alternative_suggestion": {
            "type": "string", 
            "description": "Realistic alternative that might meet their needs"
          },
          "maintain_helpfulness": {
            "type": "boolean",
            "default": true,
            "description": "Whether to offer alternative solutions"
          }
        }
      }
    }
  }
}
```

## Usage Guidelines

### When to Use Each API:

**API_RejectInappropriate:**
- Personal information requests
- Harassment or offensive language  
- Sexual or violent content
- Privacy violations
- Attempts to move conversation to personal channels

**API_RejectTechnicalSupport:**
- Complex installation procedures
- Advanced troubleshooting beyond basic guidance
- Professional repair instructions
- Enterprise-level configuration
- Technical integrations requiring expertise

**API_RejectScopeViolation:**
- Questions about competitor products
- Requests for legal or medical advice
- Financial planning guidance
- Unrelated services or products
- Third-party platform integration

**API_RejectImpossibleRequest:**
- Contradictory product specifications
- Features that don't exist in reality
- Physically impossible modifications
- Time travel or supernatural capabilities
- Requests that violate laws of physics

### Response Quality Standards:

1. **Professional Tone**: Always maintain courtesy and respect
2. **Clear Boundaries**: Explicitly state limitations without apology
3. **Helpful Redirect**: When possible, guide toward appropriate topics
4. **Concise Explanation**: Brief reason for decline without lengthy justification
5. **Positive Engagement**: Keep conversation open for legitimate inquiries

### Example API Calls:

```json
// Inappropriate content example
{
  "action_list": ["API_RejectInappropriate"],
  "parameters": {
    "rejection_reason": "personal_information",
    "redirect_to_product": true,
    "response_tone": "professional"
  }
}

// Technical limitation example  
{
  "action_list": ["API_RejectTechnicalSupport"],
  "parameters": {
    "limitation_type": "professional_installation", 
    "suggest_alternative": "certified technician or manufacturer support",
    "basic_info_offered": true
  }
}

// Scope violation example
{
  "action_list": ["API_RejectScopeViolation"],
  "parameters": {
    "violation_type": "competitor_inquiry",
    "scope_clarification": "I focus specifically on this product",
    "refocus_conversation": true
  }
}

// Impossible request example
{
  "action_list": ["API_RejectImpossibleRequest"],
  "parameters": {
    "impossibility_type": "contradictory_specs",
    "reality_check": "Products cannot be simultaneously waterproof and fully breathable",
    "alternative_suggestion": "Water-resistant with good breathability",
    "maintain_helpfulness": true
  }
}
```