modelos

Respan: Span-01 Lite

Markdown · JSON

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

Respan /respan/span-01-lite

Introduçã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
CampoTipoRequisitoValores e limitesPredefinição
CampomodelTipostringRequisitoObrigatórioValores e limites
respan/span-01-lite
Predefinição—
CampoproviderTiposchemaRequisitoOpcionalValores e limitesPredefinição—
CampoquestionsTipoobjectRequisitoObrigatórioValores e limitesPredefinição—
Camposession_idTipostringRequisitoOpcionalValores e limitesPredefinição—
CampostateTiposchemaRequisitoObrigatórioValores e limitesPredefinição—
CampotraceTiposchemaRequisitoOpcionalValores e limitesPredefinição—
CampouserTipostringRequisitoOpcionalValores e limitesPredefinição—
Campoquestions.<id>.typeTipostringRequisitoObrigatórioValores e limites
noul, choice, score
Predefinição—
Campoquestions.<id>.instructionsTipostring|object|arrayRequisitoObrigatórioValores e limitesPredefinição—
Campoquestions.<id>.criteriaTipoobject|arrayRequisitoOpcionalValores 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.trueTipostring|object|arrayRequisitoObrigatórioValores e limites
Aplica-se quando: Objeto de critérios noul fornecido
Predefinição—
Campoquestions.<id>.criteria.falseTipostring|object|arrayRequisitoObrigatórioValores 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âmetroContrato
Parâmetrocontent_typeContratoapplication/json
ParâmetrorequiredContratomodel, state, questions
Parâmetromaterial_typesContratotext
Parâmetrooptional_controlsContratoprovider, session_id, trace, user
Parâmetromultimodal_input_bindingContratonull

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çãoTabela de tarifasTokens de contexto, mais deTokens de contexto, até ao limite inclusiveCusto
ConfiguraçãoTarifas base dos tokensTabela de tarifasTarifa baseTokens de contexto, mais de—Tokens de contexto, até ao limite inclusiveSem limite superiorCusto
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 pedidoTabela de tarifas—Tokens de contexto, mais de0Tokens de contexto, até ao limite inclusiveSem limite superiorCusto
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

Estrutura oficial do pedido preservada; exemplo de documentaçãoUse o material real do seu pedido e guarde o resultado 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

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
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
Erros e passos seguintes
RespostaCondiçãoPasso seguinte
Resposta400 · invalid_request_errorCondiçãoCampo obrigatório, representação ou valor inválidoPasso 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

respan/span-01-lite

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

Mais detalhes

Ligue o Ailoot ao Claude Code, OpenCode, Hermes ou à sua aplicação.

A empresa e a sua carteira de projetos

A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões.

Compre tokens com desconto.

Desconto por subscrição para trabalho regular. Códigos promocionais — até 50% na compra de tokens.

Subscrição
Escolha um plano com desconto para os pedidos regulares.
Código promocional até 50%
Introduza o código na compra. O preço é recalculado conforme a campanha em vigor.
Custos no histórico
O modelo, os tokens e o montante são guardados para cada pedido.

Escolher subscrição · Ver preços dos modelos

Ligue a API ao produto que vende.

SaaS, aplicações e bots — ao abrigo da oferta e do contrato de licença Ailoot. Para revenda, peça uma licença de revendedor.

Aplicação comercial
Integre geração de texto, imagens, vídeo e som nas funcionalidades pagas do seu serviço.
Licença de revendedor
Envie uma descrição do projeto e do modelo de acesso. Peça condições escritas de utilização e revenda.
Documentos no site
A oferta, o contrato de licença e a política de tratamento de dados estão disponíveis antes da ligação.

Pedir licença de revendedor · Oferta e contrato de licença