tool_choice y control
En esta página
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 herramientanone: 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_choicecon el prompt del sistema para guiar al modelo