CASO DE USO EM PRODUÇÃO
Um assistente de vendas consulta contas, calcula orçamentos e cria rascunhos de pedidos. Primeiro chama lookup_account, depois calculate_quote. create_order fica indisponível até uma pessoa confirmar o rascunho exato.
Implementação para produção
| Escolha para produção | Recomendação | Por quê |
|---|---|---|
| API | POST /v1/chat/completions | Requisição do servidor compatível com OpenAI |
| Modelo principal | gpt-5.6-terra | Terra é a opção inicial para escolher ferramentas e construir argumentos em várias etapas, sem usar o modelo principal em toda chamada. |
| Modelo alternativo | gpt-5.5 | Use gpt-5.5 para solicitações só de leitura com uma ferramenta após validar o esquema. Encaminhe ao Sol planos ambíguos com várias ferramentas dependentes. |
| Modelo para tarefas mais difíceis | gpt-5.6-sol | Use só se a rota principal não atingir o limite de qualidade ou complexidade |
| Formato esperado | Chamadas de ferramentas validadas | Chamadas validadas seguidas de um orçamento provisório; nenhum pedido externo é criado antes da confirmação. |
Um assistente de vendas consulta contas, calcula orçamentos e cria rascunhos de pedidos. Primeiro chama lookup_account, depois calculate_quote. create_order fica indisponível até uma pessoa confirmar o rascunho exato.
O modelo propõe chamadas; a aplicação valida esquemas, permissões e estado antes de executar. Erros são retornados de forma estruturada e a mesma chamada inválida não é repetida.
Envie a requisição pelo servidor. Troque o conteúdo e os esquemas de exemplo pelos dados e ferramentas do aplicativo.
curl https://app.llmfly.ai/v1/chat/completions \
-H "Authorization: Bearer $LLMFLY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-terra",
"messages": [
{"role": "system", "content": "Use the available tools to prepare a quote. Never create an order until the user confirms the exact draft. Do not invent account IDs or prices."},
{"role": "user", "content": "Prepare a quote for 25 seats for Acme's current plan."}
],
"tools": [{"type": "function", "function": {"name": "YOUR_TOOL", "description": "Replace with the tool contract for this workflow", "parameters": {"type": "object", "properties": {}, "additionalProperties": false}}}]
}'Terra é a opção inicial para escolher ferramentas e construir argumentos em várias etapas, sem usar o modelo principal em toda chamada.
Use gpt-5.5 para solicitações só de leitura com uma ferramenta após validar o esquema. Encaminhe ao Sol planos ambíguos com várias ferramentas dependentes.
| Métrica | Condição de aprovação |
|---|---|
| Taxa de escolha correta de ferramentas | O modelo chama a ferramenta necessária e evita ferramentas quando não precisa |
| Taxa de argumentos válidos | Os argumentos passam nas validações de esquema, intervalo, ID e permissões |
| Recuperação após erros de ferramentas | Um erro recuperável leva a corrigir a chamada, não a repeti-la igual |
| Taxa de chamadas inseguras | Nenhuma ferramenta importante é executada sem permissão ou confirmação obrigatórias |
Chamadas validadas seguidas de um orçamento provisório; nenhum pedido externo é criado antes da confirmação.
Registre ID do modelo e da requisição, tokens, novas tentativas, validação e decisão final em cada execução de produção.
Antes dos argumentos, confira se escolheu a ferramenta correta ou acertou ao não usar nenhuma.
Não. Valide tipos, campos obrigatórios, intervalos, IDs e permissões.
Retorne um erro curto e estruturado, sem segredos nem rastros internos.
Compare principal e alternativo com as mesmas requisições, ferramentas e regras de validação.