tool_choice e controlo
Nesta página
Controlar o comportamento do modelo
Por predefinição, o modelo decide por si próprio se deve chamar uma ferramenta ou responder diretamente. Este é o modo auto. No entanto, em alguns casos, necessita de um controlo mais fino. O parâmetro tool_choice dá-lhe esse poder.
Os quatro modos de tool_choice
Modo auto (predefinição)
response = client.chat.completions.create(
model="grok-4.5",
messages=messages,
tools=tools,
tool_choice="auto"
)
O modelo avalia o pedido e decide:
- Se o pedido exigir dados externos → chama uma ferramenta
- Se puder responder diretamente → responde sem usar uma ferramenta
Este é o modo mais comum e natural. Utilize-o quando confiar no julgamento do modelo.
Modo required
response = client.chat.completions.create(
model="grok-4.5",
messages=messages,
tools=tools,
tool_choice="required"
)
O modelo tem de chamar pelo menos uma ferramenta. Não pode responder diretamente, mesmo que já conheça a resposta. Casos de utilização:
- Extração estruturada: Pretende obrigar o modelo a extrair dados num formato específico através de uma ferramenta dedicada
- Validação obrigatória: Cada pedido deve passar por uma ferramenta de verificação
- Registo sistemático: Tudo deve ser registado através de uma ferramenta de logging
Modo none
response = client.chat.completions.create(
model="grok-4.5",
messages=messages,
tools=tools,
tool_choice="none"
)
Desativa completamente a chamada de funções para este pedido. O modelo vê as definições das ferramentas (que permanecem no contexto), mas não as pode chamar. Casos de utilização:
- Fase de esclarecimento: Pretende que o modelo faça perguntas antes de agir
- Modo de pré-visualização: Mostrar o que o modelo faria sem executar a ação
- Fallback: Se as ferramentas estiverem temporariamente indisponíveis
Modo específico (forçar uma ferramenta específica)
response = client.chat.completions.create(
model="grok-4.5",
messages=messages,
tools=tools,
tool_choice={
"type": "function",
"function": {"name": "get_weather"}
}
)
O modelo é obrigado a chamar exatamente esta ferramenta. Não pode escolher outra, nem responder diretamente. Este é o modo mais restritivo. Casos de utilização:
- Fluxo de trabalho sequencial: Nesta etapa, esta ferramenta específica deve ser chamada
- Testes: Pretende verificar se o modelo gera os argumentos corretos para uma determinada ferramenta
- Extração direcionada: Sabe qual a ferramenta a utilizar e apenas quer que o modelo extraia os parâmetros
Comparação de modos
| Modo | Comportamento | Quando utilizar |
|---|---|---|
| auto | O modelo decide livremente | Caso geral, chatbots |
| required | Deve chamar pelo menos uma ferramenta | Extração, validação |
| none | Nenhuma ferramenta permitida | Esclarecimento, fallback |
| {"function":...} | Força uma ferramenta específica | Fluxo de trabalho, testes |
Estratégias avançadas
Alternar modos num fluxo de trabalho
Um fluxo de trabalho inteligente pode alterar o tool_choice consoante a etapa:
# Etapa 1: forçar pesquisa
response1 = client.chat.completions.create(
model="grok-4.5",
messages=messages,
tools=tools,
tool_choice={"type": "function", "function": {"name": "search_products"}}
)
# Etapa 2: deixar o modelo decidir (análise ou pergunta)
response2 = client.chat.completions.create(
model="grok-4.5",
messages=updated_messages,
tools=tools,
tool_choice="auto"
)
Combinar com o prompt do sistema
O prompt do sistema pode orientar o modelo nas suas escolhas de ferramentas, mesmo no modo auto:
messages = [
{
"role": "system",
"content": "You are a travel assistant. Always use "
"get_weather before recommending outdoor activities."
},
{"role": "user", "content": "What should I do in Marseille this weekend?"}
]
Pontos-chave
auto: O modelo decide (predefinição, recomendado para a maioria dos casos)required: Obriga a chamar pelo menos uma ferramentanone: Desativa temporariamente a chamada de funções- Modo específico: Obriga a chamar uma ferramenta específica pelo nome
- Alterne modos num fluxo de trabalho para um controlo fino
- Combine
tool_choicecom o prompt do sistema para orientar o modelo