Tööriistade kombineerimise mustrid
Sellel lehel
Kombineeri tööriistu keerukate ülesannete jaoks
Groki tööriistad muutuvad tõeliselt võimsaks, kui neid kombineerid. Ainult veebiotsing pakub tooreid andmeid. Lisades koodi käivitamise, saad neid andmeid analüüsida. Lisades oma kohandatud funktsioonid, saad tulemuste põhjal tegutseda. See tund käsitleb kasulikumaid kombineerimise mustreid.
Muster 1: Otsing + Analüüs
Levinuim kasutusjuhtum ühendab veebiotsingu koodi käivitamisega, et koguda andmeid ja teha järeldusi:
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 alustab veebiotsinguga finantsandmete hankimiseks ja kasutab seejärel koodi käivitamist tulemuslikkuse arvutamiseks ning graafiku joonistamiseks. Tänu piisavale max_turns väärtusele toimub kõik ühe päringu raames.
Muster 2: Mitme allikaga uudised
Veebiotsingu ja X-i otsingu kombineerimine pakub teema kohta põhjalikku kajastust:
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
)
Veebiotsing haarab pressiteateid ja ametlikke avaldusi, samas kui X-i otsing tabab reaalajas reaktsioone ja arvamusi.
Muster 3: Mitme allikaga ekstraheerimine funktsioonidega
Keerukamate töövoogude jaoks kombineeri serveritööriistu oma kohandatud funktsioonidega:
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)
})
Selles mustris otsib Grok teavet, analüüsib seda koodi abil ja kutsub seejärel üles sinu funktsiooni tulemuste salvestamiseks. Töövoog on täielikult autonoomne.
Muster 4: Ristkontroll
Kasuta mitut allikat teabe usaldusväärsuse kontrollimiseks:
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
)
Suurema max_turns väärtusega saab Grok teha mitu järjestikust otsingut teabe ristkontrolliks ja kasutada koodi käivitamist arvude võrdlemiseks.
Parimad tavad
Määra tööriistad vihjes
Ära lihtsalt deklareeri tööriistu parameetris tools. Sõnasta oma vihjes selgelt, mida ootad:
# HEA: vihje suunab tööriistade kasutamist
"""Otsi andmed üles ja kasuta seejärel koodi võrdlustabeli loomiseks.
Salvesta lõpptulemus funktsiooni save_to_database abil."""
# HALB: vihjes ei mainita tööriistu
"Anna mulle sellel teemal teavet."
Piira tööriistu vajadustega
Ära lülita sisse kõiki tööriistu, kui vajad ainult ühte. Iga tööriist lisab süsteemi vihjele konteksti, tarbides tokeneid ja potentsiaalselt mudelit segades.
Peamised punktid
- Otsing + koodi käivitamine võimaldab andmeid koguda ja analüüsida ühe päringuga
- Veebiotsing + X-i otsing pakub põhjalikku kajastust (artiklid + reaktsioonid)
- Kohandatud funktsioonid laiendavad võimalusi kaugemale sellest, mida serveritööriistad pakuvad
- Suuna Groki vihjes selgelt, milliseid tööriistu kasutada
- Kohanda
max_turnsväärtust töövoogude keerukusele (5–8 mitme tööriista kombinatsioonide puhul) - Lülita sisse ainult vajalikud tööriistad, et optimeerida tokenite tarbimist