Pular para o conteúdo
Respostas tipadas com probabilidades: uma chamada com duas perguntas, uma probabilidade de sim ou não e uma escolha com sua confiança.

Respostas tipadas com probabilidades de uma única API de modelo

, 3 min de leitura, By Jaber Jaber

Engenharia

A API do RightNow decision model aceita texto, estado JSON (estado de robô), imagens, voz, PDF e vídeo (prévia), e devolve respostas tipadas com probabilidades.

O RightNow decision model toma decisões estruturadas: envie um estado e perguntas nomeadas, e depois leia probabilidades, confiança e respostas tipadas. Cada resposta volta sob o nome da sua pergunta: uma probabilidade de sim ou não entre 0 e 1, ou a opção escolhida com sua confiança e a probabilidade de cada opção.

O que é um modelo de decisão?

Uma decisão pareia o seu estado com perguntas nomeadas e devolve cada resultado sob seu nome. O estado é texto, um objeto JSON ou um array JSON.

Um estado JSON pode descrever o estado de um robô, por exemplo {"battery_percent":80,"moving":false}. Envie código como texto em state.

Cada pergunta tem um nome, um type e instructions. Veja Decisões, ou leia Apresentando o RightNow decision model.

O que se pode enviar?

Entrada embutida: texto, estado JSON (estado de robô), imagens, voz, PDF, vídeo (prévia). Apenas os formatos listados são aceitos.

Um arquivo é enviado como um item dentro de state. Envie uma imagem como data URL de PNG ou JPEG, um PDF como data URL com seu nome, um vídeo como data URL de MP4, e áudio como dados WAV em base64 com seu formato. Veja Entradas.

O que volta?

answers traz uma resposta por pergunta, sob o nome da pergunta. Uma resposta noul é uma probabilidade de sim ou não, entre 0 e 1. Uma resposta choice é a opção escolhida, com sua confidence entre 0 e 1 e a probabilidade de cada opção em probabilities. usage.cost é o custo da chamada.

Uma chamada com duas perguntas tipadas. O estado diz que o pedido 1234 pede reembolso 45 dias após a entrega, e a política permite 30 dias. A pergunta de sim ou não refund_allowed volta como uma probabilidade entre 0 e 1. A pergunta de escolha next_step volta como approve, deny ou escalate, com sua confiança e uma probabilidade para cada opção.
A forma da resposta. Cada tipo representa um valor. Chame com sua chave

Como se chama?

Uma chave da página de chaves de API chama o RightNow decision model na mesma URL base que qualquer modelo aberto. Com uma chave da página de chaves de API, chame POST /v1/decisions. Envie rightnow-decision como model. Use o alias para seguir o modelo vigente, ou um ID fixado para escolher uma versão.

Shell
curl https://api.rightnowai.co/v1/decisions \
  -H "Authorization: Bearer $RIGHTNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "rightnow-decision",
    "state": "Order 1234: the customer asks for a refund 45 days after delivery. The policy allows 30 days.",
    "questions": {
      "refund_allowed": {"type": "noul", "instructions": "Is the refund allowed under the policy?"},
      "next_step": {"type": "choice", "instructions": "What should support do next?",
        "options": ["approve", "deny", "escalate"]}
    }
  }'
A call with your key. Call it with your key

Defina RIGHTNOW_API_KEY no processo que faz a chamada. Mantenha a chave no seu servidor e chame por HTTPS. Veja Guia rápido.

Quanto custa?

Com o RightNow decision model você paga pela entrada, perguntas respondidas e uma chamada respondida.

Uncached text input costs USD 0.19 per million input tokens, and cached text input USD 0.019. Each answered question costs USD 0.0001, and each answered call USD 0.00001. Output is free.

Uma chamada com um arquivo custa o preço do texto e a taxa de cada arquivo da tabela de preços. Perguntas recusadas não são cobradas. Veja Preços.

Onde estão os limites?

O estado de texto padrão aceita até 38,000 tokens. Com uma chave da página de chaves de API, o áudio é apenas WAV e uma chamada comporta no máximo 32 perguntas.

O áudio é limitado a 60 segundos por solicitação. Envie até 4 imagens por solicitação. Um PDF pode ter até 500 páginas. Envie um MP4 H.264 silencioso de até 10 segundos, sem outros arquivos.

calibrated é false nesta versão.

Uma chave da página de chaves de API tem seu próprio limite por minuto: leia X-RateLimit-Limit nas respostas. Veja Entradas e Limites.

Respostas rápidas

Qual tipo de pergunta devo usar?

noul é uma probabilidade de sim ou não. Numa chamada de texto, choice aceita de 2 a 10 options e score aceita de 2 a 4 levels.

Posso enviar arquivos?

Sim. Envie os arquivos embutidos. Apenas os formatos listados estão disponíveis.

Qual ID de modelo envio?

Envie rightnow-decision. Para fixar uma versão, use rightnow-decision-3.0.0.

Como consigo uma chave?

Crie uma chave nomeada em Chaves de API, num workspace ativo. Uma chave pertence ao seu workspace e é mostrada uma única vez.

Perguntas recusadas são cobradas?

Não. Uma solicitação toda recusada não tem cobrança de texto, pergunta, arquivo nem chamada.