Decisões

POST /v1/systemone avalia um state em relação a perguntas nomeadas e retorna uma resposta tipada por pergunta. A resposta é um JSON síncrono: uma probabilidade, um nome de opção ou uma pontuação que seu código pode comparar e usar para ramificação. Ele não retorna texto gerado.

Decisões ou chatCopy Anchor Link

O endpoint de decisão não aceita messages, tools, stream ou outros controles de chat, e não está disponível em Batch. Mantenha seu modelo de chat principal configurado separadamente.

Escolha um modeloCopy Anchor Link

curl "https://api.tokenlab.sh/v1/models?recommended_for=decision" \
  -H "Authorization: Bearer sk-your-api-key"

Você também pode filtrar com category=decision. Leia GET /v1/models/{model} para o modelo selecionado antes de enviar solicitações e envie o ID do modelo explicitamente. Os exemplos nesta página usam jev-1.13.

Formato da solicitaçãoCopy Anchor Link

instructions e cada critério também aceitam uma string, objeto JSON ou array JSON. A solicitação rejeita campos desconhecidos.

Avalie um ticketCopy Anchor Link

curl https://api.tokenlab.sh/v1/systemone \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev-1.13",
    "state": "I was charged twice. Please refund the duplicate payment.",
    "questions": {
      "refund_requested": {"type": "noul", "instructions": "Is a refund requested?"},
      "department": {
        "type": "choice", "instructions": "Which team should handle this?",
        "criteria": {"refunds": "Charges and refunds", "technical": "Software bugs"}
      },
      "urgency": {
        "type": "score", "instructions": "Rate urgency",
        "criteria": ["Routine enquiry", "Money affected", "Safety emergency"]
      }
    }
  }'

A resposta mantém os nomes das suas perguntas em answers. Os valores abaixo são ilustrativos:

{
  "model": "jev-1.13",
  "answers": {
    "refund_requested": {"type": "noul", "noul": 0.97},
    "department": {"type": "choice", "choice": "refunds"},
    "urgency": {"type": "score", "score": 1}
  },
  "usage": {"input_tokens": 96, "output_tokens": 12}
}

Use as respostasCopy Anchor Link

• Cada pergunta recebe uma resposta do mesmo type, sob o mesmo nome.
• Uma resposta noul é uma probabilidade, não um booleano. Escolha seu próprio limite para cada ação.
• Uma resposta choice é sempre um dos nomes das opções que você enviou.
• Uma resposta score indexa seu array criteria: 1 acima significa "Money affected".
• Teste as decisões contra seus próprios casos rotulados antes que elas acionem reembolsos, escalonamentos ou outras ações.

Use a partir do MCPCopy Anchor Link

O servidor MCP do TokenLab expõe evaluate_decisions nos perfis core e full. Chame list_models com {"category":"decision"} e get_model primeiro, depois passe o mesmo model, state e questions como argumentos da ferramenta. Leia structuredContent.answers e structuredContent.usage do resultado. A ferramenta retorna um resultado síncrono e não usa polling de tarefas assíncronas.

Use a partir dos SDKsCopy Anchor Link

O SDK JavaScript do TokenLab 0.1.2+ fornece evaluateDecisions(body); o SDK Python 0.1.2+ fornece evaluate_decisions(body). O corpo é o mesmo JSON da solicitação HTTP. Ambos preservam as respostas tipadas e o uso e não repetem automaticamente uma solicitação falha. Veja SDKs.

Custo e novas tentativasCopy Anchor Link

• As decisões são cobradas por tokens, a partir de usage.input_tokens e usage.output_tokens na resposta, aos preços atuais de token do modelo.
• Os preços podem mudar. Leia os detalhes de preços do modelo ou a API de Preços em vez de codificar um preço fixo.
• Um modelo pode relatar tokens de saída mesmo quando seu preço de saída é zero.
• As solicitações seguem sua opção de entrega. Veja Faturamento e preços.
• Um timeout deixa o resultado incerto. Verifique a solicitação em seus logs ou no Console antes de enviar uma solicitação paga novamente.

Erros comunsCopy Anchor Link

Referência da APICopy Anchor Link