Respan: Span-01
Span-01 è il classificatore di comportamenti testuali di Respan per conversazioni e tracce di agenti. Definisci i comportamenti in linguaggio semplice e il modello restituisce tre probabilità per ciascuno: presente, assente e non osservabile, preservando l'incertezza quando la traccia fornita non permette di risolvere la questione.
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 è il modello di Respan per l'assegnazione di punteggi ai comportamenti in conversazioni e tracce di agenti. Legge un'interazione testuale insieme a definizioni di comportamento scritte in linguaggio semplice e restituisce probabilità per ciascuna definizione. L'output distingue se un comportamento è presente, assente o non osservabile nella traccia fornita. Questo offre a un flusso di valutazione un segnale numerico con un modo esplicito di rappresentare la mancanza di prove, invece di una spiegazione generata da analizzare.
Definisci il comportamento che vuoi osservare
I comportamenti sono forniti dal chiamante. Iniezione di prompt, affermazioni non supportate, esposizione di segreti, cicli ripetitivi, uso improprio degli strumenti e frustrazione dell'utente sono possibili definizioni, non una tassonomia fissa integrata nel modello. Specifica che cosa rientra nel comportamento e che cosa no. Una definizione ristretta può distinguere un utente che chiede di parlare con un operatore umano da uno che esprime semplicemente delusione. Un'altra può distinguere un assistente che riconosce un problema da uno che promette un'azione che non può compiere.
Usa identificatori stabili con le definizioni, così i risultati restano associati al comportamento valutato. Mantieni il criterio focalizzato su qualcosa che la traccia può mostrare. Se il comportamento richiede un documento di origine, il risultato di uno strumento o una successiva risposta del cliente, includi quella prova nell'interazione testuale, nella posizione appropriata. Una definizione da sola non può stabilire un fatto assente dalla traccia.
Prepara il contesto precedente e il turno da valutare
L'input documentato separa i messaggi precedenti in span.input dal turno da valutare in span.output. Il contenuto di ogni messaggio è una stringa. Fornisci il contesto effettivo della conversazione e il turno che vuoi valutare, mantenendo i ruoli dei partecipanti e l'ordine necessari per interpretarlo. Si tratta di un profilo di valutazione del testo: il testo preparato di un documento o una trascrizione possono costituire prove, mentre i contenuti multimediali da cui quel testo è stato ricavato non sono di per sé l'input documentato.
Per un'interazione di assistenza, mantieni la richiesta del cliente insieme alla risposta proposta dall'assistente. Per un agente che usa strumenti, conserva l'osservazione pertinente dello strumento e la risposta che si è basata su di essa. Una definizione illustrativa di aderenza alle prove potrebbe chiedere se l'assistente afferma una conclusione non supportata dall'osservazione fornita. Il risultato utile riguarda il comportamento definito in quel segmento, non una diagnosi completa dell'intera applicazione.
Leggi tre probabilità per ogni definizione
Ogni risultato include l'identificatore del comportamento e p_present, p_absent e p_not_observable. Le tre probabilità sommano a circa 1. Presente stima che il comportamento si sia verificato; assente stima che non si sia verificato; non osservabile stima che il segmento fornito non contenga le prove necessarie per decidere. Sono significati distinti e devono restare separati quando si interpretano i risultati.
Ad esempio, un segmento che termina con l'assistente che dice che risolverà un problema può mostrare una promessa. Non può ancora mostrare che il cliente abbia accettato la soluzione finale se non è presente alcuna risposta del cliente. Tratta quel risultato privo di prove come sconosciuto invece di convertirlo in assente. Una bassa probabilità di presenza non costituisce automaticamente una prova forte di assenza quando una quota significativa della distribuzione è non osservabile.
Valutazione in un solo passaggio su tutte le definizioni di comportamento
Respan descrive Span-01 come un classificatore con ragionamento addestrato prima per la classificazione generale con RLAIF e poi specializzato nel rilevamento dei comportamenti. Ogni definizione viene eseguita come ramo parallelo sulla stessa traccia, e il modello restituisce le probabilità dei comportamenti in un unico passaggio in avanti. L'attenzione ibrida supporta la gestione di tracce lunghe e complesse. Non genera token, non scrive un giudizio narrativo né produce una spiegazione in forma libera della propria classificazione.
La guida concettuale e il riferimento di valutazione non documentano alcun limite al numero di comportamenti per richiesta. Ogni definizione resta comunque parte della valutazione fornita, quindi mantienile chiare e pertinenti invece di considerare l'assenza di un limite numerico come prova di una capacità di input illimitata. Il risultato contiene una voce per comportamento nell'ordine della richiesta, identificata dal suo id. Più definizioni descrivono più osservazioni indipendenti; non sono scelte di categoria mutuamente esclusive la cui somma tra i comportamenti debba essere uno.
Preparare un artefatto di valutazione utile
Combina le probabilità restituite con soglie e regole di revisione specifiche dell'attività, al di fuori del modello. Il produttore consiglia di usare conversazioni etichettate per scegliere queste soglie e di esaminare i casi di presenza al limite o con valori elevati di non osservabile. Un flusso di assistenza può registrare separatamente frustrazione, una proposta di inoltro a un livello superiore e una promessa non supportata. Un flusso di controllo della qualità degli agenti può monitorare azioni ripetute o verificare se una risposta ha usato le prove messe a sua disposizione.
Conserva insieme il segmento di testo, la definizione del comportamento, l'identificatore del risultato e l'intera distribuzione a tre vie. Quando la definizione cambia, tieni presente che cambia anche ciò che la probabilità misura. Esamina gli errori apparenti rispetto alla conversazione effettiva invece di trattare un risultato numerico come prova di un evento non osservato. Un artefatto utile è un record del comportamento legato alla traccia e al criterio, con l'incertezza conservata per un'ispezione successiva o per la decisione successiva di un'applicazione.
Ailoot Ultra · System One POST /v1/systemone respan/span-01
respan/span-01Introduzione
Span-01 è il classificatore di comportamenti testuali di Respan per conversazioni e tracce di agenti. Definisci i comportamenti in linguaggio semplice e il modello restituisce tre probabilità per ciascuno: presente, assente e non osservabile, preservando l'incertezza quando la traccia fornita non permette di risolvere la questione.
- 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 | 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.00004 / 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.00004 / 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",
"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
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
Alias dei percorsi dei metodi
Usa i percorsi dei metodi indicati sopra.
ID di chiamata correlati
FAQ · Respan: Span-01
- Quali input e risultati sono disponibili?
POST /v1/systemone·respan/span-01:text→decisions- Quali campi usa la richiesta?
POST /v1/systemone·respan/span-01:model,provider,questions,session_id,state,trace,user