Respan: Span-01 Lite

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

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

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

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

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

Бақылауды және оның шекарасын таңдаңыз

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

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

Әңгіме үзіндісін дайындаңыз

Respan құжаттаған кіріс алдыңғы хабарламаларды span.input өрісіне, ал бағаланатын репликаны span.output өрісіне орналастырады. Хабарлама мазмұны — жол. Репликаны түсінуге қажет контексті, соның ішінде сөйлеуші рөлдерін, тиісті пайдаланушы сұрауын және ассистент қолданған мәтіндік дәлелдерді сақтаңыз. Сапаны тексеру үшін бағаланатын мінез-құлықты алып тастайтын мазмұндама емес, нақты репликаны беріңіз.

Көрнекі тексеруде қайталанатын қиындықты сипаттаған пайдаланушы хабарламасын және зерттеп көруді ұсынған ассистент жауабын алуға болады. Пайдаланушының ашулануын және ассистенттің уәдесін бөлек бақылаулар ретінде анықтаңыз. Мәлімдеменің негізділігін бағалауға құрал нәтижесі маңызды болса, сол нәтиженің тиісті мәтінін контексте сақтаңыз. Шығыс берілген үзіндідегі осы анықтамаларды бағалайды; модель уәде етілген зерттеуді жүргізбейді және әңгіменің өзін өзгертпейді.

Бар, жоқ және бақылау арқылы анықтау мүмкін емес

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

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

Бір дәлелге қатысты бірнеше анықтама

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

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

Таңдалған профильді нәтижелерімен бірге сақтаңыз

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

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

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

respan/span-01-lite

Respan /respan/span-01-lite

Бастау

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

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

Ailoot Ultra · System One POST /v1/systemone

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

Өріс	Түрі	Талап	Мәндер мен шектеулер	Әдепкі
Өріс`model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер respan/span-01-lite	Әдепкі—
Өріс`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 / 1K токен Шығыс · Шығыс токендері $0 / 1K токен Кіріс · Кэшті оқу — / 1K токен Кіріс · Кэшке жазу — / 1K токен Кіріс · Кэшке жазу, 1 сағ — / 1K токен
БаптауСұрау ұзындығының 1-деңгейі	Мөлшерлемелер кестесі—	Контекст токендерінің саны мынадан көп0	Контекст токендерінің саны мынадан аспайды, шегі кіредіЖоғарғы шегі жоқ	Төлем Кіріс · Кіріс токендері $0 / 1K токен Шығыс · Шығыс токендері $0 / 1K токен Кіріс · Кэшті оқу — / 1K токен Кіріс · Кэшке жазу — / 1K токен Кіріс · Кэшке жазу, 1 сағ — / 1K токен

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

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

Ailoot Ultra · System One

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

{
  "model": "respan/span-01-lite",
  "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-lite'
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-lite

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

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

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

respan/span-01-lite

FAQ · Respan: Span-01 Lite

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

Respan: Span-01 Lite