Vzorce kombinácie nástrojov
Na tejto strane
Kombinuj nástroje pre zložité úlohy
Nástroje modelu Grok získavajú skutočnú silu, keď ich kombinuješ. Samotné webové vyhľadávanie poskytuje surové dáta. Pridaním vykonávania kódu tieto dáta analyzuješ. Pridaním vlastných funkcií môžeš na základe výsledkov konať. Táto lekcia pokrýva najužitočnejšie vzorce kombinácií.
Vzorec 1: Vyhľadávanie + Analýza
Najbežnejším prípadom použitia je kombinácia webového vyhľadávania s vykonávaním kódu na zber dát a vyvodzovanie záverov:
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 začne webovým vyhľadávaním, aby získal finančné údaje, a následne použije vykonávanie kódu na výpočet výkonnosti a vykreslenie grafu. Vďaka dostatočne vysokému parametru max_turns sa všetko udialo v rámci jednej požiadavky.
Vzorec 2: Správy z viacerých zdrojov
Kombinácia webového vyhľadávania a vyhľadávania na sieti X ponúka komplexný prehľad o danej téme:
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é vyhľadávanie zachytí tlačové články a oficiálne vyhlásenia, zatiaľ čo vyhľadávanie na sieti X zachytí reakcie a názory v reálnom čase.
Vzorec 3: Extrakcia z viacerých zdrojov s funkciami
Pre zložitejšie pracovné postupy kombinuj serverové nástroje so svojimi vlastnými funkciami:
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 vyhľadá informácie, analyzuje ich pomocou kódu a následne zavolá tvoju funkciu na uloženie výsledkov. Celý pracovný postup je plne autonómny.
Vzorec 4: Krížová validácia
Použi viacero zdrojov na overenie spoľahlivosti informácií:
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ššou hodnotou max_turns môže Grok vykonať viacero po sebe idúcich vyhľadávaní na krížové overenie informácií a využiť vykonávanie kódu na porovnanie číselných údajov.
Osvedčené postupy
Špecifikuj nástroje v prompte
Nestačí len deklarovať nástroje v parametri tools. Explicitne uveď v prompte, čo očakávaš:
# DOBRE: prompt usmerňuje použitie nástrojov
"""Search for the data, then use code to generate a comparison table.
Save the final result via save_to_database."""
# ZLE: prompt nespomína nástroje
"Give me information on this topic."
Obmedz nástroje na potrebné minimum
Ne povoľuj každý nástroj, ak potrebuješ len jeden. Každý nástroj pridáva do systémového promptu kontext, čo spotrebúva tokeny a môže model rozptýliť.
Kľúčové poznatky
- Kombinácia Vyhľadávanie + Vykonávanie kódu ti umožňuje zbierať a analyzovať dáta v rámci jednej požiadavky
- Webové vyhľadávanie + Vyhľadávanie na sieti X ponúka komplexný prehľad (články + reakcie)
- Vlastné funkcie rozširujú možnosti nad rámec toho, čo ponúkajú serverové nástroje
- Explicitne usmerňuj model Grok v prompte, ktoré nástroje má použiť
- Prispôsob parameter
max_turnszložitosti pracovného postupu (5 – 8 pre kombinácie viacerých nástrojov) - Povoľ iba potrebné nástroje na optimalizáciu spotreby tokenov