CASO DE USO EN PRODUCCIÓN

API de IA para llamadas a funciones

Un asistente de ventas consulta cuentas, calcula presupuestos y crea borradores de pedidos. Primero se llama a lookup_account y luego a calculate_quote. create_order no está disponible hasta que una persona confirme el borrador exacto.

Llamada validada que conecta una respuesta LLM con una acción
API de IA para llamadas a funciones

Implementación para producción

API, modelo principal y configuración alternativa

Elección para producciónRecomendaciónPor qué
APIPOST /v1/chat/completionsSolicitud del servidor compatible con OpenAI
Modelo principalgpt-5.6-terraTerra es la opción inicial para elegir herramientas y construir argumentos en varios pasos, sin usar el modelo insignia en cada llamada.
Modelo alternativogpt-5.5Usa gpt-5.5 para solicitudes de solo lectura con una herramienta tras validar el esquema. Escala a Sol los planes ambiguos con varias herramientas dependientes.
Modelo para tareas más difícilesgpt-5.6-solÚsalo solo si la ruta principal no alcanza el umbral de calidad o complejidad
Formato esperadoLlamadas a herramientas validadasLlamadas validadas seguidas de un presupuesto provisional; no se crean pedidos externos antes de confirmar.
01
Ejemplo

Llamadas a funciones en producción

Un asistente de ventas consulta cuentas, calcula presupuestos y crea borradores de pedidos. Primero se llama a lookup_account y luego a calculate_quote. create_order no está disponible hasta que una persona confirme el borrador exacto.

El modelo propone llamadas; la aplicación valida esquemas, permisos y estado antes de ejecutar. Los errores se devuelven estructurados y no se repite la misma llamada inválida.

02
Arquitectura

Cómo funciona el proceso de llamadas a funciones

  • Expón solo las herramientas permitidas en el estado actual.
  • Deja que el modelo elija herramienta y proponga argumentos.
  • Valida cada argumento y permiso en la aplicación.
  • Usa una clave de idempotencia si puede haber escrituras.
  • Devuelve un resultado estructurado y continúa hasta el límite de parada definido.
03
Solicitud de API

Llama a gpt-5.6-terra mediante LLMFly AI

Envía la solicitud desde el servidor. Sustituye el contenido de ejemplo y los esquemas de muestra por datos y herramientas de tu aplicación.

request.example
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}}}]
  }'
04
Elección del modelo

Por qué gpt-5.6-terra es el modelo principal

Terra es la opción inicial para elegir herramientas y construir argumentos en varios pasos, sin usar el modelo insignia en cada llamada.

Usa gpt-5.5 para solicitudes de solo lectura con una herramienta tras validar el esquema. Escala a Sol los planes ambiguos con varias herramientas dependientes.

05
Aceptación

Pruebas de aceptación de llamadas a funciones

MétricaCondición para aprobar
Elección correcta de herramientasEl modelo llama a la herramienta necesaria y no usa ninguna cuando no hace falta
Argumentos válidosLos argumentos pasan validaciones de esquema, rango, ID y permisos
Recuperación tras errores de herramientasUn error recuperable lleva a corregir la llamada, no a repetirla igual
Llamadas insegurasNinguna herramienta importante se ejecuta sin permiso o confirmación obligatorios
06
Gestión de fallos

Fallos que resolver antes de desplegar

  • Ejecutar argumentos sin validar
  • Repetir la misma llamada inválida
  • Usar descripciones de herramientas ambiguas
  • Dejar que el texto eluda los permisos
07
Salida

Salida e historial de ejecución

Llamadas validadas seguidas de un presupuesto provisional; no se crean pedidos externos antes de confirmar.

Registra ID del modelo y solicitud, tokens, reintentos, validación y decisión final en cada ejecución de producción.

Preguntas frecuentes

¿Qué métrica debo seguir primero?

Antes de los argumentos, comprueba si eligió la herramienta correcta o acertó al no usar ninguna.

¿Debo confiar en los argumentos?

No. Valida tipos, campos obligatorios, rangos, IDs y permisos.

¿Cómo devuelvo errores de herramientas?

Devuelve un error breve y estructurado, sin secretos ni trazas internas.

Prueba esta configuración con tus datos

Compara principal y alternativo con las mismas solicitudes, herramientas y reglas de validación.

Comparar modelos