Padrões de Combinação de Ferramentas
Nesta página
Combine ferramentas para tarefas complexas
As ferramentas do Grok tornam-se verdadeiramente poderosas quando as combina. A pesquisa na Web por si só fornece dados brutos. Ao adicionar a execução de código, consegue analisar esses dados. Se incluir as suas funções personalizadas, pode agir sobre os resultados. Esta lição abrange os padrões de combinação mais úteis.
Padrão 1: Pesquisa + Análise
O caso de uso mais comum combina a pesquisa na Web com a execução de código para recolher dados e tirar conclusões:
response = await client.chat.completions.create(
model="grok-4.5",
messages=[{
"role": "user",
"content": "Look up the stock prices for Tesla, Apple, and Microsoft over the last 30 days. "
"Calculate relative performance and identify the trend."
}],
tools=[
{"type": "web_search"},
{"type": "code_interpreter"}
],
max_turns=5
)
O Grok começa com uma pesquisa na Web para obter dados financeiros e, em seguida, utiliza a execução de código para calcular o desempenho e gerar um gráfico. Tudo ocorre num único pedido graças a um valor de max_turns suficiente.
Padrão 2: Notícias de múltiplas fontes
A combinação da Pesquisa na Web e da Pesquisa no X oferece uma cobertura abrangente sobre um tópico:
response = await client.chat.completions.create(
model="grok-4.5",
messages=[{
"role": "user",
"content": "What are the reactions to the announcement of the new AI regulation in Europe? "
"Compare official sources and reactions on X."
}],
tools=[
{"type": "web_search"},
{"type": "x_search"}
],
max_turns=5
)
A pesquisa na Web capta artigos de imprensa e comunicados oficiais, enquanto a pesquisa no X capta reações e opiniões em tempo real.
Padrão 3: Extração de múltiplas fontes com funções
Para fluxos de trabalho mais complexos, combine ferramentas do servidor com as suas funções personalizadas:
tools = [
{"type": "web_search"},
{"type": "code_interpreter"},
{
"type": "function",
"function": {
"name": "save_to_database",
"description": "Saves structured results to the database",
"parameters": {
"type": "object",
"properties": {
"category": {"type": "string"},
"data": {"type": "object"},
"source_urls": {"type": "array", "items": {"type": "string"}}
},
"required": ["category", "data"]
}
}
}
]
async def research_and_save(topic: str) -> str:
messages = [{"role": "user", "content": f"Research and analyze: {topic}. "
"Save the structured results."}]
while True:
response = await client.chat.completions.create(
model="grok-4.5",
messages=messages,
tools=tools,
max_turns=5
)
message = response.choices[0].message
if not message.tool_calls:
return message.content
messages.append(message)
for tc in message.tool_calls:
if tc.function.name == "save_to_database":
result = await save_to_db(json.loads(tc.function.arguments))
messages.append({
"role": "tool",
"tool_call_id": tc.id,
"content": json.dumps(result)
})
Neste padrão, o Grok pesquisa informações, analisa-as com código e, em seguida, chama a sua função para guardar os resultados. O fluxo de trabalho é totalmente autónomo.
Padrão 4: Validação cruzada
Utilize múltiplas fontes para verificar a fiabilidade da informação:
response = await client.chat.completions.create(
model="grok-4.5",
messages=[{
"role": "user",
"content": "Verify this claim by cross-referencing sources: "
"'France produced 70% of its electricity from nuclear power in 2024.' "
"Compare data from multiple official sources."
}],
tools=[
{"type": "web_search"},
{"type": "code_interpreter"}
],
max_turns=8
)
Com um valor de max_turns mais elevado, o Grok pode realizar várias pesquisas sucessivas para cruzar informações e utilizar a execução de código para comparar os valores.
Melhores práticas
Especifique as ferramentas no prompt
Não se limite a declarar as ferramentas no parâmetro tools. Indique explicitamente no seu prompt o que espera:
# BOM: o prompt orienta a utilização das ferramentas
"""Search for the data, then use code to generate a comparison table.
Save the final result via save_to_database."""
# MAU: o prompt não menciona as ferramentas
"Give me information on this topic."
Limite as ferramentas às necessidades
Não ative todas as ferramentas se apenas precisar de uma. Cada ferramenta adiciona contexto ao prompt do sistema, consumindo tokens e podendo distrair o modelo.
Pontos-chave
- Pesquisa + Execução de Código permite recolher e analisar dados num único pedido
- Pesquisa na Web + Pesquisa no X oferece uma cobertura abrangente (artigos + reações)
- Funções personalizadas estendem as capacidades para além do que as ferramentas do servidor oferecem
- Oriente explicitamente o Grok no seu prompt sobre quais as ferramentas a utilizar
- Adapte o
max_turnsà complexidade do fluxo de trabalho (5-8 para combinações de múltiplas ferramentas) - Ative apenas as ferramentas necessárias para otimizar o consumo de tokens