ይማሩ · ስርዓት አንድ

TypeSafe Jevን ይማሩ

TypeSafe Jev ደረጃ በደረጃ መማሪያ. ለተዋቀሩ የሶፍትዌር ውሳኔዎች የSystem One AI ሞዴል TypeSafe Jev ተግባራዊ መመሪያ።

ኮር ኮርስ የኮርስ ዝርዝር

እድገት01 / 06

ተግባሩን ፍሬም ያድርጉ

ጄቭ ተስማሚ መሆን አለመሆኑን ይወስኑ

ጄቭ የውይይት ሞዴል አይደለም። ነባሩን ሁኔታ ወደ ዝግ ምርጫ፣ ነጥብ ወይም ኖል ውሳኔ ይለውጣል እና የይሁንታ ስርጭትን ይመልሳል።

ጥሩ ተስማሚ

ለተወሰኑ ውሳኔዎች Jevን ይጠቀሙ

አንዱን ጥያቄ ወደ አንድ የተሰየመ ወረፋ ያዙሩ።
በታዘዘ አደጋ ወይም የጥራት ሚዛን ላይ መዝገብ ያስቀምጡ።
አንድ በግልጽ የተቀመጠ ሁኔታ እውነት እንደሆነ ይገምቱ።

ጥሩ ተስማሚ አይደለም

በምትኩ አመንጪ ሞዴል ተጠቀም

ክፍት የሆነ ጽሑፍ ጻፍ፣ ማጠቃለል፣ መተርጎም ወይም እንደገና መፃፍ።
ተፈጥሯዊ ባለብዙ ዙር ውይይት ያዙ።
ትክክለኛዎቹ ውጽዓቶች አስቀድመው ሊጠሩ በማይችሉበት ጊዜ መልስ ይፍጠሩ።

ኦፊሴላዊው የአእምሮ ሞዴል

STATE

አንድ ግዛት ለመገምገም

ፍርዱ የሚፈልገውን ጽሑፍ እና ተዛማጅ እውነታዎችን የያዘ ሕብረቁምፊ፣ ነገር ወይም ድርድር ያስተላልፉ። ለአብዛኛዎቹ እውነተኛ ጥያቄዎች የተሰየሙ የነገር መስኮችን ይጠቀሙ።

QUESTIONS

በአንድ ጥያቄ አንድ ፈጣን ፍርድ

እያንዳንዱ ጥያቄ አንድ እውቀት ያለው ሰው ከቀረበው ግዛት በፍጥነት ሊፈርድበት የሚችል አንድ ትኩረት ያለው ነገር መጠየቅ አለበት።

PARALLEL

ገለልተኛ ጥያቄዎች በትይዩ

በአንድ ጥያቄ ውስጥ ያሉ ጥያቄዎች አንድ አይነት ሁኔታን ይመለከታሉ, እራሳቸውን ችለው ይሮጣሉ እና አንዱን መልስ ወደ ሌላ አያፈስሱ.

CODE

መልሶችን በኮድ ይጻፉ

በአንድ ጥያቄ ውስጥ የስራ ፍሰት አመክንዮ ከመደበቅ ይልቅ ክብደት፣ ደፍ፣ ቅርንጫፍ እና የተተየቡ መልሶችን በመደበኛ ኮድ ያጣምሩ።

የመበስበስ ሙከራ; ፍርዱ ብዙ ገለልተኛ ሁኔታዎችን የሚመዝን ከሆነ ወይም የተራዘመ ምክንያትን የሚፈልግ ከሆነ፣ ወደ አቶሚክ ጥያቄዎች ይከፋፍሉት እና መልሶቹን በኮድ ያጣምሩ።

ከዚህ ምዕራፍ በኋላ፡-የይዘት-ትውልድ ስራዎችን ከተዋቀሩ የውሳኔ ስራዎች መለየት ይችላሉ።

ኦፊሴላዊ ማጣቀሻዎች፡- Introduction · State · Primitives

ዓይነት ይምረጡ

