Respan: Span-01 Lite
Span-01 Lite er Respans særskilt navngivne profil til adfærdsscoring af tekstsamtaler og agentspor. Den bruger adfærdstyper defineret af kalderen og returnerer for hver sandsynligheder for til stede, fraværende og ikke observerbar med samme dokumenterede scoringsarbejdsgang som Span-01.
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 Lite er en særskilt navngiven modelprofil i Respans Span-01-familie til adfærdsscoring. Producentens hurtigstart og modeltabel angiver Lite som en af to profiler med samme scoringsarbejdsgang. Den modtager en tekstinteraktion og adfærdsdefinitioner i almindeligt sprog og returnerer derefter tre sandsynligheder for hver definition: til stede, fraværende og ikke observerbar. Profilens nyttige output er en adfærdsregistrering med udtrykkelig usikkerhed, ikke et skriftligt svar på samtalen.
Vælg observationen og dens afgrænsning
Definér adfærden med ord, der passer til din opgave. Ved en kontrol af overdragelse skal du angive, om det betyder, at brugeren udtrykkeligt beder om en person, at assistenten siger, en overdragelse er nødvendig, eller at en af disse betingelser er opfyldt. Hvis skuffelse alene ikke skal tælle, skal du sige det. Ved en undskyldningskontrol skal du definere, hvilken formulering der udgør en undskyldning, frem for at stole på en uklar etiket. Hver definition har en identifikator, som scoringsmodellen returnerer sammen med sandsynlighederne.
Adfærdssættet tilhører kalderen. Eksempler som frustration, løfter uden belæg, misbrug af værktøjer eller gentagne agenthandlinger er definitioner, der skal indsendes, og ikke en fast liste af native kategorier. Hold hver definition observerbar i den indsendte interaktion. Et kort uddrag kan afgøre, om assistenten undskyldte, samtidig med at det mangler evidens for, at et eksternt problem faktisk blev løst.
Forbered samtaleuddraget
Respans dokumenterede input placerer forudgående beskeder i span.input og den samtaletur, der vurderes, i span.output. Beskedindhold er en streng. Bevar den kontekst, der er nødvendig for at forstå samtaleturen, herunder talerroller, brugerens relevante anmodning og eventuel tekstlig evidens, som assistenten brugte. Ved en kvalitetskontrol skal du indsende den faktiske samtaletur frem for en parafrase, der fjerner den adfærd, som vurderes.
En eksempelgennemgang kan tage udgangspunkt i en brugerbesked om gentagne problemer og et assistantsvar med tilbud om at undersøge sagen. Definér brugerfrustration og et assistentløfte som særskilte observationer. Hvis et værktøjsresultat er vigtigt for at vurdere, om en påstand havde belæg, skal resultatets relevante tekst bevares i konteksten. Outputtet er en vurdering af disse definitioner i det indsendte uddrag; modellen udfører ikke den lovede undersøgelse og ændrer ikke selve samtalen.
Til stede, fraværende og ikke observerbar
Scoringssvaret indeholder adfærdens id med p_present, p_absent og p_not_observable, som tilsammen er cirka 1. Ikke observerbar betyder, at sporet ikke kan besvare spørgsmålet. Det er forskelligt fra fraværende. For en definition som kundens accept af en løsning er et uddrag, der slutter før kundens reaktion, ufuldstændig evidens, selv hvis assistentens svar lyder sikkert.
Bevar alle tre værdier, når du forbereder et resultat til gennemgang. En kategori valgt efter den højeste værdi kan være nyttig i en visning, men fordelingen bevarer, hvor usikker observationen var. Brug ikke alene en lav tilstedeværelsesværdi til at konkludere, at adfærden helt sikkert ikke forekom. Når manglende evidens dominerer, kan den nyttige handling være at indhente relevant kontekst eller beholde resultatet som ukendt frem for at opfinde en forklaring.
Flere definitioner over samme evidens
Producentens scoringsarbejdsgang vurderer flere adfærdsdefinitioner samlet over ét spor og returnerer et resultat for hver identifikator i anmodningens rækkefølge. Dokumentationen angiver ingen grænse for antallet af adfærdstyper pr. anmodning. Det fastslår ikke et universelt tokenvindue eller en ubegrænset sporstørrelse. Hold definitionerne målrettede og evidensen relevant, og bevar tilknytningen mellem hvert returneret resultat og den definition, der frembragte det.
Adfærdsresultaterne er uafhængige observationer frem for ét svar med et enkelt eksklusivt valg. Frustration, en undskyldning og en foreslået overdragelse kan alle være til stede i samme udveksling. Deres individuelle tredelte fordelinger har betydning inden for hver definition; at lægge tilstedeværelsesværdier sammen på tværs af forskellige adfærdstyper skaber ikke en normaliseret kategorifordeling eller en ordnet score efter en vurderingsrubrik.
Bevar den valgte profil sammen med dens resultater
Producenten dokumenterer Lite- og standardnavnene med fælles anmodnings- og resultatformat. Denne kontrakt understøtter forberedelse af spor og fortolkning af adfærdssandsynligheder for begge navngivne profiler. Den fastslår ikke, at Lite har samme vægte, parameterantal eller kvalitet som den anden udgave. Hold den valgte profil identificerbar ved gennemgang af dens resultater frem for stiltiende at udveksle resultater fra forskellige udgaver.
Brug mærkede samtaler fra den tilsigtede opgave til at vælge tærskler for logning, routing eller gennemgang. Bevar resultater med høj sandsynlighed for ikke observerbar og grænsetilfælde til undersøgelse, og sammenlign enhver tilsyneladende fejl med den oprindelige samtaletur og adfærdsdefinition. Det nyttige endelige resultat indeholder tekstuddragets identifikator, definitionen, den valgte profil og det komplette tredelte sandsynlighedsresultat. Et senere applikationstrin beslutter, hvad der skal ske med observationen; Lites scoringsoutput udfører ikke i sig selv en overdragelse, blokerer et svar eller genererer en rettelse.
Ailoot Ultra · System One POST /v1/systemone respan/span-01-lite
respan/span-01-liteStart
Span-01 Lite er Respans særskilt navngivne profil til adfærdsscoring af tekstsamtaler og agentspor. Den bruger adfærdstyper defineret af kalderen og returnerer for hver sandsynligheder for til stede, fraværende og ikke observerbar med samme dokumenterede scoringsarbejdsgang som Span-01.
- 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-lite | 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 / 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 / 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-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
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-lite
Aliaser for metodestier
Brug metodestierne vist ovenfor.
Relaterede kalder-ID’er
FAQ · Respan: Span-01 Lite
- Hvilke input og resultater er tilgængelige?
POST /v1/systemone·respan/span-01-lite:text→decisions- Hvilke felter bruger anmodningen?
POST /v1/systemone·respan/span-01-lite:model,provider,questions,session_id,state,trace,user