Ir para o conteúdo principal
Português— Escolher um idioma
Menu

tool_choice e controlo

Aula 5 de 14 Atualizada a 29 de julho de 2026 Programador
Nesta página
  1. Controlar o comportamento do modelo
  2. Os quatro modos de tool_choice
  3. Comparação de modos
  4. Estratégias avançadas
  5. Pontos-chave

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 ferramenta
  • none: 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_choice com o prompt do sistema para orientar o modelo