modelli

Respan: Span-01 Lite

Markdown · JSON

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-lite

Respan /respan/span-01-lite

Introduzione

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
CampoTipoRequisitoValori e limitiPredefinito
CampomodelTipostringRequisitoObbligatorioValori e limiti
respan/span-01-lite
Predefinito—
CampoproviderTiposchemaRequisitoFacoltativoValori e limitiPredefinito—
CampoquestionsTipoobjectRequisitoObbligatorioValori e limitiPredefinito—
Camposession_idTipostringRequisitoFacoltativoValori e limitiPredefinito—
CampostateTiposchemaRequisitoObbligatorioValori e limitiPredefinito—
CampotraceTiposchemaRequisitoFacoltativoValori e limitiPredefinito—
CampouserTipostringRequisitoFacoltativoValori e limitiPredefinito—
Campoquestions.<id>.typeTipostringRequisitoObbligatorioValori e limiti
noul, choice, score
Predefinito—
Campoquestions.<id>.instructionsTipostring|object|arrayRequisitoObbligatorioValori e limitiPredefinito—
Campoquestions.<id>.criteriaTipoobject|arrayRequisitoFacoltativoValori e limiti
Condizioni: choice/score: obbligatori; noul: facoltativo. I criteri di choice sono un oggetto; score è un array con minItems1.
Predefinito—
Campoquestions.<id>.criteria.trueTipostring|object|arrayRequisitoObbligatorioValori e limiti
Si applica quando: Oggetto criteria noul fornito
Predefinito—
Campoquestions.<id>.criteria.falseTipostring|object|arrayRequisitoObbligatorioValori 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
ParametroContratto
Parametrocontent_typeContrattoapplication/json
ParametrorequiredContrattomodel, state, questions
Parametromaterial_typesContrattotext
Parametrooptional_controlsContrattoprovider, session_id, trace, user
Parametromultimodal_input_bindingContrattonull

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.

ConfigurazioneListino delle tariffeToken di contesto, più diToken di contesto, fino al limite inclusoCosto
ConfigurazioneTariffe di base dei tokenListino delle tariffeTariffa baseToken di contesto, più di—Token di contesto, fino al limite inclusoNessun limite superioreCosto
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 richiestaListino delle tariffe—Token di contesto, più di0Token di contesto, fino al limite inclusoNessun limite superioreCosto
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

Struttura ufficiale della richiesta conservata; esempio per la documentazioneUsa il materiale effettivo della tua richiesta e conserva il risultato completo
{
  "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
CampoTipo
CampomodelTipostring
CampoidTipostring
CampoproviderTipostring
Campoanswers.<id>.typeTipostring
Campoanswers.<id>.noulTiponumber
Campoanswers.<id>.choiceTipostring
Campoanswers.<id>.scoreTiponumber
Campoanswers.<id>.confidenceTiponumber
Campoanswers.<id>.probabilitiesTipoobject
Campoanswers.<id>.legendTipoobject
Campousage.input_tokensTipointeger
Campousage.output_tokensTipointeger
Campousage.costTiponumber
Errori e passaggi successivi
RispostaCondizionePassaggio successivo
Risposta400 · invalid_request_errorCondizioneCampo obbligatorio, rappresentazione o valore non validoPassaggio 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

respan/span-01-lite

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

Maggiori dettagli

Collega Ailoot a Claude Code, OpenCode, Hermes o alla tua applicazione.

L’azienda e il suo portafoglio di progetti

L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese.

Acquista token con uno sconto.

Sconto con abbonamento per lavoro regolare. Codici fino al 50% sull’acquisto di token.

Abbonamento
Scegli un piano scontato per richieste regolari.
Codice fino al 50%
Inserisci il codice all’acquisto. Il prezzo si aggiorna secondo la promozione.
Spese nella cronologia
Modello, token e importo sono salvati per ogni richiesta.

Scegli abbonamento · Consulta prezzi dei modelli

Collega l’API al prodotto che vendi.

SaaS, app e bot secondo offerta e accordo di licenza Ailoot. Per rivendere, richiedi una licenza reseller.

Applicazione commerciale
Integra generazione di testo, immagini, video e suono nelle funzioni a pagamento.
Licenza reseller
Invia descrizione del progetto e schema di accesso. Richiedi condizioni scritte per uso e rivendita.
Documenti sul sito
Offerta, accordo di licenza e politica sui dati sono disponibili prima della connessione.

Richiedi licenza reseller · Offerta e accordo di licenza