Source: https://ailoot.ai/models/pt-pt/respan-span-01-lite/ Canonical: https://ailoot.ai/models/pt-pt/respan-span-01-lite/ Language: pt-pt # Respan: Span-01 Lite [Markdown](https://ailoot.ai/models/pt-pt/respan-span-01-lite/index.md) · [JSON](https://ailoot.ai/models/pt-pt/respan-span-01-lite/facts.json) ## [Respan: Span-01 Lite](https://ailoot.ai/models/pt-pt/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. - [**Ailoot Ultra · System One** `POST /v1/systemone` `respan/span-01-lite`](https://ailoot.ai/models/pt-pt/respan-span-01-lite/#method-0) 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`](https://ailoot.ai/models/pt-pt/#m=respan%2Fspan-01-lite&route=Ultra&caller=respan%2Fspan-01-lite&fmt=systemone) 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 | Campo | Tipo | Requisito | Valores e limites | Predefinição | | --- | --- | --- | --- | --- | | Campo`model` | Tipo`string` | RequisitoObrigatório | Valores e limites respan/span-01-lite | Predefinição— | | Campo`provider` | Tipo`schema` | RequisitoOpcional | Valores e limites | Predefinição— | | Campo`questions` | Tipo`object` | RequisitoObrigatório | Valores e limites | Predefinição— | | Campo`session_id` | Tipo`string` | RequisitoOpcional | Valores e limites | Predefinição— | | Campo`state` | Tipo`schema` | RequisitoObrigatório | Valores e limites | Predefinição— | | Campo`trace` | Tipo`schema` | RequisitoOpcional | Valores e limites | Predefinição— | | Campo`user` | Tipo`string` | RequisitoOpcional | Valores e limites | Predefinição— | | Campo`questions..type` | Tipo`string` | RequisitoObrigatório | Valores e limites noul, choice, score | Predefinição— | | Campo`questions..instructions` | Tipo`string\|object\|array` | RequisitoObrigatório | Valores e limites | Predefinição— | | Campo`questions..criteria` | Tipo`object\|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— | | Campo`questions..criteria.true` | Tipo`string\|object\|array` | RequisitoObrigatório | Valores e limites Aplica-se quando: Objeto de critérios noul fornecido | Predefinição— | | Campo`questions..criteria.false` | Tipo`string\|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.\.type=noul, questions.\.instructions **choice** · Obrigatório: state, questions.\.type=choice, questions.\.instructions, criteria object **score** · Obrigatório: state, questions.\.type=score, questions.\.instructions, criteria array with minItems1 Parâmetros e ciclo de vida do método | Parâmetro | Contrato | | --- | --- | | Parâmetro`content_type` | Contratoapplication/json | | Parâmetro`required` | Contratomodel, state, questions | | Parâmetro`material_types` | Contratotext | | Parâmetro`optional_controls` | Contratoprovider, session\_id, trace, user | | Parâmetro`multimodal_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 →](https://ailoot.ai/docs/pt-pt/billing/reserve/) ### 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 ```json { "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." } } ``` ```bash 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 | | --- | --- | | Campo`model` | Tipostring | | Campo`id` | Tipostring | | Campo`provider` | Tipostring | | Campo`answers..type` | Tipostring | | Campo`answers..noul` | Tiponumber | | Campo`answers..choice` | Tipostring | | Campo`answers..score` | Tiponumber | | Campo`answers..confidence` | Tiponumber | | Campo`answers..probabilities` | Tipoobject | | Campo`answers..legend` | Tipoobject | | Campo`usage.input_tokens` | Tipointeger | | Campo`usage.output_tokens` | Tipointeger | | Campo`usage.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`](https://ailoot.ai/models/pt-pt/#m=respan%2Fspan-01-lite&route=Ultra&caller=respan%2Fspan-01-lite&fmt=systemone) #### Aliases dos caminhos dos métodos Use os caminhos dos métodos indicados acima. #### IDs de chamada relacionados [`respan/span-01-lite`](https://ailoot.ai/models/pt-pt/#m=respan%2Fspan-01-lite&route=Ultra&caller=respan%2Fspan-01-lite&fmt=systemone) 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` 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](https://ailoot.ai/docs/pt-pt/billing/subscriptions/) · [Ver preços dos modelos](https://ailoot.ai/models/pt-pt/) ## 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](mailto:support@ailoot.ai) · [Oferta e contrato de licença](https://ailoot.ai/legal/offer?lang=pt-pt) ## Ailoot · A empresa e a sua carteira de projetos A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI. A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões. A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.