OpenAI Decisions API vs Function Calling

A diferença real

Com function calling você declara ferramentas, envia a conversa, recebe um payload tool_calls, valida seus argumentos, executa a função e devolve o resultado. É um laço projetado para fazer coisas.

Uma chamada de decisão é uma ida e volta: estado entra, resposta sai. Sem registro de ferramentas, sem esquema de argumentos para validar, sem segunda chamada para obter um rótulo utilizável. A resposta já contém o vencedor mais uma probabilidade por opção.

O caminho do function calling

Rotear um ticket via function calling significa embrulhar a resposta numa definição de ferramenta e parsear tool_calls. Funciona — e é a ferramenta certa quando o modelo realmente precisa produzir argumentos para uma ação.

// Function calling: the model decides to call a tool and
// builds its arguments. You parse tool_calls and execute it.
{
  "tools": [{
    "type": "function",
    "function": {
      "name": "route_ticket",
      "parameters": {
        "type": "object",
        "properties": {
          "team": { "enum": ["payments", "frontend", "account"] }
        }
      }
    }
  }]
}

O caminho da decisão

A mesma tarefa de roteamento como pergunta choice: as opções são nomeadas em criteria, e a resposta volta com o rótulo vencedor, probabilidades por opção e um valor de confiança — pronta para receber limiares.

// Decision endpoint: pick among finite answers and get a
// probability per option — no tool plumbing, no arg parsing.
{
  "model": "decisions-1",
  "state": "The page renders blank in Safari.",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Which team should own this ticket?",
      "criteria": {
        "payments": "Checkout or billing.",
        "frontend": "Rendering or browser behavior.",
        "account": "Login or permissions."
      }
    }
  }
}

Quando usar cada um

Use function calling quando o modelo deve produzir argumentos estruturados para uma ação — reserve isto, consulte aquilo, preencha estes campos. A saída alimenta código que executa.

Use um endpoint de decisão quando a saída é a entrada da ação — qual fila, qual ramo, passa ou segura. Você recebe a distribuição, não só a escolha, então casos limítrofes podem ir para um humano em vez de adivinhar.

Perguntas frequentes