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 में क्या शामिल है (स्टॉक, शिप-टू) बनाम कीमत_प्रश्न।
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?"
      }
    }
  }'

टाइप किए गए उत्तरों और पुनः प्रयास के लिए आधिकारिक एसडीके का उपयोग करें

पायथन एसडीके पर्यावरण से 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

टाइपसेफ़ विकल्प वितरण से आत्मविश्वास को उजागर करता है। एक व्यावहारिक नीति है:

अपनी स्ट्रीम या इनबॉक्स से लेबल किए गए उदाहरणों पर कटऑफ को कैलिब्रेट करें। सीमाएँ उपयोग-मामले-विशिष्ट हैं। सुझावों को कभी भी पैसों के लिए न जोड़ें या साइड इफ़ेक्ट वापस न करें।

वैश्विक स्तर पर मॉडल नहीं, बल्कि कार्रवाई की सीमा तय करें

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