description: Industry Wizards API reference: Domain-specific AI assistants with built-in security, compliance, and industry best practices. ## Ov¶

Industry Wizards¶

Domain-specific AI assistants with built-in security, compliance, and industry best practices.

Overview¶

Attune AI includes industry-specific wizards that provide:

Built-in Security - PII scrubbing, secrets detection, audit logging
Domain Knowledge - Industry-specific prompts and workflows
Compliance Ready - HIPAA, SOC2, GDPR, industry regulations
Easy Integration - Drop-in components for any application

Quick Start¶

Choose Your Industry

Click the tab for your industry to see the specialized wizard documentation.

Healthcare Finance Legal Retail Education HR Technology More Industries

Healthcare Wizards¶

17 HIPAA-compliant AI assistants for medical applications with enhanced PHI protection.

Key Features¶

Enhanced PHI Protection - 10+ medical patterns (MRN, Patient ID, DOB, etc.)
Mandatory Encryption - AES-256-GCM for all PHI
90-Day Retention - HIPAA §164.528 compliance
Comprehensive Audit Trail - HIPAA §164.312(b) compliant
$2M+ Annual ROI - For 100-bed hospitals

Quick Example¶

from attune_llm import EmpathyLLM
from attune_llm.wizards import HealthcareWizard

# Initialize with security enabled
llm = EmpathyLLM(
    provider="anthropic",
    api_key=os.getenv("ANTHROPIC_API_KEY"),
    enable_security=True
)

# Create HIPAA-compliant wizard
wizard = HealthcareWizard(llm)

# Process patient information (PHI is automatically scrubbed)
result = await wizard.process(
    user_input="Patient John Doe (MRN 123456) needs follow-up for diabetes",
    user_id="doctor@hospital.com"
)

# PHI was removed before sending to LLM
print(result['security_report']['phi_removed'])  # ['mrn', 'name']

What PHI Patterns Are Detected?

Standard PII: - Email addresses - Phone numbers - SSN - Physical addresses - Credit card numbers - IP addresses

Healthcare-Specific PHI: - MRN - Medical Record Numbers - Patient IDs - Patient identifiers - DOB - Dates of birth - Insurance IDs - Insurance/policy numbers - Provider NPI - National Provider Identifiers - CPT Codes - Medical procedure codes - ICD Codes - Diagnosis codes - Medications - Drug names (optional, configurable)

Clinical Handoff (SBAR Protocol)

wizard = HealthcareWizard(llm)

# Generate SBAR handoff report
result = await wizard.generate_handoff(
    patient_id="PT123456",
    protocol="SBAR",  # Situation, Background, Assessment, Recommendation
    handoff_type="shift_change"
)

print(result['sbar_report'])
# Output:
# **Situation:** 65yo male, chest pain x2h, vitals stable
# **Background:** Hx of MI 2018, on aspirin, metoprolol
# **Assessment:** Possible STEMI, EKG shows ST elevation
# **Recommendation:** Activate cath lab, continue monitoring

HIPAA Compliance Requirements

To maintain HIPAA compliance:

✅ Enable security: EmpathyLLM(enable_security=True)
✅ Use encryption at rest for stored data
✅ Review audit logs daily
✅ Implement access controls
✅ Sign Business Associate Agreement with LLM provider

See Also: SBAR Clinical Handoff Example

Finance Wizard¶

SOC2-compliant AI assistant for financial services with enhanced PII/PCI protection.

Key Features¶

PCI DSS Compliance - Credit card detection and masking
Financial PII - Account numbers, routing numbers, SSN
Risk Analysis - AML, fraud detection, compliance checks
Audit Trail - SOC2 Type II compliant logging

Quick Example¶

from attune_llm.wizards import FinanceWizard

wizard = FinanceWizard(llm)

# Analyze transaction for compliance
result = await wizard.analyze_transaction(
    transaction_data={
        "amount": 15000,
        "source_account": "****1234",
        "destination_account": "****5678",
        "country": "US"
    },
    check_aml=True,
    check_fraud=True
)

if result['flags']:
    print(f"⚠️  Compliance flags: {result['flags']}")

What Financial PII Is Protected?

Credit Card Numbers - Full card number detection and masking
Account Numbers - Bank account numbers
Routing Numbers - ABA routing numbers
SSN - Social Security Numbers
ITIN - Individual Taxpayer Identification Numbers
EIN - Employer Identification Numbers
Investment Account IDs - Brokerage account numbers

Risk Analysis Features

The Finance Wizard includes built-in risk analysis:

