Изучить TypeSafe Jev

Официальная ментальная модель

Официальные ссылки: Introduction · State · Primitives

{
  "choice": "technical",
  "probabilities": { "technical": 0.85, "billing": 0.15 },
  "confidence": 0.78
}

{
  "score": 1.43,
  "probabilities": { "0": 0.0, "1": 0.57, "2": 0.43 },
  "confidence": 0.35
}

{
  "type": "noul",
  "noul": 0.95
}

Официальные ссылки: Choice · Score · Noul

Написание строгих критериев

1. Непересекающиеся варианты. Если оба ключа выбора могут быть истинными, операторы будут бороться с моделью.
2. Опишите края. Скажите, что включает в себя buy_intent (запас, доставка) и Price_question.
3. Остатки оставляйте в последнюю очередь. Используйте других/человека в качестве запасных люков, а не ленивых ловушек.
4. Заказать Оценка по возрастанию. Массивы критериев: самый низкий → самый высокий.
5. Одно решение на каждый вопрос. Разделите «маршрут» от «срочности» на отдельные ключи.

Анатомия вопроса

route: {
  type: 'choice',
  instructions: 'Route this ticket to one queue.',
  criteria: {
    tech: 'Bugs, outages, API failures, or integrations',
    sales: 'Pricing, plans, demos, or new-purchase intent',
    billing: 'Charges, invoices, receipts, or subscriptions',
    human: 'Ambiguous, sensitive, legal, or multi-issue'
  }
}

Состояние структуры и ссылки на точные поля

Храните доказательства в именованных полях состояния и указывайте на них инструкции с помощью путей с точками и индексами. Это уменьшает неопределенность относительно того, какой текст, запись или политика должны контролировать ответ.

const state = {
  ticket: {
    message: 'I was charged twice. Please refund the duplicate.',
    orderId: 'A-104'
  },
  order: { charges: [49, 49] },
  refundPolicy: 'Duplicate charges are eligible for a refund.'
};

const questions = {
  refund_requested: {
    type: 'noul',
    instructions: 'Does `ticket.message` request a refund?'
  },
  policy_supports_refund: {
    type: 'noul',
    instructions: 'Does `refundPolicy` support the request given `order.charges`?'
  }
};

Официальные ссылки: Primitives · State

Начните с официальной конечной точки HTTP.

Сохраните TYPESAFE_API_KEY на сервере. Отправьте состояние, модель и карту именованных вопросов на POST /v1/systemone..

curl -X POST https://api.typesafe.ai/v1/systemone \
  -H "Authorization: Bearer $TYPESAFE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "state": "Stripe has failed for 3 days. I am losing sales.",
    "model": "jev-latest",
    "questions": {
      "department": {
        "type": "choice",
        "instructions": "Which team should handle this?",
        "criteria": {
          "billing": "Payment or subscription issues",
          "technical": "Bugs or integration problems",
          "sales": "Pricing or account questions"
        }
      },
      "is_urgent": {
        "type": "noul",
        "instructions": "Does this message convey urgency?"
      }
    }
  }'

Используйте официальный SDK для печатных ответов и повторных попыток.

Python SDK считывает TYPESAFE_API_KEY из среды, по умолчанию используется jev-latest, предоставляет типизированные классы вопросов и ответов и применяет политику повтора по умолчанию.

pip install typesafe-sdk

from typesafe_sdk import Choice, Noul, TypeSafeClient

with TypeSafeClient() as client:
    response = client.system_one(
        state={"message": "Stripe has failed for 3 days.", "impact": "Losing sales"},
        questions={
            "department": Choice(
                instructions="Which team should handle this?",
                criteria={
                    "billing": "Payment or subscription issues",
                    "technical": "Bugs or integration problems",
                    "sales": "Pricing or account questions",
                },
            ),
            "is_urgent": Noul(
                instructions="Does `message` and `impact` convey urgency?"
            ),
        },
    )

department = response.answers["department"]
print(department.choice, department.confidence)
print(response.answers["is_urgent"].noul)

Прочитайте каждый ответ под идентификатором вопроса.

{
  "model": "jev-1.13.0",
  "answers": {
    "department": {
      "type": "choice",
      "choice": "technical",
      "confidence": 0.78,
      "probabilities": { "technical": 0.85, "billing": 0.15, "sales": 0.0 }
    },
    "is_urgent": { "type": "noul", "noul": 0.95 }
  },
  "usage": { "input_tokens": 392, "output_tokens": 54 }
}

Обработка всей поверхности ошибок

import { experimental_evaluate as evaluate } from 'ai';
import { gateway } from '@ai-sdk/gateway';

const result = await evaluate({
  model: gateway('typesafe-ai/jev'),
  state,
  questions,
});

Официальные ссылки: Quick start · API reference · SDKs

TypeSafe обеспечивает уверенность в распределении опций. Практическая политика – это:

Калибруйте обрезки помеченных примеров из вашей ленты или почтового ящика. Пороговые значения зависят от конкретного случая использования. Никогда не переводите предложения в деньги и не возвращайте деньги за побочные эффекты.

Порог действия, а не модели в целом

action = response.answers["action"]

if action.confidence < 0.5:
    route_to_human(state)             # uncertain: do not guess
elif action.choice == "check_balance":
    show_balance(account_id)          # reversible, low stakes
elif action.choice == "approve_transfer":
    if action.confidence > 0.9:
        confirm_then_execute(account_id)
    else:
        ask_user_to_confirm(account_id)  # higher stakes, higher bar

Официальные ссылки: Confidence

Создайте единый полный рабочий процесс сортировки поддержки

Отправьте одно структурированное состояние заявки и параллельно задайте три независимых вопроса. Сохраняйте политику маршрутизации и безопасности в коде.

const questions = {
  department: {
    type: 'choice',
    instructions: 'Which team should handle `ticket.message`?',
    criteria: {
      returns: 'Exchanges, wrong or damaged items',
      shipping: 'Delivery status, delays, or lost packages',
      billing: 'Charges, invoices, or payment problems',
      other: 'None of the above'
    }
  },
  frustration: {
    type: 'score',
    instructions: 'How frustrated is the customer?',
    criteria: ['Calm', 'Concerned but civil', 'Very angry']
  },
  refund_requested: {
    type: 'noul',
    instructions: 'Does `ticket.message` request money back?'
  }
};

Превратите напечатанные ответы в проверяемое решение

const department = result.answers.department;
const frustration = result.answers.frustration;
const refundProbability = result.answers.refund_requested.noul;

if (department.confidence < 0.5) {
  return { action: 'manual_triage', reason: 'uncertain_department' };
}

const flags = [];
if (frustration.score > 1.4) flags.push('senior_agent');
if (refundProbability > 0.75) flags.push('refund_review');

return {
  action: 'route',
  team: department.choice,
  flags,
  evidence: {
    departmentProbabilities: department.probabilities,
    frustrationScore: frustration.score,
    refundProbability
  }
};

Официальные ссылки: Patterns · Primitives