Respan: Span-01

Span-01 — Respan компаниясының әңгімелер мен агент трассаларына арналған мәтіндік мінез-құлық жіктеуіші. Мінез-құлық түрлерін қарапайым тілмен анықтаңыз: ол әрқайсысы үшін бар, жоқ және бақылау арқылы анықтау мүмкін емес деген үш ықтималдық қайтарады, берілген трасса сұрақты шеше алмаса белгісіздікті сақтайды.

Ailoot Ultra · System One POST /v1/systemone respan/span-01

Модель туралы

Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.

Span-01 — Respan компаниясының әңгімелер мен агент трассаларындағы мінез-құлықты бағалау моделі. Ол мәтіндік өзара әрекеттесуді қарапайым тілде жазылған мінез-құлық анықтамаларымен бірге оқып, әр анықтама үшін ықтималдықтар қайтарады. Шығыс берілген трассада бар, жоқ немесе бақылау арқылы анықтау мүмкін емес мінез-құлықты ажыратады. Бұл бағалау үдерісіне талдау қажет генерацияланған түсіндірме емес, жетіспейтін дәлелдерді айқын ұсынатын сандық сигнал береді.

Байқағыңыз келетін мінез-құлықты анықтаңыз

Мінез-құлық түрлерін шақырушы береді. Промпт инъекциясы, дәлелсіз мәлімдемелер, құпиялардың ашылуы, қайталанатын циклдер, құралдарды қате пайдалану және пайдаланушының ашулануы — ықтимал анықтамалар, модельге кірістірілген бекітілген таксономия емес. Ненің сол мінез-құлық болып саналатынын және ненің саналмайтынын айтыңыз. Тар анықтама пайдаланушының адамға беруді сұрауын жай көңіл толмауын білдіруден ажырата алады. Басқасы ассистенттің мәселені мойындауын өзі орындай алмайтын әрекетке уәде беруден ажырата алады.

Нәтижелер бағаланатын мінез-құлықпен байланысты қалуы үшін анықтамалармен бірге тұрақты идентификаторлар қолданыңыз. Критерийді трасса көрсете алатын нәрсеге бағыттаңыз. Мінез-құлық бастапқы құжатты, құрал нәтижесін немесе кейінгі клиент жауабын талап етсе, сол дәлелдерді мәтіндік өзара әрекеттесудің тиісті жеріне қосыңыз. Бір анықтама трассада жоқ фактіні бекіте алмайды.

Алдыңғы контекст пен мақсатты репликаны дайындаңыз

Құжатталған кіріс span.input ішіндегі алдыңғы хабарламаларды span.output ішіндегі мақсатты репликадан бөледі. Әр хабарламаның мазмұны — жол. Нақты әңгіме контекстін және бағалануы тиіс репликаны беріп, сөйлеуші рөлдерін және оны түсіндіруге қажет ретті сақтаңыз. Бұл — мәтінді бағалау профилі: дайындалған құжат мәтіні немесе транскрипт дәлел бола алады, ал сол мәтін алынған медиа өздігінен құжатталған кіріс емес.

Қолдау өзара әрекеттесуінде клиент сұрауын ассистенттің ұсынылған жауабымен бірге сақтаңыз. Құрал қолданатын агент үшін тиісті құрал бақылауын және соған сүйенген жауапты қалдырыңыз. Негізділікке арналған көрнекі анықтама ассистенттің берілген бақылау қолдамайтын қорытындыны мәлімдейтінін сұрауы мүмкін. Пайдалы нәтиже бүкіл қолданбаның толық диагнозына емес, сол үзіндідегі анықталған мінез-құлыққа қатысты.

Әр анықтама үшін үш ықтималдықты оқыңыз

Әр нәтиже мінез-құлық идентификаторын және p_present, p_absent, p_not_observable мәндерін қамтиды. Үш ықтималдықтың қосындысы шамамен 1 болады. Бар мәні мінез-құлықтың болғанын, жоқ мәні болмағанын, ал бақылау арқылы анықтау мүмкін емес мәні берілген үзіндіде шешімге қажет дәлелдер жетіспейтінін бағалайды. Бұлар — бөлек мағыналар және нәтижелер түсіндірілгенде бөлек қалуы керек.

