Respan: Span-01
Span-01 er Respans tekstbaserede adfærdsklassifikator til samtaler og agentspor. Definér adfærdstyperne i almindeligt sprog, så returnerer den tre sandsynligheder for hver: til stede, fraværende og ikke observerbar. Dermed bevares usikkerheden, når det indsendte spor ikke kan afgøre spørgsmålet.
Om modellen
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
Span-01 er Respans model til adfærdsscoring af samtaler og agentspor. Den læser en tekstinteraktion sammen med adfærdsdefinitioner skrevet i almindeligt sprog og returnerer sandsynligheder for hver definition. Outputtet skelner mellem adfærd, der er til stede, fraværende eller ikke observerbar i det indsendte spor. Det giver en evalueringsarbejdsgang et numerisk signal med en eksplicit måde at repræsentere manglende evidens på frem for en genereret forklaring, der skal fortolkes.
Definér den adfærd, du vil observere
Adfærdstyperne indsendes af kalderen. Prompt injection, påstande uden belæg, eksponering af hemmeligheder, gentagne løkker, misbrug af værktøjer og brugerfrustration er mulige definitioner, ikke en fast taksonomi indbygget i modellen. Angiv, hvad der tæller som adfærden, og hvad der ikke gør. En snæver definition kan skelne mellem en bruger, der beder om overdragelse til et menneske, og en bruger, der blot udtrykker skuffelse. En anden kan skelne mellem en assistent, der anerkender et problem, og en assistent, der lover en handling, den ikke kan udføre.
Brug stabile identifikatorer sammen med definitionerne, så resultaterne forbliver knyttet til den adfærd, der vurderes. Hold kriteriet fokuseret på noget, sporet kan vise. Hvis adfærden kræver et kildedokument, et værktøjsresultat eller et senere kundesvar, skal denne evidens medtages i tekstinteraktionen, hvor den hører til. En definition alene kan ikke fastslå et forhold, der mangler i sporet.
Forbered den forudgående kontekst og den ønskede samtaletur
Det dokumenterede input adskiller forudgående beskeder i span.input fra den ønskede samtaletur i span.output. Hver beskeds indhold er en streng. Indsend den faktiske samtalekontekst og den samtaletur, du vil have scoret, og bevar talerrollerne og den rækkefølge, der kræves for at fortolke den. Dette er en profil til tekstscoring; forberedt dokumenttekst eller en transskription kan være evidens, mens medierne, som teksten stammer fra, ikke i sig selv er det dokumenterede input.
Ved en supportinteraktion skal kundens anmodning bevares sammen med assistentens foreslåede svar. For en agent, der bruger værktøjer, skal den relevante værktøjsobservation og det svar, der byggede på den, bevares. En eksempeldefinition af evidensforankring kan spørge, om assistenten fremsætter en konklusion, som den indsendte observation ikke understøtter. Det nyttige resultat vedrører den definerede adfærd i dette uddrag og er ikke en fuldstændig diagnose af hele applikationen.
Læs tre sandsynligheder for hver definition
Hvert resultat indeholder adfærdens identifikator samt p_present, p_absent og p_not_observable. De tre sandsynligheder summerer til cirka 1. Til stede estimerer, at adfærden forekom; fraværende estimerer, at den ikke gjorde; ikke observerbar estimerer, at det indsendte uddrag mangler den evidens, der kræves for at afgøre det. Det er separate betydninger, som bør holdes adskilt ved fortolkning af resultater.
Et uddrag, der slutter med, at en assistent siger, den vil løse et problem, kan eksempelvis vise et løfte. Det kan endnu ikke vise, at kunden accepterede den senere løsning, hvis der ikke er noget kundesvar. Behandl dette resultat med manglende evidens som ukendt frem for at omdanne det til fraværende. En lav sandsynlighed for tilstedeværelse er ikke automatisk stærk evidens for fravær, når en væsentlig del af fordelingen er ikke observerbar.
Scoring af adfærdsdefinitioner i én gennemløbning
Respan beskriver Span-01 som en ræsonnerende klassifikator, der først er trænet til generel klassifikation med RLAIF og derefter specialiseret til adfærdsgenkendelse. Hver definition kører som en parallel gren over samme spor, og modellen returnerer adfærdssandsynlighederne i én fremadrettet beregning. Hybrid attention understøtter dens behandling af lange, komplekse spor. Den genererer ikke tokens, skriver ikke en fortællende vurdering og producerer ikke en fri forklaring af klassifikationen.
Begrebsvejledningen og scoringsreferencen dokumenterer ingen grænse for antallet af adfærdstyper pr. anmodning. Hver definition er stadig en del af den indsendte evaluering, så hold dem tydelige og relevante frem for at behandle fraværet af en antalsgrænse som evidens for ubegrænset inputkapacitet. Resultatet indeholder én post pr. adfærdstype i anmodningens rækkefølge, identificeret med dens id. Flere definitioner beskriver flere uafhængige observationer; de er ikke gensidigt udelukkende kategorivalg, der skal summere til én på tværs af adfærdstyperne.
Forbered et nyttigt evalueringsresultat
Kombinér de returnerede sandsynligheder med opgavespecifikke tærskler og gennemgangsregler uden for modellen. Producenten anbefaler at bruge mærkede samtaler til at vælge disse tærskler og undersøge grænsetilfælde for tilstedeværelse eller resultater med høj sandsynlighed for ikke observerbar. En supportarbejdsgang kan registrere frustration, en foreslået eskalering og et løfte uden belæg separat. En arbejdsgang for agentkvalitet kan spore gentagne handlinger eller vurdere, om et svar brugte den evidens, der var stillet til rådighed.
Gem tekstuddraget, adfærdsdefinitionen, resultatidentifikatoren og hele den tredelte fordeling sammen. Når definitionen ændres, skal du anerkende, at det ændrer, hvad sandsynligheden måler. Gennemgå tilsyneladende fejl ud fra den faktiske samtale frem for at behandle et numerisk resultat som bevis for en uobserveret hændelse. Et nyttigt resultat er en adfærdsregistrering knyttet til sporet og kriteriet, hvor usikkerhed bevares til senere undersøgelse eller en applikations næste beslutning.
Ailoot Ultra · System One POST /v1/systemone respan/span-01
respan/span-01Start
Span-01 er Respans tekstbaserede adfærdsklassifikator til samtaler og agentspor. Definér adfærdstyperne i almindeligt sprog, så returnerer den tre sandsynligheder for hver: til stede, fraværende og ikke observerbar. Dermed bevares usikkerheden, når det indsendte spor ikke kan afgøre spørgsmålet.
- Accepterede input
- Tekst
- Resultater
- decisions
Tilgængelig i Ailoot · input og metoder
Ailoot Ultra · System One POST /v1/systemone
- Inputtyper
text- Outputtyper
decisions- Outputformat
- json
| Felt | Type | Krav | Værdier og grænser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser respan/span-01 | Standard— |
Feltprovider | Typeschema | KravValgfrit | Værdier og grænser | Standard— |
Feltquestions | Typeobject | KravPåkrævet | Værdier og grænser | Standard— |
Feltsession_id | Typestring | KravValgfrit | Værdier og grænser | Standard— |
Feltstate | Typeschema | KravPåkrævet | Værdier og grænser | Standard— |
Felttrace | Typeschema | KravValgfrit | Værdier og grænser | Standard— |
Feltuser | Typestring | KravValgfrit | Værdier og grænser | Standard— |
Feltquestions.<id>.type | Typestring | KravPåkrævet | Værdier og grænser noul, choice, score | Standard— |
Feltquestions.<id>.instructions | Typestring|object|array | KravPåkrævet | Værdier og grænser | Standard— |
Feltquestions.<id>.criteria | Typeobject|array | KravValgfrit | Værdier og grænser Betingelser: choice/score: påkrævet; noul: valgfrit. Kriterier for choice er et objekt; score er et array med minItems1. | Standard— |
Feltquestions.<id>.criteria.true | Typestring|object|array | KravPåkrævet | Værdier og grænser Gælder når: Der er angivet et noul-kriterieobjekt | Standard— |
Feltquestions.<id>.criteria.false | Typestring|object|array | KravPåkrævet | Værdier og grænser Gælder når: Der er angivet et noul-kriterieobjekt | Standard— |
Kombinationer af inputmaterialer
noul · Påkrævet: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Påkrævet: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Påkrævet: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Metodeparametre og livscyklus
| Parameter | Kontrakt |
|---|---|
Parametercontent_type | Kontraktapplication/json |
Parameterrequired | Kontraktmodel, state, questions |
Parametermaterial_types | Kontrakttext |
Parameteroptional_controls | Kontraktprovider, session_id, trace, user |
Parametermultimodal_input_binding | Kontraktnull |
Livscyklus: synchronous
Send det præcise model-ID, og behold hele det native svar.
Priser
Tarifoplysninger tilføjer ikke anmodningsmuligheder. Understøttede parametre står ved den valgte metode.
- Hurtig tilstand
- Ikke angivet Når hurtig tilstand er valgt
- flex-tilstand
- Ikke angivet Når flex-tilstanden er valgt
- Maksimal ræsonneringsindsats
- Ikke angivet Når default-justeringen anvendes ved maksimal ræsonneringsindsats
Ailoot-takster
Priser efter konfiguration
Knyt hver omkostning til de viste betingelser. Brug én takst for hver gruppe af alternative konfigurationer.
| Konfiguration | Takstplan | Konteksttokens, mere end | Konteksttokens, op til og med | Beløb |
|---|---|---|---|---|
| KonfigurationGrundtakster for tokens | TakstplanGrundtakst | Konteksttokens, mere end— | Konteksttokens, op til og medIngen øvre grænse | Beløb Input · Inputtokens $0.00004 / 1K tokens Output · Outputtokens $0 / 1K tokens Input · Cachelæsning — / 1K tokens Input · Cacheskrivning — / 1K tokens Input · Cacheskrivning, 1 time — / 1K tokens |
| KonfigurationAnmodningslængde · niveau 1 | Takstplan— | Konteksttokens, mere end0 | Konteksttokens, op til og medIngen øvre grænse | Beløb Input · Inputtokens $0.00004 / 1K tokens Output · Outputtokens $0 / 1K tokens Input · Cachelæsning — / 1K tokens Input · Cacheskrivning — / 1K tokens Input · Cacheskrivning, 1 time — / 1K tokens |
Ailoot reserverer et estimeret beløb før en anmodning. Efter resultatet afregnes det endelige beløb ud fra det målte forbrug. Ved streaming bruges den endelige forbrugsregistrering til afregningen. Sådan fungerer reservation og afregning →
Eksempelanmodninger
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
Hent og gem resultater
Ailoot Ultra · System One
json
Behold alle færdige resultater
Gem hvert fuldstændigt returneret svar, hver fil og hver indholdsdel.
Hvert angivet svar på et spørgsmåls-ID bevares med sin præcise type, noul/choice/score-værdi, konfidens, sandsynligheder og forklaring. Hele det oprindelige JSON-svar gemmes og returneres først efter afregning.
Hvis det oprindelige svar skal kontrolleres
Behold den oprindelige operation og hele eller det delvise svar; gentag ikke POST.
Svarfelter
| Felt | Type |
|---|---|
Feltmodel | Typestring |
Feltid | Typestring |
Feltprovider | Typestring |
Feltanswers.<id>.type | Typestring |
Feltanswers.<id>.noul | Typenumber |
Feltanswers.<id>.choice | Typestring |
Feltanswers.<id>.score | Typenumber |
Feltanswers.<id>.confidence | Typenumber |
Feltanswers.<id>.probabilities | Typeobject |
Feltanswers.<id>.legend | Typeobject |
Feltusage.input_tokens | Typeinteger |
Feltusage.output_tokens | Typeinteger |
Feltusage.cost | Typenumber |
Fejl og næste trin
| Svar | Betingelse | Næste trin |
|---|---|---|
Svar400 · invalid_request_error | BetingelseUgyldigt påkrævet felt, ugyldig repræsentation eller ugyldig værdi | Næste trinRet det angivne forespørgselsfelt. |
Aliaser
Modelaliaser
Ailoot Ultra respan/span-01
Aliaser for metodestier
Brug metodestierne vist ovenfor.
Relaterede kalder-ID’er
FAQ · Respan: Span-01
- Hvilke input og resultater er tilgængelige?
POST /v1/systemone·respan/span-01:text→decisions- Hvilke felter bruger anmodningen?
POST /v1/systemone·respan/span-01:model,provider,questions,session_id,state,trace,user