How VAKYN works

curl -s "https://api.vakyn.com/v1/systemone" \  -H "Authorization: Bearer $TYPESAFE_API_KEY" \  -H "Content-Type: application/json" \  -o answer.json \  -d @- <<'JSON'{  "model": "jev-latest",  "state": "Stopped working after five weeks. 1 star.\n\nI bought the Tallow & Pine CafeDuo 2 in March and used it every morning for two coffees. In week five the steam wand stopped heating, then the pump started rattling and the machine shut itself off mid-shot. I descaled it twice with the brand's own tablets and followed the reset steps in the manual exactly. Nothing helped. For a machine at this price I expected years, not weeks. Do not buy.\n\nMarta K., verified purchase",  "questions": {    "fake": {      "type": "noul",      "instructions": "Is this review likely fake: paid for, written by the seller, or not based on using the product?"    },    "topic": {      "type": "choice",      "instructions": "What is the review mainly about?",      "criteria": {        "quality": "How the product works, feels or holds up",        "delivery": "Shipping, packaging and arrival",        "price": "Price and value for money",        "service": "Support, returns and refunds",        "other": null      }    },    "negative": {      "type": "score",      "instructions": "How negative is the review?",      "criteria": [        "Positive",        "Mostly positive",        "Mixed",        "Mostly negative",        "Very negative"      ]    }  }}JSON # Act when every answer is at least 0.70 sure; otherwise a person decides.jq -r '.answers as $a  | {fake: ([$a.fake.noul, 1 - $a.fake.noul] | max), topic: $a.topic.confidence, negative: $a.negative.confidence}  | to_entries | min_by(.value) as $weakest  | if $weakest.value >= 0.70    then "act: \(if $a.fake.noul >= 0.5 then "remove" else "publish" end), topic \($a.topic.choice), negative \($a.negative.score) of 4"    else "human: \($weakest.key) is only \($weakest.value * 100 | round / 100) sure" end' answer.json

curl -s "https://api.vakyn.com/v1/systemone" \  -H "Authorization: Bearer $TYPESAFE_API_KEY" \  -H "Content-Type: application/json" \  -o answer.json \  -d @- <<'JSON'{  "model": "jev-latest",  "state": {    "policy": {      "rail": "Second class, booked through the travel desk",      "hotel": "Up to EUR 180 a night",      "meals": "Up to EUR 60 a day while travelling, no alcohol",      "receipts": "A receipt for every line over EUR 25"    },    "report": {      "employee": "Ines Varga, field engineer",      "trip": "Customer site visit in Lyon, 6 October 2026",      "lines": [        {          "date": "2026-10-06",          "item": "Flight, Brussels to Lyon and back, business class, booked privately",          "amount_eur": 1240,          "receipt": false        },        {          "date": "2026-10-06",          "item": "Hotel, three nights for a one-day visit",          "amount_eur": 1260,          "receipt": false        },        {          "date": "2026-10-06",          "item": "Dinner, alone, two bottles of wine",          "amount_eur": 310,          "receipt": false        }      ],      "total_eur": 2810    }  },  "questions": {    "decision": {      "type": "choice",      "instructions": "What should finance do with this expense report?",      "criteria": {        "approve": "Pay it as filed",        "flag": "Hold it until a person checks it",        "reject": "Send it back to the employee to fix"      }    },    "over_policy": {      "type": "noul",      "instructions": "Does any line in the report break the expense policy?"    },    "risk": {      "type": "score",      "instructions": "How risky is it to pay this report as filed?",      "criteria": [        "No risk",        "Low risk",        "Some risk",        "High risk"      ]    }  }}JSON # Act when every answer is at least 0.70 sure; otherwise a person decides.jq -r '.answers as $a  | $a | map_values(if .type == "noul" then [.noul, 1 - .noul] | max else .confidence end)  | to_entries | min_by(.value) as $weakest  | if $weakest.value >= 0.70    then "act: \($a.decision.choice), over policy \(if $a.over_policy.noul >= 0.5 then "yes" else "no" end), risk \($a.risk.score) of 3"    else "human: \($weakest.key) is only \($weakest.value * 100 | round / 100) sure" end' answer.json

curl -s "https://api.vakyn.com/v1/systemone" \  -H "Authorization: Bearer $TYPESAFE_API_KEY" \  -H "Content-Type: application/json" \  -o answer.json \  -d @- <<'JSON'{  "model": "jev-latest",  "state": {    "agent": {      "name": "Returns assistant at Orla Cycles",      "job": "Handles returns. May refund returned items to the original payment method, up to EUR 1,000 per order, once the warehouse has checked the return in."    },    "call": {      "api": "POST /payments/refunds",      "body": {        "order": "OC-58213",        "amount": 900,        "currency": "EUR",        "to": "original payment method",        "reason": "Returned, unused"      }    },    "context": {      "order": "OC-58213, one e-bike battery, paid EUR 900.00 by card on 2026-09-28",      "return": "Checked in by the warehouse on 2026-10-09: sealed, unused, serial number matches the order",      "earlier_refunds_on_order": 0,      "customer": "Customer since 2022, 11 orders, no earlier refunds, same card on file since 2022"    }  },  "questions": {    "action": {      "type": "choice",      "instructions": "What should the guardrail do with this API call?",      "criteria": {        "allow": "Let the agent make the call now",        "ask_human": "Hold the call until a person approves it",        "block": "Stop the call and tell the agent why"      }    },    "irreversible": {      "type": "noul",      "instructions": "Would this call be hard or impossible to undo once made?"    },    "damage": {      "type": "score",      "instructions": "If this call is a mistake, how hard is the damage to put right?",      "criteria": [        "Easy",        "Takes some work",        "Hard",        "Impossible"      ]    },    "within_job": {      "type": "noul",      "instructions": "Is this call part of the agent's job as described?"    }  }}JSON # Act when every answer is at least 0.70 sure; otherwise a person approves the call.jq -r '.answers as $a  | $a | map_values(if .type == "noul" then [.noul, 1 - .noul] | max else .confidence end)  | to_entries | min_by(.value) as $weakest  | if $weakest.value >= 0.70    then "act: \($a.action.choice) (damage \($a.damage.score) of 3)"    else "human: \($weakest.key) is only \($weakest.value * 100 | round / 100) sure" end' answer.json

