Decisions API

curl https://api.ofox.ai/v1/decisions \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "typesafe/jev-latest",
    "input": "Customer message: I was charged twice, nobody has answered my two emails, and I need a refund today.",
    "questions": [
      { "type": "predicate", "name": "is_frustrated", "instructions": "Is the customer frustrated?" },
      {
        "type": "choice",
        "name": "category",
        "instructions": "Which category does this ticket belong to?",
        "choices": [
          { "value": "billing", "description": "Charges and refunds" },
          { "value": "bug", "description": "Product issue" },
          { "value": "other", "description": "Other" }
        ]
      },
      {
        "type": "score",
        "name": "urgency",
        "instructions": "How quickly does a human need to respond?",
        "levels": [
          { "label": "low", "description": "Within a week is fine" },
          { "label": "medium", "description": "Should respond soon" },
          { "label": "high", "description": "Must respond today" }
        ]
      }
    ]
  }'

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"])
 
result = client.decisions.create(
    model="typesafe/jev-latest",
    input="Customer message: I was charged twice, nobody has answered my two emails, and I need a refund today.",
    questions=[
        {"type": "predicate", "name": "is_frustrated", "instructions": "Is the customer frustrated?"},
        {
            "type": "choice",
            "name": "category",
            "instructions": "Which category does this ticket belong to?",
            "choices": [
                {"value": "billing", "description": "Charges and refunds"},
                {"value": "bug", "description": "Product issue"},
                {"value": "other", "description": "Other"},
            ],
        },
    ],
)
 
is_frustrated, category = result.answers
print(is_frustrated.probability)  # 0.97
print(category.choice)            # billing

const res = await fetch('https://api.ofox.ai/v1/decisions', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.OFOX_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'typesafe/jev-latest',
    input: 'Customer message: I was charged twice, nobody has answered my two emails, and I need a refund today.',
    questions: [
      { type: 'predicate', name: 'is_frustrated', instructions: 'Is the customer frustrated?' }
    ]
  })
})
 
const { answers } = await res.json()
console.log(answers[0].probability)

# pip install typesafe-sdk
import os
from typesafe_sdk import TypeSafeClient, Noul, Choice, Score
 
with TypeSafeClient(base_url="https://api.ofox.ai/typesafe", api_key=os.environ["OFOX_API_KEY"]) as client:
    r = client.system_one(
        model="jev-latest",
        state={"message": "I was charged twice, nobody has answered my two emails, and I need a refund today."},
        questions={
            "urgent": Noul(instructions="Is the customer asking for this to be handled today?"),
            "dept": Choice(
                instructions="Which team should handle this?",
                criteria={"billing": "Charges, invoices, refunds", "technical": "Bugs, integrations", "sales": "Pricing, upgrades"},
            ),
            "anger": Score(instructions="How upset is the customer?", criteria=["Calm", "Upset but polite", "Very angry"]),
        },
    )
 
print(r.nouls["urgent"].noul)      # 0.98
print(r.choices["dept"].choice)    # billing
print(r.scores["anger"].score)     # 1.56

// npm install @typesafe-ai/sdk
import { TypeSafeClient, choice } from '@typesafe-ai/sdk'
 
const client = new TypeSafeClient({
  baseURL: 'https://api.ofox.ai/typesafe',
  apiKey: process.env.OFOX_API_KEY
})
 
const response = await client.systemOne({
  model: 'jev-latest',
  state: { message: 'I was charged twice and I need a refund today.' },
  questions: {
    category: choice('Which category does this ticket belong to?', { billing: null, technical: null, other: null })
  }
})

# Both SDKs read these two environment variables, so no code changes are needed
export TYPESAFE_BASE_URL="https://api.ofox.ai/typesafe"
export TYPESAFE_API_KEY="$OFOX_API_KEY"