Noul

Use a Noul when the answer is yes or no. For example, does this message ask for a refund, does this resume mention distributed systems, does this comment contain personal data. If the answer is one of several options, use aChoice. If it’s a position on a spectrum, use aScore.Choose a question typecompares all three.A Noul answer is a single number,noul, the probability that the answer is yes.

Writing a Noul question

A Noul question evaluates a single yes/no question (or statement). It is defined by itsinstructions: the yes/no question to evaluate. It’s good practice to phrase it so a high probability means “yes”, so that the returned answer is unambiguous in its meaning.You can optionally addcriteriawithtrueandfalsedescriptions to clarify what each outcome means, which can be helpful when the question itself has more nuance to explain. Try your Noul question prompts with and without criteria to see which works better in your use-case.

Request

Field	Required	Description
type	Yes	Must be "noul".
instructions	Yes	The yes/no question or statement to evaluate.
criteria	No	Optional { true, false } descriptions clarifying what a yes and a no mean.

{
 "state": "I have asked three times now. Can I please just talk to a real person?",
 "questions": {
 "is_human_escalation": {
 "type": "noul",
 "instructions": "Is the customer asking for a human agent?"
 },
 "is_repeat_contact": {
 "type": "noul",
 "instructions": "Has the customer contacted support about this before?",
 "criteria": {
 "true": "Mentions a prior attempt, ticket, or that they have asked before",
 "false": "No sign of any previous contact"
 }
 }
 }
}

Try it in the Playground →

Response

{
 "model": "jev-latest",
 "answers": {
 "is_human_escalation": {
 "type": "noul",
 "noul": 0.99
 },
 "is_repeat_contact": {
 "type": "noul",
 "noul": 0.93
 }
 },
 "usage": {
 "input_tokens": 360,
 "output_tokens": 39
 }
}

noulranges from 0 to 1, representing the probability that the answer isyes. Most often you will threshold it into a boolean when your code needs a hard decision.

Noul does not return a separate confidence value

A value near 1 means a strong yes. A value near 0 means a strong no. A value near 0.5 gives yes and no similar probability.For “Is the candidate strong in Python?”, define what “strong” means. An unclear definition makes the probability hard to interpret. A value of 0.5 does not mean medium skill. Use aScoreto measure skill along defined levels.Choose a question typeexplains the distinction.

Example questions

"Is the customer requesting a refund?"
"Does this resume mention experience with distributed systems?"
"Does the message contain personally identifiable information?"
"Does the room have a minifridge?"

Tips and advanced usage

• **Phrasing.**Beyond a plain question, you can phrase the instruction as a statement for the model to evaluate for truthfulness. For “the customer is requesting a refund”, a value near 1 means the statement is true. Try both phrasings with your own data to see what works best.
• **Optionalcriteria.**The instruction is enough for most Noul questions, but when the boundary between yes and no is subtle, passcriteriawithtrueandfalsedescriptions to pin down what each outcome means — as shown in the request example above.