Hesperan

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['state', 'questions'], 'properties': {'state': {'anyOf': [{'type': 'string'}, {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}], 'description': 'The situation to judge: free text, or a JSON object (keeps dates, amounts and fields unambiguous). Leave out data that does not matter for the question.'}, 'questions': {'type': 'object', 'description': 'Named questions, answered together: { "<name>": { "type": "choice" | "noul" | "score", "instructions": "...", "criteria": ... } }.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'oneOf': [{'type': 'object', 'required': ['type', 'instructions', 'criteria'], 'properties': {'type': {'type': 'string', 'const': 'choice'}, 'criteria': {'type': 'object', 'description': 'Option key -> plain-language description of what the option means. Mutually exclusive; add an "other" option if the list is not complete. Up to about 26 options work best.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'string'}}, 'instructions': {'type': 'string', 'description': 'The question, e.g. "Which team should handle this ticket?"'}}, 'description': 'Pick one of named options. Answer: choice and a probability per option.'}, {'type': 'object', 'required': ['type', 'instructions'], 'properties': {'type': {'type': 'string', 'const': 'noul'}, 'criteria': {'type': 'object', 'properties': {'true': {'type': 'string'}, 'false': {'type': 'string'}}, 'description': 'Optional: what counts as yes and as no.'}, 'instructions': {'type': 'string', 'description': 'A statement (not a question), e.g. "This email is a phishing attempt."'}}, 'description': 'Probability that a statement is true. Answer: noul = P(yes).'}, {'type': 'object', 'required': ['type', 'instructions', 'criteria'], 'properties': {'type': {'type': 'string', 'const': 'score'}, 'criteria': {'type': 'array', 'items': {'type': 'string'}, 'minItems': 2, 'description': 'One description per level, lowest first.'}, 'instructions': {'type': 'string', 'description': 'What to rate, e.g. "How upset is the customer?"'}}, 'description': 'Rate on an ordinal scale you define. Answer: score = expected level, plus a probability per level ("0", "1", ...).'}]}}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['profile', 'state'], 'properties': {'state': {'anyOf': [{'type': 'string'}, {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}], 'description': 'The situation to judge: free text, or a JSON object (keeps dates, amounts and fields unambiguous). Leave out data that does not matter for the question.'}, 'profile': {'type': 'string', 'minLength': 1, 'description': 'Slug of the decision profile, e.g. "ticket-routing".'}, 'idempotency_key': {'type': 'string', 'pattern': '^[\\x21-\\x7e]{1,255}$', 'description': 'Optional unique key for this decision (1-255 visible ASCII characters, e.g. the ticket id). Reusing it within 24 hours with the same state replays the stored decision.'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['decision_id', 'actual'], 'properties': {'actual': {'type': 'string', 'minLength': 1, 'description': 'The correct option key.'}, 'decision_id': {'type': 'string', 'minLength': 1, 'description': 'decision_id returned by decide_with_profile.'}}}