Respan: Span-01 Lite
Span-01 Lite è il profilo di Respan, con un nome proprio distinto, per l'assegnazione di punteggi ai comportamenti in conversazioni testuali e tracce di agenti. Utilizza comportamenti definiti dal chiamante e restituisce per ciascuno le probabilità presente, assente e non osservabile, con lo stesso flusso di valutazione documentato di Span-01.
Informazioni sul modello
Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.
Span-01 Lite è un profilo di modello con nome distinto all'interno della famiglia Span-01 di Respan per l'assegnazione di punteggi ai comportamenti. La guida rapida e la tabella dei modelli del produttore indicano Lite come uno dei due profili che utilizzano lo stesso flusso di valutazione. Riceve un'interazione testuale e definizioni di comportamento in linguaggio semplice, quindi restituisce tre probabilità per ogni definizione: presente, assente e non osservabile. L'output utile del profilo è un record del comportamento con incertezza esplicita, non una risposta scritta alla conversazione.
Scegli l'osservazione e i suoi confini
Definisci il comportamento con parole adatte alla tua attività. Per un controllo sul passaggio a un operatore, specifica se significa che l'utente chiede esplicitamente una persona, che l'assistente dichiara necessario il passaggio, oppure una delle due condizioni. Se la semplice delusione non deve contare, dillo. Per un controllo sulle scuse, definisci quale formulazione costituisce una scusa invece di affidarti a un'etichetta poco chiara. Ogni definizione ha un identificatore che il valutatore restituisce insieme alle sue probabilità.
L'insieme dei comportamenti appartiene al chiamante. Esempi come frustrazione, promesse non supportate, uso improprio degli strumenti o azioni ripetitive dell'agente sono definizioni da fornire, non un elenco fisso di categorie native. Mantieni ogni definizione osservabile nell'interazione fornita. Un breve segmento può stabilire se l'assistente si è scusato pur mancando di prove che un problema esterno sia stato effettivamente risolto.
Prepara il segmento di conversazione
L'input documentato da Respan colloca i messaggi precedenti in span.input e il turno da valutare in span.output. Il contenuto del messaggio è una stringa. Conserva il contesto necessario per comprendere il turno, inclusi i ruoli dei partecipanti, la richiesta pertinente dell'utente e qualsiasi prova testuale utilizzata dall'assistente. Per un controllo di qualità, fornisci il turno effettivo anziché una parafrasi che elimini il comportamento da valutare.
Una revisione illustrativa può prendere un messaggio dell'utente che descrive problemi ripetuti e una risposta dell'assistente che si offre di indagare. Definisci la frustrazione dell'utente e una promessa dell'assistente come osservazioni separate. Se il risultato di uno strumento è rilevante per giudicare se un'affermazione era fondata, conserva nel contesto il testo pertinente di quel risultato. L'output è una valutazione di quelle definizioni nel segmento fornito; il modello non svolge l'indagine promessa né modifica la conversazione stessa.
Presente, assente e non osservabile
La risposta di valutazione contiene l'id del comportamento con p_present, p_absent e p_not_observable, la cui somma è circa 1. Non osservabile significa che la traccia non permette di rispondere alla domanda. È diverso da assente. Per una definizione come l'accettazione di una soluzione da parte del cliente, un segmento che si interrompe prima della reazione del cliente costituisce una prova incompleta, anche se la risposta dell'assistente suona sicura.
Conserva tutti e tre i valori quando prepari un risultato per la revisione. Una categoria scelta in base al valore più alto può essere utile per la visualizzazione, ma la distribuzione conserva il grado di incertezza dell'osservazione. Non usare un basso valore di presenza da solo per concludere che il comportamento sicuramente non si è verificato. Quando prevale la mancanza di prove, l'azione utile può essere ottenere il contesto pertinente o conservare il risultato come sconosciuto, invece di inventare una spiegazione.
Più definizioni sulle stesse prove
Il flusso di valutazione del produttore valuta più definizioni di comportamento insieme su un'unica traccia e restituisce un risultato per ogni identificatore nell'ordine della richiesta. La sua documentazione non specifica alcun limite al numero di comportamenti per richiesta. Ciò non stabilisce una finestra di token universale né una dimensione illimitata della traccia. Mantieni le definizioni mirate e le prove pertinenti, e conserva l'associazione tra ogni risultato restituito e la definizione che lo ha prodotto.
I risultati sui comportamenti sono osservazioni indipendenti, non una singola risposta a scelta esclusiva. Frustrazione, scuse e una proposta di passaggio a un operatore possono essere tutte presenti nello stesso scambio. Le singole distribuzioni a tre vie hanno significato all'interno di ciascuna definizione; sommare i valori di presenza di comportamenti diversi non crea una distribuzione di categorie normalizzata né un punteggio ordinato secondo una rubrica.
Mantieni il profilo selezionato con i suoi risultati
Il produttore documenta i nomi Lite e standard con una forma di richiesta e di risultato condivisa. Questo contratto permette di preparare le tracce e interpretare le probabilità dei comportamenti per entrambi i profili nominati. Non stabilisce che Lite abbia gli stessi pesi, lo stesso numero di parametri o la stessa qualità dell'altra edizione. Mantieni identificabile il profilo selezionato quando ne esamini i risultati, invece di scambiare silenziosamente risultati di edizioni diverse.
Usa conversazioni etichettate dell'attività prevista per scegliere le soglie di registrazione, instradamento o revisione. Conserva per l'ispezione i risultati con valori elevati di non osservabile e le osservazioni al limite, e confronta qualsiasi errore apparente con il turno originale e la definizione del comportamento. L'artefatto finale utile contiene l'identificatore del segmento di testo, la definizione, il profilo selezionato e il risultato completo delle probabilità a tre vie. Un passaggio successivo dell'applicazione decide cosa fare con quell'osservazione; l'output di valutazione di Lite non esegue di per sé un passaggio a un operatore, non blocca una risposta né genera una correzione.
Ailoot Ultra · System One POST /v1/systemone respan/span-01-lite
respan/span-01-liteIntroduzione
Span-01 Lite è il profilo di Respan, con un nome proprio distinto, per l'assegnazione di punteggi ai comportamenti in conversazioni testuali e tracce di agenti. Utilizza comportamenti definiti dal chiamante e restituisce per ciascuno le probabilità presente, assente e non osservabile, con lo stesso flusso di valutazione documentato di Span-01.
- Input accettati
- Testo
- Risultati
- decisions
Disponibile in Ailoot · input e metodi
Ailoot Ultra · System One POST /v1/systemone
- Tipi di input
text- Tipi di output
decisions- Formato di output
- json
| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti respan/span-01-lite | Predefinito— |
Campoprovider | Tiposchema | RequisitoFacoltativo | Valori e limiti | Predefinito— |
Campoquestions | Tipoobject | RequisitoObbligatorio | Valori e limiti | Predefinito— |
Camposession_id | Tipostring | RequisitoFacoltativo | Valori e limiti | Predefinito— |
Campostate | Tiposchema | RequisitoObbligatorio | Valori e limiti | Predefinito— |
Campotrace | Tiposchema | RequisitoFacoltativo | Valori e limiti | Predefinito— |
Campouser | Tipostring | RequisitoFacoltativo | Valori e limiti | Predefinito— |
Campoquestions.<id>.type | Tipostring | RequisitoObbligatorio | Valori e limiti noul, choice, score | Predefinito— |
Campoquestions.<id>.instructions | Tipostring|object|array | RequisitoObbligatorio | Valori e limiti | Predefinito— |
Campoquestions.<id>.criteria | Tipoobject|array | RequisitoFacoltativo | Valori e limiti Condizioni: choice/score: obbligatori; noul: facoltativo. I criteri di choice sono un oggetto; score è un array con minItems1. | Predefinito— |
Campoquestions.<id>.criteria.true | Tipostring|object|array | RequisitoObbligatorio | Valori e limiti Si applica quando: Oggetto criteria noul fornito | Predefinito— |
Campoquestions.<id>.criteria.false | Tipostring|object|array | RequisitoObbligatorio | Valori e limiti Si applica quando: Oggetto criteria noul fornito | Predefinito— |
Combinazioni di materiali in input
noul · Obbligatorio: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Obbligatorio: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Obbligatorio: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Parametri e ciclo di vita del metodo
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, state, questions |
Parametromaterial_types | Contrattotext |
Parametrooptional_controls | Contrattoprovider, session_id, trace, user |
Parametromultimodal_input_binding | Contrattonull |
Ciclo di vita: synchronous
Invia l'ID esatto del modello e conserva l'intera risposta nativa.
Tariffe
Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.
- Modalità rapida
- Non specificato Quando è selezionata la modalità rapida
- Modalità flex
- Non specificato Quando è selezionata la modalità flex
- Sforzo massimo di ragionamento
- Non specificato Quando lo sforzo massimo di ragionamento usa l'adeguamento predefinito (default)
Tariffe Ailoot
Prezzi per configurazione
Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.
| Configurazione | Listino delle tariffe | Token di contesto, più di | Token di contesto, fino al limite incluso | Costo |
|---|---|---|---|---|
| ConfigurazioneTariffe di base dei token | Listino delle tariffeTariffa base | Token di contesto, più di— | Token di contesto, fino al limite inclusoNessun limite superiore | Costo Input · Token in input $0 / 1K token Output · Token in output $0 / 1K token Input · Lettura dalla cache — / 1K token Input · Scrittura nella cache — / 1K token Input · Scrittura nella cache, 1 ora — / 1K token |
| ConfigurazioneFascia 1 di lunghezza della richiesta | Listino delle tariffe— | Token di contesto, più di0 | Token di contesto, fino al limite inclusoNessun limite superiore | Costo Input · Token in input $0 / 1K token Output · Token in output $0 / 1K token Input · Lettura dalla cache — / 1K token Input · Scrittura nella cache — / 1K token Input · Scrittura nella cache, 1 ora — / 1K token |
Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →
Esempi di richieste
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
Ricevi e salva i risultati
Ailoot Ultra · System One
json
Conserva tutti i risultati completati
Conserva ogni risposta, file e parte di contenuto restituiti per intero.
Viene conservata ogni risposta associata all'ID della domanda fornito, con il tipo esatto, il valore noul/choice/score, la confidenza, le probabilità e la legenda. L'intero JSON originale viene memorizzato e restituito solo dopo il conguaglio dell'addebito.
Se occorre verificare la risposta originale
Conserva l'operazione originale e la risposta completa o parziale; non ripetere POST.
Campi della risposta
| Campo | Tipo |
|---|---|
Campomodel | Tipostring |
Campoid | Tipostring |
Campoprovider | Tipostring |
Campoanswers.<id>.type | Tipostring |
Campoanswers.<id>.noul | Tiponumber |
Campoanswers.<id>.choice | Tipostring |
Campoanswers.<id>.score | Tiponumber |
Campoanswers.<id>.confidence | Tiponumber |
Campoanswers.<id>.probabilities | Tipoobject |
Campoanswers.<id>.legend | Tipoobject |
Campousage.input_tokens | Tipointeger |
Campousage.output_tokens | Tipointeger |
Campousage.cost | Tiponumber |
Errori e passaggi successivi
| Risposta | Condizione | Passaggio successivo |
|---|---|---|
Risposta400 · invalid_request_error | CondizioneCampo obbligatorio, rappresentazione o valore non valido | Passaggio successivoCorreggi il campo della richiesta indicato. |
Alias
Alias del modello
Ailoot Ultra respan/span-01-lite
Alias dei percorsi dei metodi
Usa i percorsi dei metodi indicati sopra.
ID di chiamata correlati
FAQ · Respan: Span-01 Lite
- Quali input e risultati sono disponibili?
POST /v1/systemone·respan/span-01-lite:text→decisions- Quali campi usa la richiesta?
POST /v1/systemone·respan/span-01-lite:model,provider,questions,session_id,state,trace,user