curl -s "https://api.vakyn.com/v1/systemone" \  -H "Authorization: Bearer $TYPESAFE_API_KEY" \  -H "Content-Type: application/json" \  -o answer.json \  -d @- <<'JSON'{  "model": "jev-latest",  "state": {    "role": {      "title": "Night shift lead, distribution center in Rotterdam",      "must_have": [        "Two years or more leading a warehouse team",        "A valid forklift certificate",        "Can work nights, Sunday to Thursday"      ],      "nice_to_have": [        "Dutch and English",        "Has used a warehouse management system"      ]    },    "applications": [      {        "application": 1,        "name": "Joost Verhagen",        "summary": "Four years as night shift lead at a grocery distribution center, team of 14. Forklift certificate valid to 2028. Wants to stay on nights. Dutch and English. Daily work in a warehouse management system."      },      {        "application": 2,        "name": "Mila Petrova",        "summary": "Recent graduate in logistics, no work experience in a warehouse yet. No forklift certificate. Prefers day shifts."      },      {        "application": 3,        "name": "Sam O'Brien",        "summary": "Barista for three years. No warehouse or forklift experience. Available weekends only."      },      {        "application": 4,        "name": "Fatima Zahra El Idrissi",        "summary": "Office manager for six years. No warehouse experience, no forklift certificate. Looking for a day job close to home."      },      {        "application": 5,        "name": "Kees de Wit",        "summary": "Retired in 2025 after thirty years as a truck driver. No team lead experience. Wants two days a week."      },      {        "application": 6,        "name": "Lucas Moreau",        "summary": "Software developer looking for a career change into tech sales. Never worked in a warehouse."      },      {        "application": 7,        "name": "Hanna Kowalski",        "summary": "Student, wants a summer job. No experience and no forklift certificate. Available in July and August only."      },      {        "application": 8,        "name": "Ravi Menon",        "summary": "Chef for ten years in restaurants. No warehouse experience. Cannot work nights."      }    ]  },  "questions": {    "priority_1": {      "type": "score",      "instructions": "How high should application 1 go on the interview list?",      "criteria": [        "Do not interview",        "Interview if needed",        "Interview first"      ]    },    "priority_2": {      "type": "score",      "instructions": "How high should application 2 go on the interview list?",      "criteria": [        "Do not interview",        "Interview if needed",        "Interview first"      ]    },    "priority_3": {      "type": "score",      "instructions": "How high should application 3 go on the interview list?",      "criteria": [        "Do not interview",        "Interview if needed",        "Interview first"      ]    },    "priority_4": {      "type": "score",      "instructions": "How high should application 4 go on the interview list?",      "criteria": [        "Do not interview",        "Interview if needed",        "Interview first"      ]    },    "priority_5": {      "type": "score",      "instructions": "How high should application 5 go on the interview list?",      "criteria": [        "Do not interview",        "Interview if needed",        "Interview first"      ]    },    "priority_6": {      "type": "score",      "instructions": "How high should application 6 go on the interview list?",      "criteria": [        "Do not interview",        "Interview if needed",        "Interview first"      ]    },    "priority_7": {      "type": "score",      "instructions": "How high should application 7 go on the interview list?",      "criteria": [        "Do not interview",        "Interview if needed",        "Interview first"      ]    },    "priority_8": {      "type": "score",      "instructions": "How high should application 8 go on the interview list?",      "criteria": [        "Do not interview",        "Interview if needed",        "Interview first"      ]    },    "best": {      "type": "choice",      "instructions": "Which application should we interview first?",      "criteria": {        "application_1": null,        "application_2": null,        "application_3": null,        "application_4": null,        "application_5": null,        "application_6": null,        "application_7": null,        "application_8": null      }    },    "red_flags": {      "type": "noul",      "instructions": "Does any application show a red flag, such as claims that contradict each other or a certificate that looks made up?"    }  }}JSON # Act when every answer is at least 0.70 sure; otherwise a person decides.jq -r '.answers as $a  | $a | map_values(if .type == "noul" then [.noul, 1 - .noul] | max else .confidence end)  | to_entries | min_by(.value) as $weakest  | if $weakest.value >= 0.70    then "act: interview \($a.best.choice) first, red flags \(if $a.red_flags.noul >= 0.5 then "yes" else "no" end), "      + "priorities \([range(1; 9) as $i | $a["priority_\($i)"].score | round] | map(tostring) | join(" "))"    else "human: \($weakest.key) is only \($weakest.value * 100 | round / 100) sure" end' answer.json