How to Use Jev AI: 7 Access Routes & Working Code

import os
from typesafe_sdk import TypeSafeClient, Noul, NoulCriteria

# Define discrete evaluation criteria with explicit boundary definitions
SUPPORT_QUESTIONS = {
    "is_human_escalation": Noul(
        instructions="Is the customer explicitly demanding or requesting to speak with a human agent or supervisor?",
        criteria=NoulCriteria(
            true="Customer mentions speaking to a human, agent, person, manager, or representative",
            false="Customer asks general technical or billing questions without demanding human takeover",
        ),
    ),
    "is_repeat_contact": Noul(
        instructions="Has the customer indicated they previously reached out about this unresolved problem?",
        criteria=NoulCriteria(
            true="Explicitly mentions prior tickets, multiple attempts, or prolonged waiting on an ongoing issue",
            false="First-time inquiry or no indication of past interactions",
        ),
    ),
}

# Calibrated decision thresholds
CONFIDENCE_HIGH = 0.80
CONFIDENCE_LOW = 0.20

def route_support_ticket(message: str) -> dict:
    """Evaluates ticket state and dispatches deterministic routing instructions."""
    api_key = os.environ.get("TYPESAFE_API_KEY")
    with TypeSafeClient(api_key=api_key) as client:
        result = client.system_one(
            model="jev-latest",
            state=message,
            questions=SUPPORT_QUESTIONS
        )

    wants_human = result.answers["is_human_escalation"].noul
    is_repeat = result.answers["is_repeat_contact"].noul

    # Ambiguity Gate: If probability is uncertain (between 0.20 and 0.80), route to triage queue
    if CONFIDENCE_LOW < wants_human < CONFIDENCE_HIGH or CONFIDENCE_LOW < is_repeat < CONFIDENCE_HIGH:
        return {
            "route": "manual_triage_review",
            "reason": "Calibrated score falls in uncertainty band",
            "scores": {"wants_human": wants_human, "is_repeat": is_repeat}
        }

    priority = "p0_urgent" if is_repeat >= CONFIDENCE_HIGH else "p2_normal"
    target = "senior_human_queue" if wants_human >= CONFIDENCE_HIGH else "ai_automated_responder"

    return {
        "route": target,
        "priority": priority,
        "scores": {"wants_human": wants_human, "is_repeat": is_repeat}
    }