Decisions API: Crie apps mais responsivos e eficientes

Decisions API: como usar o endpoint de decisões em apps

A Decisions API é um endpoint dedicado a tarefas como classificação e pontuação. Em vez de gerar texto livre, retorna respostas tipadas que sua aplicação pode consumir. A documentação da OpenAI sobre a Decisions API mostra avaliações de texto e imagem; a documentação da Microsoft também descreve o endpoint como uma forma de avaliar texto, imagens ou ambos.

Isso pode ser útil quando seu aplicativo precisa escolher um próximo passo, como encaminhar uma mensagem para um setor ou sinalizar uma imagem para revisão. O formato de resposta pode simplificar o processamento, mas não garante, por si só, menor latência no sistema completo. Rede, tamanho da entrada e integração também influenciam o tempo observado.

Imagem ilustrativa. Foto de cottonbro studio no Pexels.

O que a Decisions API retorna?

Uma requisição reúne o modelo, a entrada a avaliar e uma ou mais perguntas. A entrada pode ser texto, mensagens com texto ou imagens e dados JSON. Cada pergunta define o que avaliar; a resposta apresenta resultados associados aos nomes das perguntas. A documentação da OpenAI traz exemplos de avaliação de texto e imagem.

Há três tipos principais de pergunta:

• Predicate: verifica se uma condição é verdadeira e retorna uma probabilidade estimada entre 0 e 1. Um exemplo é perguntar se uma foto mostra dano visível.
• Choice: seleciona uma opção de uma lista definida por você, como “cobrança”, “suporte técnico” ou “acesso à conta”. A resposta inclui a opção escolhida e probabilidades para as alternativas.
• Score: avalia a entrada segundo níveis ordenados, como uma escala de gravidade. Pode ser útil quando uma categoria simples não representa bem a prioridade.

Esses resultados são dados para a aplicação consumir, não decisões infalíveis. A probabilidade é uma estimativa do modelo, não uma garantia de correção. Em uma classificação por opções, considere tanto a escolha quanto as probabilidades associadas às alternativas.

Quando o endpoint pode contribuir para um aplicativo mais responsivo?

O endpoint é adequado quando sua aplicação precisa de um resultado delimitado, como verificar uma condição, escolher uma categoria ou atribuir uma pontuação. Respostas tipadas podem evitar que o aplicativo precise interpretar texto livre para obter esse resultado. Ainda assim, o efeito sobre a latência depende da integração: meça o tempo da chamada e o tempo total do fluxo em condições representativas antes de decidir se houve melhora.

Se a tarefa exige uma explicação em linguagem natural ou um objeto que siga um esquema JSON próprio, a documentação da Microsoft indica considerar saídas estruturadas com o Responses API. Para solicitar chamadas de ferramentas com argumentos, a alternativa indicada é function calling.

Exemplo hipotético: um sistema de atendimento recebe mensagens de clientes e precisa encaminhá-las. Uma pergunta do tipo choice pode selecionar entre “cobrança”, “suporte técnico” e “acesso à conta”. Inclua uma opção como “outros” se essas categorias não cobrirem todas as solicitações. O aplicativo pode usar o resultado para encaminhar a mensagem; se a pessoa também precisar de uma explicação, essa etapa deve ser tratada separadamente, pois uma decisão tipada não equivale a uma resposta escrita para o cliente.

Imagem ilustrativa. Foto de Matheus Bertelli no Pexels.

O que considerar antes de integrar a Decisions API?

A documentação indica o gpt-6-luna como modelo atualmente suportado e uma chamada por endpoint dedicado de decisões. Para imagens, a entrada aceita uma URL HTTP ou HTTPS acessível publicamente ou uma data URL com conteúdo codificado em base64; entradas por file_id não são aceitas. Revise como seu aplicativo envia imagens e evite expor arquivos privados por URLs públicas sem avaliar os controles necessários.

Teste as perguntas com exemplos representativos do seu fluxo. Para um predicate, defina o que conta como verdadeiro. Para choice, escreva descrições claras e opções distintas. Em seguida, escolha como lidar com resultados incertos de acordo com o risco: em vez de acionar automaticamente uma ação sensível, seu sistema pode encaminhar o caso para revisão humana.

Na Azure, a documentação da Microsoft descreve a integração por SDK ou REST e informa requisitos de implantação. O rollout documentado começa em regiões dos Estados Unidos para implantações Global Standard e Data Zone, com East US 2 excluída. Como a disponibilidade depende da região e do modelo, equipes no Brasil devem verificar se o recurso está habilitado para sua implantação.

Como avaliar se vale a pena?

Compare a Decisions API com a solução que você já usa considerando latência observada, qualidade das decisões, custo total e volume de casos que exigem revisão. Faça a comparação com entradas e condições semelhantes às da produção; assim, você avalia o efeito da integração no seu aplicativo, em vez de presumir um ganho de velocidade.

Consulte os preços aplicáveis ao provedor e à implantação escolhidos. As condições da API da OpenAI e as de uma oferta Azure não devem ser tratadas como equivalentes: a documentação da Microsoft direciona usuários à página de preços do Azure OpenAI. Calcule o custo do fluxo completo, incluindo o tratamento de casos encaminhados para revisão humana.

Atualizado em 23/10/2026.