Tools y function calling

Flujo básico

• Envía una lista `tools` con funciones JSON Schema.
• El modelo responde con `tool_calls` cuando necesita datos externos.
• Ejecuta la función en tu backend y devuelve el resultado como mensaje `tool`.
• Haz una segunda llamada para que el modelo redacte la respuesta final.

Ejemplo mínimo

{
  "model": "Qwen/Qwen3.6-35B-A3B",
  "messages": [{"role": "user", "content": "Busca el estado del pedido A-102"}],
  "tools": [{
    "type": "function",
    "function": {
      "name": "get_order_status",
      "parameters": {
        "type": "object",
        "properties": { "order_id": { "type": "string" } },
        "required": ["order_id"]
      }
    }
  }]
}

Buenas prácticas

• Valida siempre argumentos de tool en servidor; no ejecutes acciones sensibles solo por confianza en el modelo.
• Usa nombres de función estables y descripciones cortas orientadas a cuándo llamar la tool.
• Para operaciones destructivas, exige confirmación explícita del usuario antes de ejecutar.