200 lines
7.6 KiB
Python
200 lines
7.6 KiB
Python
|
"""Action mapper — maps natural language intents to proposed API calls.
|
||
|
|
|
||
|
|
Used by the mock LLM client for test mode and as a fallback.
|
||
|
|
Supports keyword-based intent detection for common CRM operations.
|
||
|
|
"""
|
||
|
|
|
||
|
|
from __future__ import annotations
|
||
|
|
|
||
|
|
import re
|
||
|
|
from typing import Any
|
||
|
|
|
||
|
|
|
||
|
|
# Precompiled patterns for intent detection
|
||
|
|
_PATTERNS = {
|
||
|
|
'create_company': re.compile(r'\b(create|add|new)\b.*\b(company|firm|organization|organisation)\b', re.IGNORECASE),
|
||
|
|
'delete_company': re.compile(r'\b(delete|remove)\b.*\b(company|firm)\b', re.IGNORECASE),
|
||
|
|
'update_company': re.compile(r'\b(update|edit|modify|change)\b.*\b(company|firm)\b', re.IGNORECASE),
|
||
|
|
'list_company': re.compile(r'\b(list|show|find|search|get|display)\b.*\b(compan|firm)\b', re.IGNORECASE),
|
||
|
|
'list_company2': re.compile(r'\bcompan.*\b(list|all)\b', re.IGNORECASE),
|
||
|
|
'create_contact': re.compile(r'\b(create|add|new)\b.*\b(contact|person)\b', re.IGNORECASE),
|
||
|
|
'list_contact': re.compile(r'\b(list|show|find|search|get|display)\b.*\b(contact|person)\b', re.IGNORECASE),
|
||
|
|
'list_workflow': re.compile(r'\b(list|show|get|display)\b.*\b(workflow)\b', re.IGNORECASE),
|
||
|
|
'create_workflow': re.compile(r'\b(create|new|add)\b.*\b(workflow)\b', re.IGNORECASE),
|
||
|
|
'help': re.compile(r'\b(help|what can you do|assist)\b', re.IGNORECASE),
|
||
|
|
}
|
||
|
|
|
||
|
|
# Name extraction patterns - using single-quoted strings to avoid escaping issues
|
||
|
|
_NAME_PATTERNS = [
|
||
|
|
re.compile(r"\b(?:named|called|for)\s+['\"]?([^'\".,]+)['\"]?", re.IGNORECASE),
|
||
|
|
re.compile(r"\bcompany\s+['\"]?([^'\".,]+)['\"]?", re.IGNORECASE),
|
||
|
|
re.compile(r"\bcontact\s+['\"]?([^'\".,]+)['\"]?", re.IGNORECASE),
|
||
|
|
re.compile(r"\bworkflow\s+['\"]?([^'\".,]+)['\"]?", re.IGNORECASE),
|
||
|
|
re.compile(r"\bfirm\s+['\"]?([^'\".,]+)['\"]?", re.IGNORECASE),
|
||
|
|
re.compile(r"\bperson\s+['\"]?([^'\".,]+)['\"]?", re.IGNORECASE),
|
||
|
|
]
|
||
|
|
|
||
|
|
# Field extraction patterns
|
||
|
|
_INDUSTRY_PAT = re.compile(r"industry\s+(?:to|:)?\s+['\"]?([^'\".,]+)['\"]?", re.IGNORECASE)
|
||
|
|
_NAME_UPDATE_PAT = re.compile(r"(?:name|rename)\s+(?:to|:)?\s+['\"]?([^'\".,]+)['\"]?", re.IGNORECASE)
|
||
|
|
_PHONE_PAT = re.compile(r"phone\s+(?:to|:)?\s+['\"]?([^'\".,]+)['\"]?", re.IGNORECASE)
|
||
|
|
_EMAIL_PAT = re.compile(r"email\s+(?:to|:)?\s+['\"]?([^'\".,]+)['\"]?", re.IGNORECASE)
|
||
|
|
_SEARCH_PAT = re.compile(r"\b(?:named|called|matching|with name)\s+['\"]?([^'\".,]+)['\"]?", re.IGNORECASE)
|
||
|
|
|
||
|
|
|
||
|
|
def map_query_to_actions(query: str, context: dict[str, Any] | None = None) -> list[dict[str, Any]]:
|
||
|
|
"""Map a natural language query to proposed API actions.
|
||
|
|
|
||
|
|
Uses keyword matching to detect intents. Returns a list of proposed
|
||
|
|
action dictionaries with method, path, body, description, and confidence.
|
||
|
|
"""
|
||
|
|
context = context or {}
|
||
|
|
q = query.lower().strip()
|
||
|
|
actions: list[dict[str, Any]] = []
|
||
|
|
|
||
|
|
# --- Company intents ---
|
||
|
|
if _PATTERNS['create_company'].search(q):
|
||
|
|
name = _extract_name(query)
|
||
|
|
actions.append({
|
||
|
|
'method': 'POST',
|
||
|
|
'path': '/api/v1/companies',
|
||
|
|
'body': {'name': name or 'New Company'},
|
||
|
|
'description': f"Create a new company named '{name or 'New Company'}'",
|
||
|
|
'confidence': 0.9,
|
||
|
|
})
|
||
|
|
|
||
|
|
elif _PATTERNS['delete_company'].search(q):
|
||
|
|
entity_id = context.get('company_id') or context.get('entity_id')
|
||
|
|
if entity_id:
|
||
|
|
actions.append({
|
||
|
|
'method': 'DELETE',
|
||
|
|
'path': f'/api/v1/companies/{entity_id}',
|
||
|
|
'body': None,
|
||
|
|
'description': f'Delete company {entity_id}',
|
||
|
|
'confidence': 0.9,
|
||
|
|
})
|
||
|
|
else:
|
||
|
|
actions.append({
|
||
|
|
'method': 'DELETE',
|
||
|
|
'path': '/api/v1/companies/{id}',
|
||
|
|
'body': None,
|
||
|
|
'description': 'Delete a company (requires company ID in context or selection)',
|
||
|
|
'confidence': 0.5,
|
||
|
|
})
|
||
|
|
|
||
|
|
elif _PATTERNS['update_company'].search(q):
|
||
|
|
entity_id = context.get('company_id') or context.get('entity_id')
|
||
|
|
path = f'/api/v1/companies/{entity_id}' if entity_id else '/api/v1/companies/{id}'
|
||
|
|
actions.append({
|
||
|
|
'method': 'PATCH',
|
||
|
|
'path': path,
|
||
|
|
'body': _extract_update_fields(query),
|
||
|
|
'description': 'Update company information',
|
||
|
|
'confidence': 0.8,
|
||
|
|
})
|
||
|
|
|
||
|
|
elif _PATTERNS['list_company'].search(q) or _PATTERNS['list_company2'].search(q):
|
||
|
|
search_term = _extract_search_term(query)
|
||
|
|
desc = 'List companies'
|
||
|
|
if search_term:
|
||
|
|
desc += f" matching '{search_term}'"
|
||
|
|
actions.append({
|
||
|
|
'method': 'GET',
|
||
|
|
'path': '/api/v1/companies',
|
||
|
|
'body': None,
|
||
|
|
'description': desc,
|
||
|
|
'confidence': 0.85,
|
||
|
|
})
|
||
|
|
|
||
|
|
# --- Contact intents ---
|
||
|
|
elif _PATTERNS['create_contact'].search(q):
|
||
|
|
name = _extract_name(query)
|
||
|
|
actions.append({
|
||
|
|
'method': 'POST',
|
||
|
|
'path': '/api/v1/contacts',
|
||
|
|
'body': {'name': name or 'New Contact'},
|
||
|
|
'description': f"Create a new contact named '{name or 'New Contact'}'",
|
||
|
|
'confidence': 0.9,
|
||
|
|
})
|
||
|
|
|
||
|
|
elif _PATTERNS['list_contact'].search(q):
|
||
|
|
actions.append({
|
||
|
|
'method': 'GET',
|
||
|
|
'path': '/api/v1/contacts',
|
||
|
|
'body': None,
|
||
|
|
'description': 'List contacts',
|
||
|
|
'confidence': 0.85,
|
||
|
|
})
|
||
|
|
|
||
|
|
# --- Workflow intents ---
|
||
|
|
elif _PATTERNS['list_workflow'].search(q):
|
||
|
|
actions.append({
|
||
|
|
'method': 'GET',
|
||
|
|
'path': '/api/v1/workflows',
|
||
|
|
'body': None,
|
||
|
|
'description': 'List workflows',
|
||
|
|
'confidence': 0.85,
|
||
|
|
})
|
||
|
|
|
||
|
|
elif _PATTERNS['create_workflow'].search(q):
|
||
|
|
name = _extract_name(query)
|
||
|
|
actions.append({
|
||
|
|
'method': 'POST',
|
||
|
|
'path': '/api/v1/workflows',
|
||
|
|
'body': {'name': name or 'New Workflow', 'steps': []},
|
||
|
|
'description': 'Create a new workflow',
|
||
|
|
'confidence': 0.8,
|
||
|
|
})
|
||
|
|
|
||
|
|
# --- Generic fallback ---
|
||
|
|
if not actions:
|
||
|
|
if _PATTERNS['help'].search(q):
|
||
|
|
actions.append({
|
||
|
|
'method': 'GET',
|
||
|
|
'path': '/api/v1/companies',
|
||
|
|
'body': None,
|
||
|
|
'description': 'Show available companies (demonstration action)',
|
||
|
|
'confidence': 0.3,
|
||
|
|
})
|
||
|
|
|
||
|
|
return actions
|
||
|
|
|
||
|
|
|
||
|
|
def _extract_name(query: str) -> str | None:
|
||
|
|
"""Extract a name from the query, looking for 'named X', 'called X', 'for X'."""
|
||
|
|
for pat in _NAME_PATTERNS:
|
||
|
|
match = pat.search(query)
|
||
|
|
if match:
|
||
|
|
return match.group(1).strip()
|
||
|
|
return None
|
||
|
|
|
||
|
|
|
||
|
|
def _extract_search_term(query: str) -> str | None:
|
||
|
|
"""Extract a search term from the query."""
|
||
|
|
match = _SEARCH_PAT.search(query)
|
||
|
|
if match:
|
||
|
|
return match.group(1).strip()
|
||
|
|
return None
|
||
|
|
|
||
|
|
|
||
|
|
def _extract_update_fields(query: str) -> dict[str, Any]:
|
||
|
|
"""Extract fields to update from the query."""
|
||
|
|
fields: dict[str, Any] = {}
|
||
|
|
if re.search(r'\bindustry\b', query, re.IGNORECASE):
|
||
|
|
match = _INDUSTRY_PAT.search(query)
|
||
|
|
if match:
|
||
|
|
fields['industry'] = match.group(1).strip()
|
||
|
|
if re.search(r'\b(name|rename)\b', query, re.IGNORECASE):
|
||
|
|
match = _NAME_UPDATE_PAT.search(query)
|
||
|
|
if match:
|
||
|
|
fields['name'] = match.group(1).strip()
|
||
|
|
if re.search(r'\bphone\b', query, re.IGNORECASE):
|
||
|
|
match = _PHONE_PAT.search(query)
|
||
|
|
if match:
|
||
|
|
fields['phone'] = match.group(1).strip()
|
||
|
|
if re.search(r'\bemail\b', query, re.IGNORECASE):
|
||
|
|
match = _EMAIL_PAT.search(query)
|
||
|
|
if match:
|
||
|
|
fields['email'] = match.group(1).strip()
|
||
|
|
return fields or {'name': 'Updated Name'}
|