ምርጫ፣ ነጥብ ወይም ኖልን ይምረጡ

ምርጫን እርስ በርስ ለሚጋጩ መለያዎች፣ ለታዘዙ ደረጃዎች ነጥብ እና ኖልን ለአንድ እውነተኛ ወይም ሀሰት ፍርድ ተጠቀም።

ዓይነት	ታቀርባላችሁ	ትቀበላለህ	መቼ ይጠቀሙ
`choice`	የተሰየሙ አማራጮች → መግለጫዎች	የተመረጠ ቁልፍ + በየአማራጭ እድሎች (+ በራስ መተማመን)	እርስ በርስ የሚለያዩ መለያዎች/መንገዶች
`score`	የታዘዙ ደረጃዎች (2-10) ፣ ዝቅተኛ → ከፍተኛ	ፕሮባቢሊቲ-ክብደት ያለው ደረጃ ነጥብ + የሩጫ ፕሮብሎች	ክብደት, ጥራት, የአደጋ ደንቦች
`noul`	አዎ/አይ ሀሳብ (+ አማራጭ መስፈርቶች)	የእውነት ሊሆን ይችላል።	ነጠላ እውነታ ማረጋገጫዎች

choiceእስከ 255 አማራጮች

አሸናፊ እና ሙሉ ስርጭት

ላልታዘዙ፣ ቋሚ አማራጮች ይጠቀሙ። ዝርዝሩ ሁሉንም ግዛት በማይሸፍንበት ጊዜ ሌላ/ምንም ያክሉ። የተመረጠው እሴት ከፍተኛ-ይቻላል አማራጭ ነው።

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

score2-10 የታዘዙ ደረጃዎች

ፕሮባቢሊቲ-ክብደት ያለው አቀማመጥ

ደረጃዎች ከ 0 ይጠቁማሉ። ነጥብ በሁሉም የደረጃ ፕሮባቢሊቲዎች መካከል ያለው የክብደት አማካኝ ነው፣ ስለዚህ በሁለት ደረጃዎች መካከል ሊወድቅ ይችላል።

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

noul0 = የለም · 1 = አዎ

አንድ መግለጫ እውነት የመሆን እድሉ

ለንፁህ አዎ/አይ ፍርድ ተጠቀም። በ 0.5 አቅራቢያ ማለት የንብረቱ መካከለኛ መጠን ሳይሆን እርግጠኛ አለመሆን ማለት ነው. ኑል የተለየ የመተማመን መስክ የለውም።

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

ነጥብ ትክክለኛነት አይደለም። በ0–2 rubric ላይ 1.5 ነጥብ የሚጠበቀው ደረጃ ነው እንጂ “75% ትክክል” አይደለም። የውጤት ወይም የመምረጥ በራስ መተማመንን እንደ ትክክለኛነት ቃል አይያዙ።

ከዚህ ምዕራፍ በኋላ፡-ለመዘዋወር፣ ለልክ እና ለአደጋ ነጥብ ትክክለኛ የመልስ ቅርጽ መምረጥ ይችላሉ።

ኦፊሴላዊ ማጣቀሻዎች፡- Choice · Score · Noul

ደንቦቹን ይግለጹ

የውሳኔ ውል ይጻፉ

የአማራጭ ስሞችን የተረጋጋ ያድርጉት፣ የሚለያዩ ድንበሮችን ይግለጹ፣ ቀሪ ዱካን ያካትቱ እና ለእያንዳንዱ ጥያቄ አንድ ውሳኔ ይስጡ።

ጠንካራ መስፈርቶችን መጻፍ