Мысалы, ассистенттің мәселені шешетінін айтуымен аяқталатын үзінді уәдені көрсете алады. Клиент жауабы жоқ болса, ол клиенттің кейін ұсынылған мәселе шешімін қабылдағанын әлі көрсете алмайды. Сол жетіспейтін дәлел нәтижесін жоқ деп өзгертпей, белгісіз деп қарастырыңыз. Үлестірімнің елеулі бөлігі бақылау арқылы анықтау мүмкін емес мәніне тиесілі болса, бар болу ықтималдығының төмендігі автоматты түрде жоқ болудың күшті дәлелі емес.

Мінез-құлық анықтамаларын бір өтуде бағалау

Respan Span-01 моделін алдымен RLAIF арқылы жалпы жіктеуге оқытылып, кейін мінез-құлықты анықтауға мамандандырылған пайымдаушы жіктеуіш ретінде сипаттайды. Әр анықтама бір трасса үстіндегі параллель тармақ ретінде орындалады және модель мінез-құлық ықтималдықтарын бір тура өтуде қайтарады. Гибридті зейін ұзын, күрделі трассаларды өңдеуді қолдайды. Ол токендер генерацияламайды, баяндау түріндегі пайым жазбайды және жіктеуіне еркін пішімді түсіндірме жасамайды.

Тұжырымдамалық нұсқаулық пен бағалау анықтамалығы бір сұраудағы мінез-құлық санының шегін құжаттамайды. Әр анықтама бәрібір берілген бағалаудың бөлігі, сондықтан сан шегінің жоқтығын шексіз кіріс сыйымдылығының дәлелі деп қабылдамай, әрқайсысын анық әрі қатысты ұстаңыз. Нәтиже сұрау ретімен әр мінез-құлыққа оның id мәнімен белгіленген бір жазба қамтиды. Бірнеше анықтама бірнеше тәуелсіз бақылауды сипаттайды; олар барлық мінез-құлық бойынша қосындысы бірге тең болуы тиіс бір-бірін жоққа шығаратын санаттар арасындағы таңдаулар емес.

Пайдалы бағалау артефактісін дайындау

Қайтарылған ықтималдықтарды модельден тыс тапсырмаға тән шектермен және тексеру ережелерімен біріктіріңіз. Өндіруші осы шектерді таңдау үшін таңбаланған әңгімелерді пайдалануды және бар болудың шекаралық нәтижелерін не бақылау арқылы анықтау мүмкін емес ықтималдығы жоғары нәтижелерді тексеруді ұсынады. Қолдау үдерісі ашулануды, ұсынылған эскалацияны және дәлелсіз уәдені бөлек тіркей алады. Агент сапасын бағалау үдерісі қайталанатын әрекеттерді немесе жауаптың оған берілген дәлелдерді пайдаланғанын бақылай алады.

Мәтін үзіндісін, мінез-құлық анықтамасын, нәтиже идентификаторын және толық үш құрамды үлестірімді бірге сақтаңыз. Анықтама өзгергенде ықтималдық өлшейтін нәрсе де өзгеретінін ескеріңіз. Сандық нәтижені бақыланбаған оқиғаның дәлелі деп қабылдамай, ықтимал қателерді нақты әңгімемен салыстырып тексеріңіз. Пайдалы артефакт — кейінгі тексеруге немесе қолданбаның келесі шешіміне белгісіздігі сақталған, трассамен және критериймен байланыстырылған мінез-құлық жазбасы.

Ailoot Ultra · System One POST /v1/systemone respan/span-01

respan/span-01

Respan /respan/span-01

Бастау

Қабылданатын кіріс деректері: Мәтін
Нәтижелер: decisions

Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер

Ailoot Ultra · System One POST /v1/systemone

Кіріс: text
Шығыс: decisions
Шығыс пішімі: json

