Vzorce kombinace nástrojů
Na této stránce
Kombinuj nástroje pro složité úkoly
Nástroje modelu Grok získávají skutečnou sílu, když je zkombinuješ. Samotné webové vyhledávání poskytuje pouze surová data. Přidej spouštění kódu a můžeš tato data analyzovat. Přidej své vlastní funkce a můžeš na základě výsledků jednat. Tato lekce pokrývá nejužitečnější vzorce kombinací.
Vzorec 1: Vyhledávání + Analýza
Nejběžnějším případem použití je kombinace webového vyhledávání se spouštěním kódu za účelem sběru dat a vyvozování závěrů:
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
)
Grok nejprve provede webové vyhledávání pro získání finančních dat a následně využije spouštění kódu k výpočtu výkonnosti a vykreslení grafu. Díky dostatečné hodnotě max_turns se vše odehraje v rámci jediného požadavku.
Vzorec 2: Zprávy z více zdrojů
Kombinace webového vyhledávání a vyhledávání na síti X nabízí komplexní pokrytí daného tématu:
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
)
Webové vyhledávání zachytí tiskové články a oficiální prohlášení, zatímco vyhledávání na síti X zachytí reakce a názory v reálném čase.
Vzorec 3: Extrakce z více zdrojů s funkcemi
Pro složitější pracovní postupy kombinuj serverové nástroje se svými vlastními funkcemi:
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)
})
V tomto vzorci Grok vyhledá informace, analyzuje je pomocí kódu a následně zavolá tvou funkci pro uložení výsledků. Celý pracovní postup je plně autonomní.
Vzorec 4: Křížová validace
Použij více zdrojů k ověření spolehlivosti informací:
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
)
S vyšší hodnotou max_turns může Grok provést několik po sobě jdoucích vyhledávání pro křížové ověření informací a využít spouštění kódu k porovnání číselných údajů.
Osvědčené postupy
Specifikuj nástroje v promptu
Nedeklaruj nástroje pouze v parametru tools. Explicitně uveď ve svém promptu, co očekáváš:
# DOBŘE: prompt řídí použití nástrojů
"""Search for the data, then use code to generate a comparison table.
Save the final result via save_to_database."""
# ŠPATNĚ: prompt nezmiňuje nástroje
"Give me information on this topic."
Omez nástroje na nezbytné potřeby
Nezapínej každý dostupný nástroj, pokud potřebuješ pouze jeden. Každý nástroj přidává do systémového promptu kontext, což spotřebovává tokeny a může model rozptylovat.
Klíčové poznatky
- Kombinace Vyhledávání + Spouštění kódu ti umožňuje sbírat a analyzovat data v rámci jediného požadavku
- Webové vyhledávání + Vyhledávání na síti X nabízí komplexní pokrytí (články + reakce)
- Vlastní funkce rozšiřují možnosti nad rámec toho, co nabízejí serverové nástroje
- Explicitně ve svém promptu veď model Grok, které nástroje má použít
- Přizpůsob hodnotu
max_turnssložitosti pracovního postupu (5–8 pro kombinace více nástrojů) - Povol pouze nezbytné nástroje pro optimalizaci spotřeby tokenů