Source: https://ailoot.ai/models/pt-pt/respan-span-01/ Canonical: https://ailoot.ai/models/pt-pt/respan-span-01/ Language: pt-pt # Respan: Span-01 [Markdown](https://ailoot.ai/models/pt-pt/respan-span-01/index.md) · [JSON](https://ailoot.ai/models/pt-pt/respan-span-01/facts.json) ## [Respan: Span-01](https://ailoot.ai/models/pt-pt/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. - [**Ailoot Ultra · System One** `POST /v1/systemone` `respan/span-01`](https://ailoot.ai/models/pt-pt/respan-span-01/#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 é 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`](https://ailoot.ai/models/pt-pt/#m=respan%2Fspan-01&route=Ultra&caller=respan%2Fspan-01&fmt=systemone) 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 | Campo | Tipo | Requisito | Valores e limites | Predefinição | | --- | --- | --- | --- | --- | | Campo`model` | Tipo`string` | RequisitoObrigatório | Valores e limites respan/span-01 | 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.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 →](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", "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' 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`](https://ailoot.ai/models/pt-pt/#m=respan%2Fspan-01&route=Ultra&caller=respan%2Fspan-01&fmt=systemone) #### Aliases dos caminhos dos métodos Use os caminhos dos métodos indicados acima. #### IDs de chamada relacionados [`respan/span-01`](https://ailoot.ai/models/pt-pt/#m=respan%2Fspan-01&route=Ultra&caller=respan%2Fspan-01&fmt=systemone) 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` 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.