AML (Anti-Money Laundering) - Flags suspicious transactions
Fraud Detection - Pattern-based fraud indicators
Sanctions Screening - OFAC compliance checks
KYC Validation - Know Your Customer verification

Legal Wizard¶

AI assistant for legal practices with document classification and privilege protection.

Key Features¶

Attorney-Client Privilege - Automatic privilege detection
Document Classification - Contract, brief, discovery types
Legal Citation - Find relevant case law
Confidentiality - Work product protection

Quick Example¶

from attune_llm.wizards import LegalWizard

wizard = LegalWizard(llm)

# Analyze legal document
result = await wizard.analyze_document(
    document_text="...",
    document_type="contract",
    jurisdiction="CA"
)

print(result['risk_factors'])
print(result['suggested_clauses'])

Contract Review

# Review contract for risks
result = await wizard.review_contract(
    contract_text="...",
    contract_type="employment",
    jurisdiction="CA",
    check_for=[
        "non_compete",
        "indemnification",
        "termination",
        "ip_assignment"
    ]
)

# Get risk assessment
for risk in result['risks']:
    print(f"{risk['severity']}: {risk['description']}")
    print(f"Suggested fix: {risk['remediation']}")

Retail Wizard¶

AI assistant for e-commerce and retail operations.

Key Features¶

Inventory Management - Stock optimization suggestions
Pricing Strategy - Dynamic pricing recommendations
Customer Service - Support automation
Sales Analytics - Trend analysis

Quick Example¶

from attune_llm.wizards import RetailWizard

wizard = RetailWizard(llm)

# Optimize inventory
result = await wizard.optimize_inventory(
    product_data={
        "sku": "PROD123",
        "current_stock": 50,
        "sales_last_30d": 120,
        "season": "winter"
    }
)

print(result['reorder_quantity'])
print(result['optimal_price'])

Education Wizard¶

FERPA-compliant AI assistant for educational institutions.

Key Features¶

Student Privacy - FERPA compliance (20 U.S.C. § 1232g)
:material-account-student: Student PII Protection - Student IDs, grades, records
Assignment Grading - Automated assessment assistance
Curriculum Support - Lesson plan generation

Quick Example¶

from attune_llm.wizards import EducationWizard

wizard = EducationWizard(llm)

# Generate lesson plan (no student PII exposed)
result = await wizard.generate_lesson_plan(
    subject="Mathematics",
    grade_level=8,
    topic="Linear Equations",
    duration_minutes=45
)

print(result['lesson_plan'])
print(result['assessment_questions'])

HR Wizard¶

AI assistant for human resources with employee PII protection.

Key Features¶

Employee PII Protection - SSN, DOB, salary, benefits
Job Descriptions - Generate JD from requirements
Resume Screening - Bias-free candidate evaluation
Compliance - EEOC, ADA, FLSA guidance

Quick Example¶

from attune_llm.wizards import HRWizard

wizard = HRWizard(llm)

# Generate job description
result = await wizard.generate_job_description(
    title="Senior Software Engineer",
    department="Engineering",
    level="Senior",
    requirements=["Python", "AWS", "5+ years experience"]
)

print(result['job_description'])

Technology Wizard¶

AI assistant for software development and IT operations.

Key Features¶

Bug Analysis - Root cause identification
Code Review - Security and quality checks
Cloud Architecture - AWS/Azure/GCP design patterns
Security Scanning - Vulnerability detection

Quick Example¶

from attune_llm.wizards import TechnologyWizard

wizard = TechnologyWizard(llm)

# Analyze code for security issues
result = await wizard.review_code(
    code=code_snippet,
    language="python",
    check_for=["sql_injection", "xss", "secrets"]
)

for issue in result['security_issues']:
    print(f"{issue['severity']}: {issue['description']}")

Additional Wizards¶

Accounting Wizard¶

AI assistant for accounting and bookkeeping - GAAP/IFRS compliance - Financial statement analysis - Tax preparation assistance

Customer Support Wizard¶

AI assistant for customer service operations - Ticket classification - Response templates - Sentiment analysis

Government Wizard¶

AI assistant for government agencies - FOIA compliance - Public records management - Citizen service automation

Insurance Wizard¶

AI assistant for insurance operations - Claims processing - Underwriting assistance - Risk assessment

Logistics Wizard¶

AI assistant for supply chain and logistics - Route optimization - Inventory forecasting - Shipment tracking

Manufacturing Wizard¶

AI assistant for manufacturing operations - Production scheduling - Quality control - Equipment maintenance

Real Estate Wizard¶

