Respan: Span-01 Lite
Span-01 Lite är Respans separat namngivna profil för beteendepoängsättning av textkonversationer och agentspår. Den använder beteenden som anroparen definierar och returnerar för vart och ett sannolikheter för närvarande, frånvarande och ej observerbart, med samma dokumenterade poängsättningsflöde som Span-01.
Om modellen
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
Span-01 Lite är en separat namngiven modellprofil i Respans familj Span-01 för beteendepoängsättning. Producentens snabbstartsguide och modelltabell anger Lite som en av de två profiler som använder samma poängsättningsflöde. Den tar emot en textinteraktion och beteendedefinitioner på vanligt språk och returnerar sedan tre sannolikheter för varje definition: närvarande, frånvarande och ej observerbart. Profilens användbara utdata är en beteendepost med uttrycklig osäkerhet, inte ett skrivet svar i konversationen.
Välj observationen och dess gräns
Definiera beteendet med ord som passar din uppgift. För en kontroll av överlämning anger du om det betyder att användaren uttryckligen ber om en människa, att assistenten säger att en överlämning behövs eller att något av villkoren gäller. Om ren besvikelse inte ska räknas, säg det. För en kontroll av ursäkter definierar du vilka formuleringar som utgör en ursäkt i stället för att förlita dig på en oklar etikett. Varje definition har en identifierare som poängsättaren returnerar tillsammans med sannolikheterna.
Beteendeuppsättningen tillhör anroparen. Exempel som frustration, ogrundade löften, felaktig verktygsanvändning eller repetitiva agentåtgärder är definitioner som du själv anger, inte en fast lista med inbyggda kategorier. Håll varje definition observerbar i den angivna interaktionen. Ett kort avsnitt kan avgöra om assistenten bad om ursäkt men samtidigt sakna belägg för att ett externt problem faktiskt löstes.
Förbered konversationsavsnittet
Respans dokumenterade indata placerar föregående meddelanden i span.input och den tur som utvärderas i span.output. Meddelandeinnehållet är en sträng. Behåll den kontext som behövs för att förstå turen, inklusive talarroller, den relevanta användarbegäran och eventuella textbelägg som assistenten använde. För en kvalitetskontroll anger du den faktiska turen i stället för en omskrivning som tar bort det beteende som bedöms.
En illustrativ granskning kan utgå från ett användarmeddelande som beskriver återkommande problem och ett assistentsvar som erbjuder sig att undersöka saken. Definiera användarens frustration och assistentens löfte som separata observationer. Om ett verktygsresultat är viktigt för att bedöma om ett påstående var grundat, behåll den relevanta texten från resultatet i kontexten. Utdatan är en utvärdering av dessa definitioner i det angivna avsnittet; modellen utför inte den utlovade undersökningen och ändrar inte själva konversationen.
Närvarande, frånvarande och ej observerbart
Poängsättningssvaret innehåller beteendets id med p_present, p_absent och p_not_observable, som tillsammans summerar till ungefär 1. Ej observerbart betyder att spåret inte kan besvara frågan. Det skiljer sig från frånvarande. För en definition som kundens godkännande av en lösning är ett avsnitt som slutar innan kunden reagerar ofullständigt underlag, även om assistentens svar låter säkert.
Behåll alla tre värdena när du förbereder ett resultat för granskning. En kategori som väljs utifrån det högsta värdet kan vara användbar för visning, men fördelningen bevarar hur osäker observationen var. Använd inte enbart ett lågt närvarovärde för att dra slutsatsen att beteendet definitivt inte inträffade. När saknat underlag dominerar kan den användbara åtgärden vara att hämta den relevanta kontexten eller att behålla resultatet som okänt i stället för att hitta på en förklaring.
Flera definitioner över samma underlag
Producentens poängsättningsflöde utvärderar flera beteendedefinitioner tillsammans över ett spår och returnerar ett resultat för varje identifierare i samma ordning som i begäran. Dokumentationen anger inget tak för antalet beteenden per begäran. Det innebär inte ett universellt tokenfönster eller obegränsad spårstorlek. Håll definitionerna ändamålsenliga och underlaget relevant, och bevara kopplingen mellan varje returnerat resultat och den definition som gav upphov till det.
Beteenderesultaten är oberoende observationer snarare än ett enda svar med ömsesidigt uteslutande val. Frustration, en ursäkt och en föreslagen överlämning kan alla förekomma i samma utbyte. Deras enskilda trevägsfördelningar har betydelse inom respektive definition; att addera närvarovärden över olika beteenden ger varken en normaliserad kategorifördelning eller en ordnad poäng enligt en bedömningsmatris.
Behåll den valda profilen tillsammans med resultaten
Tillverkaren dokumenterar Lite-namnet och standardnamnet med en gemensam form för begäran och resultat. Det kontraktet stöder förberedelse av spår och tolkning av beteendesannolikheter för båda de namngivna profilerna. Det visar inte att Lite har samma vikter, antal parametrar eller kvalitet som den andra utgåvan. Håll den valda profilen identifierbar när du granskar dess resultat i stället för att i det tysta byta ut resultat från olika utgåvor.
Använd märkta konversationer från den avsedda uppgiften för att välja tröskelvärden för loggning, routning eller granskning. Behåll resultat med högt värde för ej observerbart och gränsfallsobservationer för inspektion, och jämför varje skenbart fel med den ursprungliga turen och beteendedefinitionen. Den användbara slutliga artefakten innehåller textavsnittets identifierare, definitionen, den valda profilen och det fullständiga trevägsresultatet med sannolikheter. Ett senare steg i applikationen avgör vad som ska göras med observationen; Lites poängutdata utför inte i sig en överlämning, blockerar inte ett svar och genererar ingen rättelse.
Ailoot Ultra · System One POST /v1/systemone respan/span-01-lite
respan/span-01-liteStart
Span-01 Lite är Respans separat namngivna profil för beteendepoängsättning av textkonversationer och agentspår. Den använder beteenden som anroparen definierar och returnerar för vart och ett sannolikheter för närvarande, frånvarande och ej observerbart, med samma dokumenterade poängsättningsflöde som Span-01.
- Godkända indata
- Text
- Resultat
- decisions
Tillgängligt i Ailoot · indata & metoder
Ailoot Ultra · System One POST /v1/systemone
- Indatatyper
text- Utdatatyper
decisions- Utdataformat
- json
| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser respan/span-01-lite | Standard— |
Fältprovider | Typschema | KravValfritt | Värden & gränser | Standard— |
Fältquestions | Typobject | KravObligatoriskt | Värden & gränser | Standard— |
Fältsession_id | Typstring | KravValfritt | Värden & gränser | Standard— |
Fältstate | Typschema | KravObligatoriskt | Värden & gränser | Standard— |
Fälttrace | Typschema | KravValfritt | Värden & gränser | Standard— |
Fältuser | Typstring | KravValfritt | Värden & gränser | Standard— |
Fältquestions.<id>.type | Typstring | KravObligatoriskt | Värden & gränser noul, choice, score | Standard— |
Fältquestions.<id>.instructions | Typstring|object|array | KravObligatoriskt | Värden & gränser | Standard— |
Fältquestions.<id>.criteria | Typobject|array | KravValfritt | Värden & gränser Villkor: choice/score: obligatoriskt; noul: valfritt. Kriterier för choice är ett objekt; score är en array med minItems1. | Standard— |
Fältquestions.<id>.criteria.true | Typstring|object|array | KravObligatoriskt | Värden & gränser Gäller när: Ett kriterieobjekt för noul har angetts | Standard— |
Fältquestions.<id>.criteria.false | Typstring|object|array | KravObligatoriskt | Värden & gränser Gäller när: Ett kriterieobjekt för noul har angetts | Standard— |
Kombinationer av indatamaterial
noul · Krävs: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Krävs: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Krävs: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, state, questions |
Parametermaterial_types | Avtaltext |
Parameteroptional_controls | Avtalprovider, session_id, trace, user |
Parametermultimodal_input_binding | Avtalnull |
Livscykel: synchronous
Skicka det exakta modell-ID:t och behåll hela svaret i leverantörens format.
Priser
Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.
- Snabbt läge
- Ej angivet När snabbt läge är valt
- Flex-läge
- Ej angivet När läget flex är valt
- Högsta resonemangsnivå
- Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)
Ailoot-priser
Priser efter konfiguration
Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.
| Konfiguration | Prislista | Kontexttoken, fler än | Kontexttoken, upp till och med | Avgift |
|---|---|---|---|---|
| KonfigurationGrundpriser för token | PrislistaGrundpris | Kontexttoken, fler än— | Kontexttoken, upp till och medIngen övre gräns | Avgift Indata · Indatatoken $0 / 1K token Utdata · Utdatatoken $0 / 1K token Indata · Cacheläsning — / 1K token Indata · Skrivning till cache — / 1K token Indata · Skrivning till cache, 1 tim — / 1K token |
| KonfigurationNivå 1 för förfrågans längd | Prislista— | Kontexttoken, fler än0 | Kontexttoken, upp till och medIngen övre gräns | Avgift Indata · Indatatoken $0 / 1K token Utdata · Utdatatoken $0 / 1K token Indata · Cacheläsning — / 1K token Indata · Skrivning till cache — / 1K token Indata · Skrivning till cache, 1 tim — / 1K token |
Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
Exempelbegäranden
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
Ta emot och spara resultat
Ailoot Ultra · System One
json
Behåll alla färdiga resultat
Behåll varje fullständigt returnerat svar, fil och innehållsdel.
Varje angivet svar för ett fråge-ID behålls med sin exakta typ, värdet noul/choice/score, konfidens, sannolikheter och teckenförklaring. Hela det ursprungliga JSON-svaret lagras och returneras först efter avräkning.
Om det ursprungliga svaret behöver kontrolleras
Bevara den ursprungliga operationen och hela eller det partiella svaret; upprepa inte POST.
Svarsfält
| Fält | Typ |
|---|---|
Fältmodel | Typstring |
Fältid | Typstring |
Fältprovider | Typstring |
Fältanswers.<id>.type | Typstring |
Fältanswers.<id>.noul | Typnumber |
Fältanswers.<id>.choice | Typstring |
Fältanswers.<id>.score | Typnumber |
Fältanswers.<id>.confidence | Typnumber |
Fältanswers.<id>.probabilities | Typobject |
Fältanswers.<id>.legend | Typobject |
Fältusage.input_tokens | Typinteger |
Fältusage.output_tokens | Typinteger |
Fältusage.cost | Typnumber |
Fel och nästa steg
| Svar | Villkor | Nästa steg |
|---|---|---|
Svar400 · invalid_request_error | VillkorOgiltigt obligatoriskt fält, ogiltig representation eller ogiltigt värde | Nästa stegKorrigera det angivna fältet i begäran. |
Alias
Modellalias
Ailoot Ultra respan/span-01-lite
Alias för metodsökvägar
Använd metodsökvägarna som visas ovan.
Relaterade anropar-ID:n
FAQ · Respan: Span-01 Lite
- Vilka indata och resultat finns?
POST /v1/systemone·respan/span-01-lite:text→decisions- Vilka fält använder begäran?
POST /v1/systemone·respan/span-01-lite:model,provider,questions,session_id,state,trace,user