What Questions Should an Education Chatbot Answer First?

from typing import Optional, Dict, Any
import httpx

async def resolve_student_financial_status(student_banner_id: str, bearer_token: str) -> Dict[str, Any]:
    """Queries Ellucian Banner SIS via Ethos API to retrieve financial holds & balance."""
    headers = {
        "Authorization": f"Bearer {bearer_token}",
        "Accept": "application/vnd.hedtech.integration.v7+json"
    }
    
    async with httpx.AsyncClient(base_url="https://ethos.campus.edu/api") as client:
        # Step 1: Query student account balance
        account_resp = await client.get(f"/student-accounts/{student_banner_id}", headers=headers)
        account_data = account_resp.json()
        
        # Step 2: Query active administrative holds (registration / graduation holds)
        holds_resp = await client.get(f"/student-holds?student={student_banner_id}", headers=headers)
        holds_data = holds_resp.json()

    balance_cents = account_data.get("currentBalanceCents", 0)
    has_bursar_hold = any(h.get("category") == "FINANCIAL" for h in holds_data)
    
    return {
        "banner_id": student_banner_id,
        "balance_formatted": f"${balance_cents / 100:,.2f}",
        "has_active_hold": has_bursar_hold,
        "payment_due_date": account_data.get("dueDate", "2027-01-15"),
        "installment_plan_eligible": balance_cents > 50000
    }