Өріс	Түрі	Талап	Мәндер мен шектеулер	Әдепкі
Өріс`model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер respan/span-01	Әдепкі—
Өріс`provider`	Түрі`schema`	ТалапМіндетті емес	Мәндер мен шектеулер	Әдепкі—
Өріс`questions`	Түрі`object`	ТалапМіндетті	Мәндер мен шектеулер	Әдепкі—
Өріс`session_id`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер	Әдепкі—
Өріс`state`	Түрі`schema`	ТалапМіндетті	Мәндер мен шектеулер	Әдепкі—
Өріс`trace`	Түрі`schema`	ТалапМіндетті емес	Мәндер мен шектеулер	Әдепкі—
Өріс`user`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер	Әдепкі—
Өріс`questions.<id>.type`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер noul, choice, score	Әдепкі—
Өріс`questions.<id>.instructions`	Түрі`string\|object\|array`	ТалапМіндетті	Мәндер мен шектеулер	Әдепкі—
Өріс`questions.<id>.criteria`	Түрі`object\|array`	ТалапМіндетті емес	Мәндер мен шектеулер Шарттар: choice/score: міндетті; noul: міндетті емес. choice критерийлері — объект; score — minItems1 талабы бар массив.	Әдепкі—
Өріс`questions.<id>.criteria.true`	Түрі`string\|object\|array`	ТалапМіндетті	Мәндер мен шектеулер Мына жағдайда қолданылады: noul шарттар объектісі берілген	Әдепкі—
Өріс`questions.<id>.criteria.false`	Түрі`string\|object\|array`	ТалапМіндетті	Мәндер мен шектеулер Мына жағдайда қолданылады: noul шарттар объектісі берілген	Әдепкі—

Кіріс материалдарының үйлесімдері

noul · Міндетті: state, questions.<id>.type=noul, questions.<id>.instructions

choice · Міндетті: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object

score · Міндетті: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1

Әдіс параметрлері мен өмірлік циклі

Параметр	Параметр талаптары
Параметр`content_type`	Параметр талаптарыapplication/json
Параметр`required`	Параметр талаптарыmodel, state, questions
Параметр`material_types`	Параметр талаптарыtext
Параметр`optional_controls`	Параметр талаптарыprovider, session_id, trace, user
Параметр`multimodal_input_binding`	Параметр талаптарыnull

Өмірлік цикл: synchronous

Модельдің дәл ID мәнін жіберіп, төл жауапты толық сақтаңыз.

Тарифтер

Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.

Жылдам режим: Көрсетілмеген Жылдам режим таңдалғанда
Икемді режим: Көрсетілмеген flex режимі таңдалғанда
Ой қорытудың ең жоғары деңгейі: Көрсетілмеген Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда

Ailoot мөлшерлемелері

Баптаулар бойынша бағалар

Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.

Баптау	Мөлшерлемелер кестесі	Контекст токендерінің саны мынадан көп	Контекст токендерінің саны мынадан аспайды, шегі кіреді	Төлем
БаптауТокендердің базалық тарифтері	Мөлшерлемелер кестесіНегізгі мөлшерлеме	Контекст токендерінің саны мынадан көп—	Контекст токендерінің саны мынадан аспайды, шегі кіредіЖоғарғы шегі жоқ	Төлем Кіріс · Кіріс токендері $0.00004 / 1K токен Шығыс · Шығыс токендері $0 / 1K токен Кіріс · Кэшті оқу — / 1K токен Кіріс · Кэшке жазу — / 1K токен Кіріс · Кэшке жазу, 1 сағ — / 1K токен
БаптауСұрау ұзындығының 1-деңгейі	Мөлшерлемелер кестесі—	Контекст токендерінің саны мынадан көп0	Контекст токендерінің саны мынадан аспайды, шегі кіредіЖоғарғы шегі жоқ	Төлем Кіріс · Кіріс токендері $0.00004 / 1K токен Шығыс · Шығыс токендері $0 / 1K токен Кіріс · Кэшті оқу — / 1K токен Кіріс · Кэшке жазу — / 1K токен Кіріс · Кэшке жазу, 1 сағ — / 1K токен

Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →

Сұрау мысалдары

Ailoot Ultra · System One

Ресми сұрау құрылымы сақталған; құжаттамаға арналған мысалӨзіңіздің нақты сұрау материалдарыңызды қолданып, нәтижені толық сақтаңыз

{
  "model": "respan/span-01",
  "questions": {
    "is_bug": {
      "criteria": {
        "false": "The customer is asking a question or requesting a feature.",
        "true": "The customer describes broken or unexpected product behavior."
      },
      "instructions": "Is the customer reporting a software defect?",
      "type": "noul"
    },
    "team": {
      "criteria": {
        "account": "Login, permissions, or profile issues.",
        "frontend": "Rendering, layout, or browser compatibility issues.",
        "payments": "Checkout, billing, or payment processing issues."
      },
      "instructions": "Which team should own this ticket?",
      "type": "choice"
    },
    "urgency": {
      "criteria": [
        "Can wait for the next release",
        "Should be fixed this week",
        "Blocking revenue right now"
      ],
      "instructions": "How urgent is this ticket?",
      "type": "score"
    }
  },
  "state": {
    "customer_tier": "enterprise",
    "ticket": "My checkout page shows a blank screen after I click Pay. I have tried two browsers."
  }
}

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"
export AILOOT_REQUEST_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))
if not isinstance(p,dict): raise SystemExit('Request must be a JSON object')
p['model']='respan/span-01'
Path('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/systemone \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))
PY_RESULT

Нәтижелерді алу және сақтау

Ailoot Ultra · System One

json

Барлық дайын нәтижені сақтау

Қайтарылған әр толық жауапты, файлды және мазмұн бөлігін сақтаңыз.

Берілген әрбір сұрақ ID мәніне сәйкес жауап оның нақты түрімен, noul/choice/score мәнімен, сенімділігімен, ықтималдықтарымен және шартты белгілер түсіндірмесімен бірге сақталады. Бастапқы JSON түгел сақталып, есеп айырысудан кейін ғана қайтарылады.

Бастапқы жауапты тексеру қажет болса

Бастапқы операцияны және толық не ішінара жауапты сақтаңыз; POST сұрауын қайталамаңыз.

Жауап өрістері

Өріс	Түрі
Өріс`model`	Түріstring
Өріс`id`	Түріstring
Өріс`provider`	Түріstring
Өріс`answers.<id>.type`	Түріstring
Өріс`answers.<id>.noul`	Түріnumber
Өріс`answers.<id>.choice`	Түріstring
Өріс`answers.<id>.score`	Түріnumber
Өріс`answers.<id>.confidence`	Түріnumber
Өріс`answers.<id>.probabilities`	Түріobject
Өріс`answers.<id>.legend`	Түріobject
Өріс`usage.input_tokens`	Түріinteger
Өріс`usage.output_tokens`	Түріinteger
Өріс`usage.cost`	Түріnumber

Қателер және келесі қадамдар

Жауап	Шарт	Келесі қадам
Жауап400 · `invalid_request_error`	ШартМіндетті өріс, ұсыну пішімі немесе мән жарамсыз	Келесі қадамСұраудың көрсетілген өрісін түзетіңіз.

Балама атаулар

Модельдердің балама атаулары

Ailoot Ultra respan/span-01

Әдіс жолдарының балама атаулары

Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.

Шақыруға арналған байланысты ID

respan/span-01

FAQ · Respan: Span-01

Қандай кіріс деректері мен нәтижелер қолжетімді?: POST /v1/systemone · respan/span-01: text → decisions
Сұрау қандай өрістерді пайдаланады?: POST /v1/systemone · respan/span-01: model, provider, questions, session_id, state, trace, user

Respan: Span-01

Respan: Span-01

Байқағыңыз келетін мінез-құлықты анықтаңыз

Алдыңғы контекст пен мақсатты репликаны дайындаңыз

Әр анықтама үшін үш ықтималдықты оқыңыз

Мінез-құлық анықтамаларын бір өтуде бағалау

Пайдалы бағалау артефактісін дайындау

Бастау

Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер

Тарифтер

Ailoot мөлшерлемелері

Баптаулар бойынша бағалар

Сұрау мысалдары

Ailoot Ultra · System One

Нәтижелерді алу және сақтау

Ailoot Ultra · System One

Барлық дайын нәтижені сақтау

Бастапқы жауапты тексеру қажет болса

Балама атаулар

Модельдердің балама атаулары

Әдіс жолдарының балама атаулары

Шақыруға арналған байланысты ID

Компания және оның жобалар портфелі

Токенді жеңілдікпен сатып алыңыз.

API-ді сататын өніміңізге қосыңыз.