FIELD NOTES / JEV AI USE CASES
Jev AI use cases: where a decision model fits, with one worked example
Jev AI use cases share one shape: software has a judgment to make, a closed set of possible answers, and code ready to act on the result. This guide sorts the documented uses by question type, then shows one of them running end to end in Jevs Village.
At a glance
- Jev suits judgments with a closed set of answers: routing, scoring, verification, retrieval filtering, and agent action selection.
- Jev does not generate text; pair it with a language model when you need prose or explanations.
- Jevs Village uses Choice questions for actions and memory selection, and Noul questions for sleep-time memory retention.
- TypeSafe’s speed and cost figures are vendor claims to test against your own workload.
What kind of task suits Jev?
TypeSafe positions Jev as a System One model for structured decisions, and its documentation describes the target as fuzzy decision rules: places where hand-written logic is too brittle, such as classifying, routing, scoring, extracting, or branching. Jev does not write text. It returns typed values with probabilities, and Choice and Score also return confidence.
A useful test is whether a knowledgeable person could make the call in a few seconds given the right context. If a judgment needs extended reasoning or weighs several independent factors, TypeSafe’s guidance is to split it into separate questions and combine the answers in code, where you control the weighting.
Use cases in TypeSafe’s documentation
TypeSafe’s documentation and cookbooks cover a range of concrete workflows. The groups below summarise what those pages describe; they are not performance claims from this site.
- Routing and classification: sending incoming requests to a deterministic handler, a specialist model, or a person, and classifying documents through deep category hierarchies.
- Scoring and matching: breaking a complex judgment into atomic scores combined by weights you control, or deciding whether two records describe the same thing.
- Guardrails and verification: screening messages into and out of a language-model application, and checking whether a cited passage supports a claim.
- Retrieval quality: scoring retrieved passages so that only relevant ones reach an answering model, and re-ranking a shortlist of candidates.
- Agent tool choice: selecting a function or a skill for an agent turn from a defined catalogue.
- Real-time applications: TypeSafe claims end-to-end response times of 70 to 500 milliseconds, which it says makes decisions practical where the user experience is critical. Treat that as a vendor figure to test for your own workload.
Match the question type to the use case
- Choice selects one option from a list and returns probabilities and confidence. It fits routing, tool selection, and picking an action.
- Score rates something against ordered levels and returns probabilities and confidence. It fits prioritisation, quality grading, and rubric checks.
- Noul returns the probability that a yes-or-no statement is true. It fits verification and retention-style questions.
- All three can be mixed in one request, and each is evaluated in parallel and in isolation against the same state.
A worked example: a village that decides
Jevs Village uses three of these patterns in one place. It is a persistent simulation with six inhabitants, and each pattern answers a different question about the same world.
First, a Choice question selects an action for an inhabitant from the legal options the world supplies. Mira may work, rest, or interact, depending on what the rules permit at that moment. This is the routing pattern applied to a character’s next move.
Second, a Choice question selects which remembered experiences are relevant to the decision at hand. The village retrieves candidates from the inhabitant’s own episodes and asks Jev to pick the useful evidence. This is the retrieval-quality pattern applied to personal history.
Third, a Noul question asks how worthwhile an experience is for lasting recall during sleep-time review. This is a verification-style yes-or-no judgment, and code turns its probability into a retention decision while protecting active obligations. In each case code offers the options, validates the result, and keeps the consequences.
What Jev is not for
Jev gives up string generation. It is not a chat model, a summariser, or a writer, and it does not explain its reasoning in prose. The village therefore uses a separate language model to narrate committed events, and that narration never becomes world state.
Decisions that need a written justification, or that carry high consequences for a person, still need a human or a different approach. Jev’s confidence is a signal about the shape of an answer, not proof of correctness, and the model was in early access when this guide was written.
How to choose a first Jev use case
- Start with a decision your code already makes badly, such as a brittle chain of if-statements or a manual triage step.
- Write down the closed set of answers. If you cannot list the options, the question is probably too open.
- Decide in advance what happens at low confidence: fall back to a rule, ask a person, or ask another question.
- Keep code in charge of validation and consequences, so a wrong answer cannot do more than the rules allow.
- Compare against your current approach on real examples before trusting any speed or cost claim.
See one use case running
A description of a use case is easier to judge next to a working one. Open the live village, follow an inhabitant across several updates, and read the chronicle beside the scene to see how many small judgments add up to a shared history.
See the village for yourself
Open the live observer, choose an inhabitant, and follow their public actions and the chronicle.
Watch the AI village ↗About this guide
Written from the implemented Jevs Village systems and reviewed by the project. Examples describe possible situations, not current live events.