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-01Introduçã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
| Campo | Tipo | Requisito | Valores e limites | Predefinição |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites respan/span-01 | 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.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 pedido | Tabela de tarifas— | Tokens de contexto, mais de0 | Tokens de contexto, até ao limite inclusiveSem limite superior | Custo 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
{
"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
| 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
Aliases dos caminhos dos métodos
Use os caminhos dos métodos indicados acima.
IDs de chamada relacionados
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