Getting started with JEV

Learn shared state, typed questions, and how to explore JEV online.

Last updated: 2026-09-19

Start with the right destination

This site is an independent guide. TypeSafe AI is the official destination for JEV product information and service access. The JevAI community Playground is a separate community service where you can explore model requests. Access, sign-in requirements, and usage limits are set by that service.

1. Prepare your context

The state field contains the information a decision should be based on. Start with one short, representative message, such as a support ticket. Every question shares this context. Avoid including personal information or secrets in an external demo.

Our request builder lets you edit an example and inspect JSON locally in your browser. It does not send your input to a model.

2. Choose the question type

Choice: select from a set of options

Use choice when you have a finite set of destinations or categories. Its criteria is an object mapping option names to descriptions. A null description means the option name alone describes the option. Include an “other” option when your list might not cover every input. The community guide accepts 2–255 options.

Score: rate against ordered levels

Use score when the answer lies on a defined scale. Its criteria is an array of 2–10 descriptions, ordered from low to high. Levels start at 0; three levels represent 0–2. The returned score may lie between levels.

Noul: estimate the probability of yes

Use noul for a yes-probability question. Criteria can be omitted. If supplied, the community guide requires descriptions for both true and false. The noul value is a probability, not a Boolean or an additional confidence field.

3. Write a complete instruction

Put the meaning of your question in instructions, rather than relying on the question ID. For example: “Which team should handle this support ticket?” with billing, technical, and other as options. Clear categories and relevant context make your request easier to assess.

4. Inspect, copy, and try

Use the builder to validate the request, copy its JSON, or download it. The JSON is a parameter example; it is not a complete authenticated API integration. Open the community Playground and enter the state and questions in its form. Do not assume it supports JSON import.

For an integration, verify the current endpoint, authentication, model availability, and billing directly with your chosen provider. The model name in this guide follows the community documentation: typesafe/jev-1.13.

5. Review the result

A structured response makes a decision easier for software to consume, but its format does not guarantee factual correctness. Check results against representative examples before using them in a workflow. Plan what should happen when the input is ambiguous or requires human review.

Questions about access

For service access and product questions, use the contact options on the official TypeSafe AI website. This independent guide does not manage provider accounts or billing.