Vzorci kombiniranja orodij
Na tej strani
Združevanje orodij za kompleksne naloge
Grokova orodja postanejo resnično zmogljiva, ko jih združiš. Spletno iskanje samo po sebi zagotavlja surove podatke. Če dodaš izvajanje kode, lahko te podatke analiziraš. Z dodajanjem lastnih funkcij pa lahko na podlagi rezultatov tudi ukrepaš. Ta lekcija pokriva najbolj uporabne vzorce kombiniranja.
Vzorci 1: Iskanje + Analiza
Najpogostejši primer uporabe združuje spletno iskanje z izvajanjem kode za zbiranje podatkov in sklepanje:
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 s spletnim iskanjem za pridobitev finančnih podatkov, nato pa uporabi izvajanje kode za izračun uspešnosti in izris grafa. Zaradi zadostne vrednosti max_turns se vse zgodi v enem samem zahtevku.
Vzorci 2: Novice iz več virov
Kombinacija spletnega iskanja in iskanja po X ponuja celovito pokritost teme:
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
)
Spletno iskanje zajame tiskovne članke in uradne izjave, medtem ko iskanje po X zajame reakcije in mnenja v realnem času.
Vzorci 3: Ekstrakcija iz več virov s funkcijami
Za bolj kompleksne delovne tokove združi strežniška orodja s svojimi funkcijami:
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 tem vzorcu Grok poišče informacije, jih analizira s kodo in nato pokliče tvojo funkcijo za shranjevanje rezultatov. Delovni tok je popolnoma avtonomen.
Vzorci 4: Navzkrižno preverjanje
Uporabi več virov za preverjanje zanesljivosti informacij:
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
)
Z višjo vrednostjo max_turns lahko Grok izvede več zaporednih iskanj za navzkrižno preverjanje informacij in uporabi izvajanje kode za primerjavo številk.
Najboljše prakse
Določi orodja v pozivu
Ne deklariraj orodij le v parametru tools. V svojem pozivu izrecno navedi, kaj pričakuješ:
# DOBRO: poziv usmerja uporabo orodij
"""Search for the data, then use code to generate a comparison table.
Save the final result via save_to_database."""
# SLABO: poziv ne omenja orodij
"Give me information on this topic."
Omeji orodja na potrebe
Ne omogočaj vsakega orodja, če potrebuješ le eno. Vsako orodje doda kontekst sistemskemu pozivu, kar porablja žetone in lahko model odvrne od bistva.
Ključne ugotovitve
- Iskanje + Izvajanje kode ti omogoča zbiranje in analizo podatkov v enem zahtevku
- Spletno iskanje + Iskanje po X ponuja celovito pokritost (članki + reakcije)
- Funkcije po meri razširijo zmogljivosti onkraj tistega, kar ponujajo strežniška orodja
- V pozivu izrecno usmeri Groka, katera orodja naj uporabi
- Prilagodi
max_turnskompleksnosti delovnega toka (5–8 za kombinacije več orodij) - Omogoči le potrebna orodja za optimizacijo porabe žetonov