Respan: Span-01 Lite
Span-01 Lite er en egen navngitt profil fra Respan for atferdsskåring av tekstsamtaler og agentspor. Den bruker atferdstyper definert av den som kaller modellen, og returnerer sannsynligheter for til stede, fraværende og ikke observerbar for hver av dem, med den samme dokumenterte skåringsflyten som Span-01.
Om modellen
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
Span-01 Lite er en egen navngitt modellprofil i Respans Span-01-familie for atferdsskåring. Produsentens hurtigstart og modelltabell angir Lite som en av de to profilene som bruker den samme skåringsflyten. Den mottar en tekstinteraksjon og atferdsdefinisjoner skrevet i vanlig språk, og returnerer deretter tre sannsynligheter for hver definisjon: til stede, fraværende og ikke observerbar. Det nyttige resultatet fra profilen er en atferdsregistrering med eksplisitt usikkerhet, ikke et skriftlig svar i samtalen.
Velg observasjonen og avgrensningen
Definer atferden med ordene som passer oppgaven din. For en kontroll av overlevering til et menneske angir du om det betyr at brukeren uttrykkelig ber om en person, at assistenten sier at en overlevering trengs, eller at én av disse betingelsene er oppfylt. Hvis ren skuffelse ikke skal telle, må du si det. For en kontroll av unnskyldninger definerer du hvilke formuleringer som utgjør en unnskyldning, i stedet for å stole på en uklar etikett. Hver definisjon har en identifikator som skåreren returnerer sammen med sannsynlighetene.
Settet med atferdstyper tilhører den som kaller modellen. Eksempler som frustrasjon, løfter uten dekning, feil bruk av verktøy eller gjentatte agenthandlinger er definisjoner du selv oppgir, ikke en fast liste med innebygde kategorier. Sørg for at hver definisjon kan observeres i den oppgitte interaksjonen. Et kort utsnitt kan avgjøre om assistenten ba om unnskyldning, men samtidig mangle grunnlag for at et eksternt problem faktisk ble løst.
Forbered samtaleutsnittet
I Respans dokumenterte inndata ligger de foregående meldingene i span.input og replikken som vurderes, i span.output. Meldingsinnholdet er en streng. Bevar konteksten som trengs for å forstå replikken, inkludert talerroller, den relevante forespørselen fra brukeren og eventuelt tekstgrunnlag assistenten brukte. For en kvalitetskontroll oppgir du den faktiske replikken, ikke en omskrivning som fjerner atferden som vurderes.
En illustrerende gjennomgang kan ta for seg en brukermelding som beskriver gjentatte problemer, og et svar fra assistenten som tilbyr å undersøke saken. Definer brukerens frustrasjon og assistentens løfte som separate observasjoner. Hvis et verktøyresultat har betydning for å avgjøre om en påstand var underbygget, beholder du den relevante teksten fra resultatet i konteksten. Utdataene er en vurdering av disse definisjonene i det oppgitte utsnittet; modellen utfører ikke den lovede undersøkelsen og endrer heller ikke selve samtalen.
Til stede, fraværende og ikke observerbar
Skåringssvaret inneholder atferdens id med p_present, p_absent og p_not_observable, som til sammen blir omtrent 1. Ikke observerbar betyr at sporet ikke kan besvare spørsmålet. Det er noe annet enn fraværende. For en definisjon som at kunden godtar en løsning, er et utsnitt som slutter før kunden reagerer, ufullstendig grunnlag, selv om assistentens svar virker sikkert.
Behold alle tre verdiene når du forbereder et resultat for gjennomgang. En kategori valgt etter den høyeste verdien kan være nyttig i en visning, men fordelingen bevarer hvor usikker observasjonen var. Ikke bruk en lav verdi for til stede alene til å konkludere med at atferden helt sikkert ikke forekom. Når manglende grunnlag dominerer, kan det nyttige tiltaket være å skaffe den relevante konteksten eller beholde resultatet som ukjent, i stedet for å finne på en forklaring.
Flere definisjoner over det samme grunnlaget
Produsentens skåringsflyt vurderer flere atferdsdefinisjoner samlet over ett spor og returnerer et resultat for hver identifikator i den rekkefølgen de står i forespørselen. Dokumentasjonen angir ingen øvre grense for antall atferdstyper per forespørsel. Dette fastsetter ikke et universelt tokenvindu eller ubegrenset sporstørrelse. Hold definisjonene målrettede og grunnlaget relevant, og bevar koblingen mellom hvert returnert resultat og definisjonen som ga det.
Atferdsresultatene er uavhengige observasjoner, ikke ett svar der bare ett alternativ kan velges. Frustrasjon, en unnskyldning og en foreslått overlevering kan alle være til stede i samme utveksling. Hver av de tredelte fordelingene har mening innenfor sin egen definisjon; å legge sammen verdiene for til stede på tvers av ulike atferdstyper gir ikke en normalisert kategorifordeling eller en ordnet skår på en vurderingsskala.
Hold den valgte profilen sammen med resultatene
Produsenten dokumenterer Lite-navnet og standardnavnet med en felles form for forespørsel og resultat. Denne kontrakten gjør det mulig å forberede spor og tolke atferdssannsynligheter for begge de navngitte profilene. Den viser ikke at Lite har de samme vektene, det samme antallet parametere eller den samme kvaliteten som den andre utgaven. Sørg for at den valgte profilen kan identifiseres når resultatene gjennomgås, i stedet for stilltiende å bytte om resultater fra ulike utgaver.
Bruk merkede samtaler fra den tiltenkte oppgaven til å velge terskler for logging, ruting eller gjennomgang. Ta vare på resultater med høy verdi for ikke observerbar og grensetilfeller for nærmere inspeksjon, og sammenlign enhver tilsynelatende feil med den opprinnelige replikken og atferdsdefinisjonen. Det nyttige sluttresultatet inneholder tekstutsnittets identifikator, definisjonen, den valgte profilen og det fullstendige tredelte sannsynlighetsresultatet. Et senere trinn i applikasjonen avgjør hva som skal gjøres med observasjonen; skåringsutdataene fra Lite utfører ikke i seg selv en overlevering, blokkerer ikke et svar og genererer ingen reparasjon.
Ailoot Ultra · System One POST /v1/systemone respan/span-01-lite
respan/span-01-liteStart
Span-01 Lite er en egen navngitt profil fra Respan for atferdsskåring av tekstsamtaler og agentspor. Den bruker atferdstyper definert av den som kaller modellen, og returnerer sannsynligheter for til stede, fraværende og ikke observerbar for hver av dem, med den samme dokumenterte skåringsflyten som Span-01.
- Godkjente inndata
- Tekst
- Resultater
- decisions
Tilgjengelig i Ailoot · inndata & metoder
Ailoot Ultra · System One POST /v1/systemone
- Inndatatyper
text- Utdatatyper
decisions- Utdataformat
- json
| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser respan/span-01-lite | Standard— |
Feltprovider | Typeschema | KravValgfritt | Verdier & grenser | Standard— |
Feltquestions | Typeobject | KravPåkrevd | Verdier & grenser | Standard— |
Feltsession_id | Typestring | KravValgfritt | Verdier & grenser | Standard— |
Feltstate | Typeschema | KravPåkrevd | Verdier & grenser | Standard— |
Felttrace | Typeschema | KravValgfritt | Verdier & grenser | Standard— |
Feltuser | Typestring | KravValgfritt | Verdier & grenser | Standard— |
Feltquestions.<id>.type | Typestring | KravPåkrevd | Verdier & grenser noul, choice, score | Standard— |
Feltquestions.<id>.instructions | Typestring|object|array | KravPåkrevd | Verdier & grenser | Standard— |
Feltquestions.<id>.criteria | Typeobject|array | KravValgfritt | Verdier & grenser Vilkår: choice/score: påkrevd; noul: valgfritt. Kriteriene for choice er et objekt; score er en matrise med minItems1. | Standard— |
Feltquestions.<id>.criteria.true | Typestring|object|array | KravPåkrevd | Verdier & grenser Gjelder når: Kriterieobjektet noul er angitt | Standard— |
Feltquestions.<id>.criteria.false | Typestring|object|array | KravPåkrevd | Verdier & grenser Gjelder når: Kriterieobjektet noul er angitt | Standard— |
Kombinasjoner av inngående materialer
noul · Påkrevd: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Påkrevd: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Påkrevd: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Metodeparametere og livssyklus
| Parameter | Avtale |
|---|---|
Parametercontent_type | Avtaleapplication/json |
Parameterrequired | Avtalemodel, state, questions |
Parametermaterial_types | Avtaletext |
Parameteroptional_controls | Avtaleprovider, session_id, trace, user |
Parametermultimodal_input_binding | Avtalenull |
Livssyklus: synchronous
Send den eksakte modell-ID-en og behold hele svaret i det opprinnelige formatet.
Priser
Tariffopplysninger legger ikke til forespørselsvalg. Støttede parametere står ved den valgte metoden.
- Hurtigmodus
- Ikke angitt Når hurtigmodus er valgt
- Flex-modus
- Ikke angitt Når flex-modus er valgt
- Maksimal resonneringsinnsats
- Ikke angitt Når justeringen «default» brukes for maksimal resonneringsinnsats
Ailoot-satser
Priser etter konfigurasjon
Knytt hver kostnad til de viste vilkårene. Bruk én sats for hvert sett med alternative konfigurasjoner.
| Konfigurasjon | Prisplan | Konteksttokener, mer enn | Konteksttokener, opptil og med | Kostnad |
|---|---|---|---|---|
| KonfigurasjonGrunnpriser for tokener | PrisplanGrunnsats | Konteksttokener, mer enn— | Konteksttokener, opptil og medIngen øvre grense | Kostnad Inndata · Inngående tokener $0 / 1K tokener Utdata · Utgående tokener $0 / 1K tokener Inndata · Lesing fra hurtigbuffer — / 1K tokener Inndata · Skriving til hurtigbuffer — / 1K tokener Inndata · Skriving til hurtigbuffer, 1 time — / 1K tokener |
| KonfigurasjonNivå 1 for forespørselslengde | Prisplan— | Konteksttokener, mer enn0 | Konteksttokener, opptil og medIngen øvre grense | Kostnad Inndata · Inngående tokener $0 / 1K tokener Utdata · Utgående tokener $0 / 1K tokener Inndata · Lesing fra hurtigbuffer — / 1K tokener Inndata · Skriving til hurtigbuffer — / 1K tokener Inndata · Skriving til hurtigbuffer, 1 time — / 1K tokener |
Ailoot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →
Eksempelforespørsler
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
Motta og lagre resultater
Ailoot Ultra · System One
json
Behold alle ferdige resultater
Behold alle fullstendige returnerte svar, filer og innholdsdeler.
Hvert oppgitt svar knyttet til en spørsmåls-ID bevares med sin eksakte type, noul/choice/score-verdi, konfidens, sannsynligheter og tegnforklaring. Hele det opprinnelige JSON-svaret lagres og returneres først etter oppgjør.
Hvis det opprinnelige svaret må kontrolleres
Behold den opprinnelige operasjonen og hele eller deler av svaret; ikke gjenta 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 |
Feil og neste trinn
| Svar | Vilkår | Neste trinn |
|---|---|---|
Svar400 · invalid_request_error | VilkårUgyldig påkrevd felt, representasjon eller verdi | Neste trinnKorriger det angitte forespørselsfeltet. |
Aliaser
Modellaliaser
Ailoot Ultra respan/span-01-lite
Aliaser for metodestier
Bruk metodestiene som vises ovenfor.
Tilknyttede anroper-ID-er
FAQ · Respan: Span-01 Lite
- Hvilke inndata og resultater er tilgjengelige?
POST /v1/systemone·respan/span-01-lite:text→decisions- Hvilke felt bruker forespørselen?
POST /v1/systemone·respan/span-01-lite:model,provider,questions,session_id,state,trace,user