Ir al contenido principal
Español— Elegir un idioma
Menú

tool_choice y control

Lección 5 de 14 Actualizado el 29 de julio de 2026 Desarrollador
En esta página
  1. Control del comportamiento del modelo
  2. Los cuatro modos de tool_choice
  3. Comparación de modos
  4. Estrategias avanzadas
  5. Puntos clave

Control del comportamiento del modelo

Por defecto, el modelo decide por sí mismo si debe llamar a una herramienta o responder directamente. Este es el modo auto. Sin embargo, en algunos casos necesitas un control más fino. El parámetro tool_choice te otorga esa capacidad.

Los cuatro modos de tool_choice

Modo auto (predeterminado)

response = client.chat.completions.create(
    model="grok-4.5",
    messages=messages,
    tools=tools,
    tool_choice="auto"
)

El modelo evalúa la solicitud y decide:

  • Si la solicitud requiere datos externos → llama a una herramienta
  • Si puede responder directamente → responde sin usar una herramienta

Este es el modo más común y natural. Úsalo cuando confíes en el criterio del modelo.

Modo required

response = client.chat.completions.create(
    model="grok-4.5",
    messages=messages,
    tools=tools,
    tool_choice="required"
)

El modelo debe llamar al menos a una herramienta. No puede responder directamente, incluso si ya conoce la respuesta. Casos de uso:

  • Extracción estructurada: Quieres obligar al modelo a extraer datos en un formato específico mediante una herramienta dedicada
  • Validación obligatoria: Cada solicitud debe pasar por una herramienta de verificación
  • Registro sistemático: Todo debe quedar registrado mediante una herramienta de logging

Modo none

response = client.chat.completions.create(
    model="grok-4.5",
    messages=messages,
    tools=tools,
    tool_choice="none"
)

Desactiva completamente la llamada a funciones para esta solicitud. El modelo ve las definiciones de las herramientas (permanecen en el contexto), pero no puede llamarlas. Casos de uso:

  • Fase de aclaración: Quieres que el modelo haga preguntas antes de actuar
  • Modo de vista previa: Mostrar qué haría el modelo sin ejecutarlo
  • Respaldo (fallback): Si las herramientas no están disponibles temporalmente

Modo específico (forzar una herramienta concreta)

response = client.chat.completions.create(
    model="grok-4.5",
    messages=messages,
    tools=tools,
    tool_choice={
        "type": "function",
        "function": {"name": "get_weather"}
    }
)

Se obliga al modelo a llamar exactamente a esta herramienta. No puede elegir otra ni responder directamente. Este es el modo más restrictivo. Casos de uso:

  • Flujo de trabajo secuencial: En este paso, se debe llamar a esta herramienta específica
  • Pruebas: Quieres verificar que el modelo genera los argumentos correctos para una herramienta dada
  • Extracción dirigida: Sabes qué herramienta usar y solo quieres que el modelo extraiga los parámetros

Comparación de modos

Modo Comportamiento Cuándo usarlo
auto El modelo decide libremente Caso general, chatbots
required Debe llamar al menos a una herramienta Extracción, validación
none No se permiten herramientas Aclaración, respaldo
{"function":...} Fuerza una herramienta específica Flujo de trabajo, pruebas

Estrategias avanzadas

Alternar modos en un flujo de trabajo

Un flujo de trabajo inteligente puede cambiar tool_choice dependiendo del paso:

# Paso 1: forzar búsqueda
response1 = client.chat.completions.create(
    model="grok-4.5",
    messages=messages,
    tools=tools,
    tool_choice={"type": "function", "function": {"name": "search_products"}}
)

# Paso 2: dejar que el modelo decida (análisis o pregunta)
response2 = client.chat.completions.create(
    model="grok-4.5",
    messages=updated_messages,
    tools=tools,
    tool_choice="auto"
)

Combinar con el prompt del sistema

El prompt del sistema puede guiar al modelo en sus elecciones de herramientas, incluso en modo auto:

messages = [
    {
        "role": "system",
        "content": "Eres un asistente de viajes. Usa siempre "
                   "get_weather antes de recomendar actividades al aire libre."
    },
    {"role": "user", "content": "¿Qué puedo hacer en Marsella este fin de semana?"}
]

Puntos clave

  • auto: El modelo decide (predeterminado, recomendado para la mayoría de los casos)
  • required: Obliga a llamar al menos a una herramienta
  • none: Desactiva temporalmente la llamada a funciones
  • Modo específico: Obliga a llamar a una herramienta concreta por su nombre
  • Alterna modos en un flujo de trabajo para un control fino
  • Combina tool_choice con el prompt del sistema para guiar al modelo