የተለያዩ አማራጮች። ሁለት የምርጫ ቁልፎች ሁለቱም እውነት ከሆኑ ኦፕሬተሮች ሞዴሉን ይዋጋሉ።
ጠርዞችን ይግለጹ. Buy_intent የሚያካትተውን ይናገሩ (አክሲዮን፣ መርከብ ወደ) ከዋጋ_ጥያቄ ጋር።
ቀሪውን በመጨረሻ ያቆዩት። ሌላውን/ሰውን እንደ ማምለጫ ይጠቀሙ እንጂ ሰነፍ የሚይዙትን አይጠቀሙ።
የትዕዛዝ ውጤት ወደ ላይ ይወጣል። የመመዘኛ ድርድር ዝቅተኛው → ከፍተኛ ነው።
በአንድ ጥያቄ አንድ ውሳኔ. "መንገድ"ን ከ"አጣዳፊ" ወደ ተለያዩ ቁልፎች ክፈል።

የአንድ ጥያቄ አናቶሚ

question_id

ለ ኮድዎ የምላሽ ፍለጋ ቁልፍ። ወደ ሞዴሉ አልተላከም, ስለዚህ መመሪያዎች አሁንም ሙሉውን ጥያቄ መያዝ አለባቸው.

type

ምርጫ፣ ነጥብ ወይም noul። ኮድዎ በቀጥታ የሚሠራበትን ቅርጽ ይምረጡ።

instructions

የተሟላ ፣ የተወሰነ ፍርድ። ሕብረቁምፊ፣ ነገር ወይም ድርድር ሊሆን ይችላል እና የግዛት መንገዶችን ሊያመለክት ይችላል።

criteria

የምርጫ አማራጮች፣ የታዘዙ የውጤት ደረጃዎች፣ ወይም አማራጭ እውነት/ሐሰት ለኑል ማብራርያ።

ምሳሌ · አንድ ውሳኔ፣ የተከፋፈለ ድንበሮች

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 }
}

የተጠናቀቀውን የስህተት ገጽ ይያዙ

401

የጠፋ ወይም ልክ ያልሆነ የኤፒአይ ቁልፍ። የ Bearer tokenን ያረጋግጡ።

422

ልክ ያልሆነ የጥያቄ ቅርጽ ለተበደለው መስክ ምላሹን ይፈትሹ.

429

የዋጋ ገደብ አልፏል። እንደገና ከመሞከርዎ በፊት ይመለሱ።

529

አገልግሎቱ ለጊዜው ከመጠን በላይ ተጭኗል። እንደገና ከመሞከርዎ በፊት ይመለሱ።

ለ 429 እና 529፣ ወዲያውኑ እንደገና ከመሞከር ይልቅ ገላጭ ጀርባን ይጠቀሙ። ኦፊሴላዊዎቹ ኤስዲኬዎች ይህንን በነባሪ ዳግም ሙከራ መመሪያቸው በራስ-ሰር ያደርጉታል።

አማራጭ፡ Vercel AI ጌትዌይ

ይህ ድረ-ገጽ ጌትዌይን እንደ የመዳረሻ ንብርብር ለ AI ኤስዲኬ ይገመግማል። አማራጭ የመዋሃድ መንገድ እንጂ የጄቭ ወይም የTySafe አካል አይደለም።

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

እርግጠኛ አለመሆንን ይያዙ

እምነትን ወደ ፖሊሲ ቀይር

የላይኛውን ዕድል በቀጥታ ወደ የመጨረሻ እርምጃ አይቀይሩት። በንግድ ስጋት ላይ በመመስረት ለአስተያየት፣ ማረጋገጫ እና የሰዎች ግምገማ ባንዶችን ያዘጋጁ።

PROBABILITY

ለእያንዳንዱ አማራጭ ወይም ደረጃ ማስረጃ

ምርጫ እና ነጥብ ሙሉውን ስርጭት ይመለሳሉ. የሁለተኛ ደረጃ አማራጮች፣ አሻሚነት ወይም ብጁ አለመረጋጋት እርምጃዎች አስፈላጊ ሲሆኑ ይጠቀሙበት።

CONFIDENCE

የስርጭት ቅርጽ ማጠቃለያ

መተማመን ስርጭቱ ምን ያህል የተከማቸ ወይም ጠፍጣፋ ወደ 0–1 እንደሆነ ይጨመቃል። ከተመረጠው አማራጭ ዕድል ጋር ተመሳሳይ አይደለም.