AI assistant for real estate professionals - Property valuation - Lease generation - Market analysis

Research Wizard¶

AI assistant for academic and scientific research - Literature review - Citation management - Data analysis

Sales Wizard¶

AI assistant for sales teams - Lead qualification - Proposal generation - CRM integration

Base Wizard API¶

All wizards extend the BaseWizard class with common functionality:

BaseWizard¶

class BaseWizard:
    """Base class for all industry wizards.

    Provides common wizard lifecycle: start -> collect steps -> preview -> approve -> save.
    """
    def start(self) -> dict: ...
    def submit_step(self, wizard_id: str, data: dict) -> dict: ...
    def preview(self, wizard_id: str) -> dict: ...
    def save(self, wizard_id: str, approval: dict) -> dict: ...

WizardConfig¶

@dataclass
class WizardConfig:
    """Configuration for wizard instances."""
    name: str
    industry: str
    steps: list[str]
    security_level: str = "standard"

Configuration options:

name (str): Wizard identifier
domain (str): Industry domain (healthcare, finance, legal, etc.)
default_empathy_level (int): Empathy level 0-4 (default: 2)
enable_security (bool): Enable PII/secrets detection
pii_patterns (list): Custom PII patterns to detect
enable_secrets_detection (bool): Scan for API keys, passwords
audit_all_access (bool): Log all wizard interactions
retention_days (int): Audit log retention (default: 180 days)
default_classification (str): Data classification (PUBLIC, INTERNAL, SENSITIVE)

Creating Custom Wizards¶

Build Your Own Domain-Specific Wizard

You can create custom wizards for your specific industry:

from attune_llm.wizards import BaseWizard, WizardConfig
from attune_llm import EmpathyLLM

class MyIndustryWizard(BaseWizard):
    """Custom wizard for my industry"""

    def __init__(self, llm: EmpathyLLM):
        config = WizardConfig(
            name="my_industry",
            domain="custom",
            description="AI assistant for my industry",
            enable_security=True,
            pii_patterns=["custom_pattern"],
            default_classification="INTERNAL"
        )
        super().__init__(llm, config)

    async def process(self, user_input: str, user_id: str):
        """Custom processing logic"""

        # Add domain-specific prompts
        enhanced_prompt = f"""
        You are an AI assistant specialized in {self.config.domain}.

        User request: {user_input}
        """

        # Use parent LLM with security enabled
        response = await self.llm.interact(
            user_id=user_id,
            prompt=enhanced_prompt,
            context={"wizard": self.config.name}
        )

        return response

# Use your custom wizard
llm = EmpathyLLM(provider="anthropic", api_key="...")
wizard = MyIndustryWizard(llm)

result = await wizard.process(
    user_input="Help me with industry-specific task",
    user_id="user@company.com"
)

Security Best Practices¶

Production Security Checklist

For all wizards in production:

[ ] Enable security features: enable_security=True
[ ] Configure appropriate PII patterns for your industry
[ ] Enable secrets detection: enable_secrets_detection=True
[ ] Enable audit logging: audit_all_access=True
[ ] Set correct data classification
[ ] Review audit logs regularly
[ ] Test PII scrubbing before production
[ ] Implement access controls
[ ] Encrypt data at rest
[ ] Sign appropriate compliance agreements (BAA for HIPAA, DPA for GDPR)

Classification Levels

PUBLIC - No PII, can be shared publicly

INTERNAL - Internal business data, PII scrubbed

SENSITIVE - PHI, financial data, legal privileged - requires encryption

description: Industry Wizards API reference: Domain-specific AI assistants with built-in security, compliance, and industry best practices. ## Ov¶

Industry Wizards¶

Overview¶

Quick Start¶

Healthcare Wizards¶

Key Features¶

Quick Example¶

Finance Wizard¶

Key Features¶

Quick Example¶

Legal Wizard¶

Key Features¶

Quick Example¶

Retail Wizard¶

Key Features¶

Quick Example¶

Education Wizard¶

Key Features¶

Quick Example¶

HR Wizard¶

Key Features¶

Quick Example¶

Technology Wizard¶

Key Features¶

Quick Example¶

Additional Wizards¶

Accounting Wizard¶

Customer Support Wizard¶

Government Wizard¶

Insurance Wizard¶

Logistics Wizard¶

Manufacturing Wizard¶

Real Estate Wizard¶

Research Wizard¶

Sales Wizard¶

Base Wizard API¶

BaseWizard¶

WizardConfig¶

Creating Custom Wizards¶

Security Best Practices¶

See Also¶