| """Tool schema for the create_alert_subscription LLM tool.""" |
|
|
| CREATE_ALERT_SUBSCRIPTION_TOOL = { |
| "type": "function", |
| "function": { |
| "name": "create_alert_subscription", |
| "description": ( |
| "Create a PENDING alert subscription. Never call until you have: " |
| "condition type, target (market or property), and email address. " |
| "Does not activate the alert — confirmation happens via email link." |
| ), |
| "parameters": { |
| "type": "object", |
| "properties": { |
| "email": { |
| "type": "string", |
| "description": "User's email address for receiving alerts", |
| }, |
| "criteria_type": { |
| "type": "string", |
| "enum": [ |
| "spike", "rate_change", "price_threshold", |
| "availability_change", "new_listing", "tracking_removed", |
| "anomaly", "volatility", "trend_reversal", "digest", |
| ], |
| "description": "Type of condition to monitor", |
| }, |
| "criteria": { |
| "type": "object", |
| "description": ( |
| "Type-specific parameters. Examples: " |
| "spike: {market, threshold_pct}; " |
| "rate_change: {market, direction: both|up|down}; " |
| "price_threshold: {property_search, operator: above|below, value}; " |
| "availability_change: {property_search, watch_for: available|unavailable|any}; " |
| "new_listing/tracking_removed: {market}; " |
| "anomaly: {property_search, deviation_threshold}; " |
| "volatility: {market, top_n}; " |
| "trend_reversal: {market, watch_for: rising|falling}; " |
| "digest: {market, frequency: daily|weekly}" |
| ), |
| }, |
| "raw_request_text": { |
| "type": "string", |
| "description": "Original user request verbatim", |
| }, |
| }, |
| "required": ["email", "criteria_type", "criteria", "raw_request_text"], |
| }, |
| }, |
| } |
|
|