Noul: ኖኡል ቀድሞውንም P(እውነትን) ይመልሳል፣ ስለዚህ የተለየ እምነት የለውም። በ 0.5 አቅራቢያ ያሉ ዋጋዎች እርግጠኛ አይደሉም; እንደአደጋው መጠን ሁለቱንም አዎ እና የለም ጎን ያድርጉ።

TypeSafe ከአማራጭ ስርጭት በራስ መተማመንን ያጋልጣል። ተግባራዊ ፖሊሲ፡-

ከፍተኛ በራስ መተማመን

በእርስዎ UI ውስጥ ምርጫውን (መለያ፣ መንገድ ወይም ፍርድ) በራስ-አቅርቡ።

መካከለኛ በራስ መተማመን

ጥቆማውን አሳይ፣ ግን ከመቀጠልዎ በፊት ኦፕሬተር እንዲያረጋግጥ ይጠይቁ።

ዝቅተኛ በራስ መተማመን

ያለምንም ነባሪ እርምጃ ወደ ሰው ወረፋ ላክ።

ከእርስዎ ዥረት ወይም የገቢ መልእክት ሳጥን ውስጥ በተሰየሙ ምሳሌዎች ላይ መቁረጦችን ያስተካክሉ። ገደቦች አጠቃቀም-ጉዳይ-ተኮር ናቸው። የጥቆማ አስተያየቶችን ወደ ገንዘብ በጭራሽ አይዙሩ ወይም ገንዘብ ተመላሽ ያድርጉ የጎንዮሽ ጉዳቶች።

በድርጊት ደረጃ, በአለምአቀፍ ደረጃ ሞዴሉን አይደለም

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

ተለማመዱ

ከፕሮቶታይፕ ወደ እውነተኛ ተግባር ይሂዱ

ከተዋቀረ ግዛት፣ ትይዩ ጥያቄዎች፣ ኮድ-ባለቤትነት ያለው ፖሊሲ፣ የኦዲት ማስረጃ፣ ዳግም ሙከራዎች እና የሰው ውድቀት ያለው አንድ የተሟላ የስራ ሂደት ይገንቡ።

አንድ የተሟላ የድጋፍ-የስራ ሂደትን ይገንቡ

አንድ የተዋቀረ የቲኬት ሁኔታ ይላኩ እና ሶስት ገለልተኛ ጥያቄዎችን በትይዩ ይጠይቁ። በኮድ ውስጥ የማዘዋወር እና የደህንነት መመሪያን ይቀጥሉ።

STATE→CHOICESCORENOUL→POLICY

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
  }
};

የምርት ማረጋገጫ ዝርዝር

ምስክርነቶችን እና የሞዴል ጥሪዎችን ከአገልጋይ ጎን ያስቀምጡ።
ኤፒአይ ከመደወልዎ በፊት የግዛት መጠንን፣ የሚፈለጉትን መስኮች እና የጥያቄ ፍቺዎችን ያረጋግጡ።
የአምሳያው ሥሪትን፣ የጥያቄ ሥሪትን፣ ፕሮባቢሊቲዎችን፣ መተማመንን እና የመጨረሻ እርምጃን ያከማቹ።
ግልጽ የሆነ ሌላ/የሰው መንገድ ያቅርቡ እና በእርግጠኝነት አለመተማመንን በጭራሽ አይፍጠሩ።
429 እና 529 ከተገደበ ገላጭ ጀርባ ጋር እንደገና ይሞክሩ። የማረጋገጫ ስህተቶችን እንደገና አይሞክሩ.
አውቶማቲክን ከማንቃትዎ በፊት በተሰየሙ የጠርዝ መያዣዎች ላይ ይሞክሩ እና የመግቢያ ገደቦችን ያስተካክሉ።

Case index

Six Jev patterns to explore next

These are research paths, not claims that this site built the projects. Each card opens the corresponding category in the open-source radar so you can inspect real implementations and source evidence.

01 CHOICE