Respan: Span-01 Lite
O Span-01 Lite é o perfil de pontuação de comportamentos da Respan, com nome próprio, para conversas de texto e rastos de execução de agentes. Utiliza comportamentos definidos por quem faz a chamada e devolve, para cada um, probabilidades de presente, ausente e não observável, com o mesmo fluxo de pontuação documentado do Span-01.
Sobre o modelo
Esta descrição apresenta as capacidades do modelo. As entradas, saídas e opções disponíveis no Ailoot para o método selecionado estão indicadas abaixo.
O Span-01 Lite é um perfil de modelo com nome próprio na família de pontuação de comportamentos Span-01 da Respan. O guia de início rápido e a tabela de modelos do produtor identificam o Lite como um dos dois perfis que utilizam o mesmo fluxo de pontuação. Recebe uma interação de texto e definições de comportamentos em linguagem simples e, em seguida, devolve três probabilidades para cada definição: presente, ausente e não observável. A saída útil do perfil é um registo de comportamento com incerteza explícita, e não uma resposta escrita à conversa.
Escolha a observação e os seus limites
Defina o comportamento com as palavras que correspondem à sua tarefa. Numa verificação de transferência para um humano, especifique se isso significa que o utilizador pede explicitamente uma pessoa, que o assistente diz que é necessária uma transferência, ou qualquer uma das duas condições. Se a simples desilusão não deve contar, diga-o. Numa verificação de pedido de desculpa, defina que formulação constitui um pedido de desculpa, em vez de depender de uma etiqueta pouco clara. Cada definição tem um identificador que o avaliador devolve com as respetivas probabilidades.
O conjunto de comportamentos pertence a quem faz a chamada. Exemplos como frustração, promessas sem fundamento, utilização indevida de ferramentas ou ações repetitivas do agente são definições a fornecer, e não uma lista fixa de categorias nativas. Mantenha cada definição observável na interação fornecida. Um segmento curto pode determinar se o assistente pediu desculpa sem conter evidência de que um problema externo foi efetivamente resolvido.
Prepare o segmento de conversa
A entrada documentada da Respan coloca as mensagens anteriores em span.input e o turno a avaliar em span.output. O conteúdo de cada mensagem é uma cadeia de caracteres. Preserve o contexto necessário para compreender o turno, incluindo os papéis dos interlocutores, o pedido relevante do utilizador e qualquer evidência textual que o assistente tenha utilizado. Numa verificação de qualidade, forneça o turno real e não uma paráfrase que elimine o comportamento em avaliação.
Uma revisão ilustrativa pode partir de uma mensagem do utilizador que descreve problemas repetidos e de uma resposta do assistente que se oferece para investigar. Defina a frustração do utilizador e uma promessa do assistente como observações separadas. Se o resultado de uma ferramenta for importante para avaliar se uma afirmação tinha fundamento, mantenha o texto relevante desse resultado no contexto. A saída é uma avaliação dessas definições no segmento fornecido; o modelo não realiza a investigação prometida nem altera a própria conversa.
Presente, ausente e não observável
A resposta de pontuação contém o id do comportamento com p_present, p_absent e p_not_observable, cuja soma é aproximadamente 1. Não observável significa que o rasto não consegue responder à pergunta. É diferente de ausente. Para uma definição como a aceitação de uma solução pelo cliente, um segmento que termina antes de o cliente reagir é evidência incompleta, mesmo que a resposta do assistente pareça confiante.
Mantenha os três valores ao preparar um resultado para revisão. Uma categoria escolhida pelo valor mais alto pode ser útil para apresentação, mas a distribuição conserva o grau de incerteza da observação. Não utilize apenas um valor de presença baixo para concluir que o comportamento definitivamente não ocorreu. Quando predomina a falta de evidência, a ação útil pode ser obter o contexto relevante ou manter o resultado como desconhecido, em vez de inventar uma explicação.
Várias definições sobre a mesma evidência
O fluxo de pontuação do produtor avalia várias definições de comportamento em conjunto sobre um único rasto e devolve um resultado para cada identificador, pela ordem do pedido. A documentação não especifica um limite para o número de comportamentos por pedido. Isto não estabelece uma janela de tokens universal nem um tamanho de rasto ilimitado. Mantenha as definições com um propósito claro e a evidência relevante, e conserve a associação entre cada resultado devolvido e a definição que o produziu.
Os resultados dos comportamentos são observações independentes, e não uma resposta única de escolha exclusiva. Frustração, um pedido de desculpa e uma proposta de transferência podem estar todos presentes na mesma troca. As respetivas distribuições de três valores têm significado dentro de cada definição; somar valores de presença de comportamentos diferentes não cria uma distribuição normalizada de categorias nem uma pontuação ordenada numa rubrica.
Mantenha o perfil selecionado junto dos resultados
O fabricante documenta a edição Lite e a edição padrão com um formato de pedido e de resultado comum. Esse contrato permite preparar rastos e interpretar probabilidades de comportamento para qualquer um dos dois perfis nomeados. Não estabelece que o Lite tenha os mesmos pesos, o mesmo número de parâmetros ou a mesma qualidade que a outra edição. Mantenha o perfil selecionado identificável ao rever os seus resultados, em vez de trocar silenciosamente resultados de edições diferentes.
Utilize conversas etiquetadas da tarefa pretendida para escolher limiares de registo, encaminhamento ou revisão. Conserve para inspeção os resultados com valor elevado de não observável e as observações limítrofes, e compare qualquer erro aparente com o turno original e a definição do comportamento. O artefacto final útil contém o identificador do segmento de texto, a definição, o perfil selecionado e o resultado completo de probabilidades de três valores. Um passo posterior da aplicação decide o que fazer com essa observação; a saída de pontuação do Lite não executa, por si só, uma transferência, não bloqueia uma resposta nem gera uma correção.
Ailoot Ultra · System One POST /v1/systemone respan/span-01-lite
respan/span-01-liteIntrodução
O Span-01 Lite é o perfil de pontuação de comportamentos da Respan, com nome próprio, para conversas de texto e rastos de execução de agentes. Utiliza comportamentos definidos por quem faz a chamada e devolve, para cada um, probabilidades de presente, ausente e não observável, com o mesmo fluxo de pontuação documentado do Span-01.
- Entradas aceites
- Texto
- Resultados
- decisions
Disponível no Ailoot · entradas e métodos
Ailoot Ultra · System One POST /v1/systemone
- Entrada
text- Saída
decisions- Formato de saída
- json
| Campo | Tipo | Requisito | Valores e limites | Predefinição |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites respan/span-01-lite | Predefinição— |
Campoprovider | Tiposchema | RequisitoOpcional | Valores e limites | Predefinição— |
Campoquestions | Tipoobject | RequisitoObrigatório | Valores e limites | Predefinição— |
Camposession_id | Tipostring | RequisitoOpcional | Valores e limites | Predefinição— |
Campostate | Tiposchema | RequisitoObrigatório | Valores e limites | Predefinição— |
Campotrace | Tiposchema | RequisitoOpcional | Valores e limites | Predefinição— |
Campouser | Tipostring | RequisitoOpcional | Valores e limites | Predefinição— |
Campoquestions.<id>.type | Tipostring | RequisitoObrigatório | Valores e limites noul, choice, score | Predefinição— |
Campoquestions.<id>.instructions | Tipostring|object|array | RequisitoObrigatório | Valores e limites | Predefinição— |
Campoquestions.<id>.criteria | Tipoobject|array | RequisitoOpcional | Valores e limites Condições: choice/score: obrigatório; noul: opcional. Os critérios de choice são um objeto; score é uma matriz com minItems1. | Predefinição— |
Campoquestions.<id>.criteria.true | Tipostring|object|array | RequisitoObrigatório | Valores e limites Aplica-se quando: Objeto de critérios noul fornecido | Predefinição— |
Campoquestions.<id>.criteria.false | Tipostring|object|array | RequisitoObrigatório | Valores e limites Aplica-se quando: Objeto de critérios noul fornecido | Predefinição— |
Combinações de materiais de entrada
noul · Obrigatório: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Obrigatório: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Obrigatório: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Parâmetros e ciclo de vida do método
| Parâmetro | Contrato |
|---|---|
Parâmetrocontent_type | Contratoapplication/json |
Parâmetrorequired | Contratomodel, state, questions |
Parâmetromaterial_types | Contratotext |
Parâmetrooptional_controls | Contratoprovider, session_id, trace, user |
Parâmetromultimodal_input_binding | Contratonull |
Ciclo de vida: synchronous
Envie o ID exato do modelo e conserve a resposta nativa completa.
Tarifários
As referências tarifárias não acrescentam opções ao pedido. Os parâmetros suportados constam do método selecionado.
- Modo rápido
- Não especificado Quando o modo rápido está selecionado
- Modo flex
- Não especificado Quando o modo flex está selecionado
- Esforço máximo de raciocínio
- Não especificado Quando o esforço máximo de raciocínio usa o ajuste predefinido (default)
Tarifas Ailoot
Preços por configuração
Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas.
| Configuração | Tabela de tarifas | Tokens de contexto, mais de | Tokens de contexto, até ao limite inclusive | Custo |
|---|---|---|---|---|
| ConfiguraçãoTarifas base dos tokens | Tabela de tarifasTarifa base | Tokens de contexto, mais de— | Tokens de contexto, até ao limite inclusiveSem limite superior | Custo Entrada · Tokens de entrada $0 / 1K tokens Saída · Tokens de saída $0 / 1K tokens Entrada · Leitura da cache — / 1K tokens Entrada · Escrita na cache — / 1K tokens Entrada · Escrita na cache, 1 hora — / 1K tokens |
| ConfiguraçãoEscalão 1 por comprimento do pedido | Tabela de tarifas— | Tokens de contexto, mais de0 | Tokens de contexto, até ao limite inclusiveSem limite superior | Custo Entrada · Tokens de entrada $0 / 1K tokens Saída · Tokens de saída $0 / 1K tokens Entrada · Leitura da cache — / 1K tokens Entrada · Escrita na cache — / 1K tokens Entrada · Escrita na cache, 1 hora — / 1K tokens |
O Ailoot reserva um montante estimado antes de um pedido. Após o resultado, liquida o custo final com base na utilização medida. No streaming, a liquidação usa o registo final de utilização. Como funcionam a reserva e a liquidação →
Exemplos de pedidos
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
Receber e guardar os resultados
Ailoot Ultra · System One
json
Guardar todos os resultados concluídos
Guarde cada resposta, ficheiro e parte de conteúdo devolvidos na íntegra.
É conservada cada resposta fornecida a um ID de pergunta, com o respetivo tipo exato, valor noul/choice/score, confiança, probabilidades e legenda. O JSON original completo é armazenado e devolvido apenas após a liquidação.
Se for necessário verificar a resposta original
Conserve a operação original e a resposta completa/parcial; não repita o POST.
Campos da resposta
| 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 |
Erros e passos seguintes
| Resposta | Condição | Passo seguinte |
|---|---|---|
Resposta400 · invalid_request_error | CondiçãoCampo obrigatório, representação ou valor inválido | Passo seguinteCorrija o campo indicado no pedido. |
Aliases
Aliases do modelo
Ailoot Ultra respan/span-01-lite
Aliases dos caminhos dos métodos
Use os caminhos dos métodos indicados acima.
IDs de chamada relacionados
FAQ · Respan: Span-01 Lite
- Que entradas e resultados estão disponíveis?
POST /v1/systemone·respan/span-01-lite:text→decisions- Que campos utiliza o pedido?
POST /v1/systemone·respan/span-01-lite:model,provider,questions,session_id,state,trace,user