modelos

Respan: Span-01

Markdown · JSON

Respan: Span-01

O Span-01 é o classificador de comportamentos em texto da Respan para conversas e rastos de execução de agentes. Defina os comportamentos em linguagem simples e o modelo devolve três probabilidades para cada um: presente, ausente e não observável, preservando a incerteza quando o rasto fornecido não permite resolver a questão.

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 é o modelo de pontuação de comportamentos da Respan para conversas e rastos de execução de agentes. Lê uma interação de texto juntamente com definições de comportamentos escritas em linguagem simples e devolve probabilidades para cada definição. A saída distingue um comportamento presente, ausente ou não observável no rasto fornecido. Isto dá a um fluxo de avaliação um sinal numérico com uma forma explícita de representar a falta de evidência, em vez de uma explicação gerada que é preciso analisar.

Defina o comportamento que pretende observar

Os comportamentos são fornecidos por quem faz a chamada. Injeção de instruções, afirmações sem fundamento, exposição de segredos, ciclos repetitivos, utilização indevida de ferramentas e frustração do utilizador são definições possíveis, e não uma taxonomia fixa incorporada no modelo. Indique o que conta como o comportamento e o que não conta. Uma definição restrita pode distinguir um utilizador que pede a transferência para um humano de um que apenas manifesta desilusão. Outra pode distinguir um assistente que reconhece um problema de um que promete uma ação que não consegue realizar.

Utilize identificadores estáveis com as definições, para que os resultados se mantenham associados ao comportamento avaliado. Mantenha o critério centrado em algo que o rasto possa mostrar. Se o comportamento exigir um documento de origem, o resultado de uma ferramenta ou uma resposta posterior do cliente, inclua essa evidência na interação de texto, no local a que pertence. Uma definição, por si só, não consegue estabelecer um facto ausente do rasto.

Prepare o contexto anterior e o turno-alvo

A entrada documentada separa as mensagens anteriores, em span.input, do turno-alvo, em span.output. O conteúdo de cada mensagem é uma cadeia de caracteres. Forneça o contexto real da conversa e o turno que pretende pontuar, preservando os papéis dos interlocutores e a ordem necessária para o interpretar. Este é um perfil de pontuação de texto; o texto preparado de um documento ou uma transcrição podem servir de evidência, mas os ficheiros multimédia de onde esse texto foi obtido não são, em si, a entrada documentada.

Numa interação de suporte, mantenha o pedido do cliente junto da resposta proposta pelo assistente. Num agente que utiliza ferramentas, conserve a observação relevante da ferramenta e a resposta que nela se baseou. Uma definição ilustrativa de fundamentação pode perguntar se o assistente afirma uma conclusão que a observação fornecida não sustenta. O resultado útil diz respeito ao comportamento definido nesse segmento, e não a um diagnóstico completo de toda a aplicação.

Leia três probabilidades para cada definição

Cada resultado inclui o identificador do comportamento e p_present, p_absent e p_not_observable. A soma das três probabilidades é aproximadamente 1. Presente estima que o comportamento ocorreu; ausente estima que não ocorreu; não observável estima que o segmento fornecido não contém a evidência necessária para decidir. São significados distintos e devem manter-se separados quando os resultados são interpretados.

Por exemplo, um segmento que termina com um assistente a dizer que vai resolver um problema pode mostrar uma promessa. Ainda não pode mostrar que o cliente aceitou a solução final se não existir nenhuma resposta do cliente. Trate esse resultado com falta de evidência como desconhecido, em vez de o converter em ausente. Uma probabilidade baixa de presença não é automaticamente uma evidência forte de ausência quando uma parte significativa da distribuição é não observável.

Pontuação numa única passagem para todas as definições de comportamento

A Respan descreve o Span-01 como um classificador de raciocínio treinado primeiro para classificação geral com RLAIF e depois especializado na deteção de comportamentos. Cada definição é executada como um ramo paralelo sobre o mesmo rasto, e o modelo devolve as probabilidades dos comportamentos numa única passagem direta. A atenção híbrida suporta o tratamento de rastos longos e complexos. O modelo não gera tokens, não escreve um juízo narrativo nem produz uma explicação livre da sua classificação.

O guia de conceitos e a referência de pontuação não documentam nenhum limite para o número de comportamentos por pedido. Cada definição continua a fazer parte da avaliação fornecida, por isso mantenha cada uma clara e relevante, em vez de tratar a ausência de limite de contagem como prova de uma capacidade de entrada ilimitada. O resultado contém uma entrada por comportamento, pela ordem do pedido, identificada pelo respetivo id. Várias definições descrevem várias observações independentes; não são escolhas de categoria mutuamente exclusivas cuja soma, entre comportamentos, tenha de ser um.

Preparar um artefacto de avaliação útil

Combine as probabilidades devolvidas com limiares específicos da tarefa e regras de revisão fora do modelo. O produtor recomenda utilizar conversas etiquetadas para escolher esses limiares e inspecionar os resultados de presença limítrofe ou com valor elevado de não observável. Um fluxo de suporte pode registar separadamente a frustração, uma proposta de escalamento e uma promessa sem fundamento. Um fluxo de qualidade de agentes pode acompanhar ações repetidas ou verificar se uma resposta utilizou a evidência que lhe foi disponibilizada.

Mantenha juntos o segmento de texto, a definição do comportamento, o identificador do resultado e a distribuição completa de três valores. Quando a definição muda, tenha em conta que muda aquilo que a probabilidade mede. Reveja os erros aparentes face à conversa real, em vez de tratar um resultado numérico como prova de um acontecimento não observado. Um artefacto útil é um registo de comportamento ligado ao rasto e ao critério, com a incerteza conservada para inspeção posterior ou para a decisão seguinte de uma aplicação.

Ailoot Ultra · System One POST /v1/systemone respan/span-01

respan/span-01

Respan /respan/span-01

Introdução

O Span-01 é o classificador de comportamentos em texto da Respan para conversas e rastos de execução de agentes. Defina os comportamentos em linguagem simples e o modelo devolve três probabilidades para cada um: presente, ausente e não observável, preservando a incerteza quando o rasto fornecido não permite resolver a questão.

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
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.00004 / 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.00004 / 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",
  "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

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

Aliases dos caminhos dos métodos

Use os caminhos dos métodos indicados acima.

IDs de chamada relacionados

respan/span-01

FAQ · Respan: Span-01
Que entradas e resultados estão disponíveis?

POST /v1/systemone · respan/span-01: text → decisions

Que campos utiliza o pedido?

POST /v1/systemone · respan/span-01: 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