Derinio šablonai naudojant įrankius
Šiame puslapyje
Įrankių derinimas sudėtingoms užduotims
Grok įrankiai tampa tikrai galingi, kai juos derini. Vien tik žiniatinklio paieška suteikia žalius duomenis. Pridėjus kodo vykdymą, gali tuos duomenis analizuoti. O pridėjus savo funkcijas, gali imtis veiksmų pagal rezultatus. Šioje pamokoje aptarsime naudingiausius derinimo šablonus.
1 šablonas: Paieška + Analizė
Dažniausias naudojimo atvejis – žiniatinklio paieškos derinimas su kodo vykdymu duomenims rinkti ir išvadoms daryti:
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 pirmiausia atlieka žiniatinklio paiešką finansiniams duomenims gauti, o tada naudoja kodo vykdymą našumui apskaičiuoti ir diagramai nubraižyti. Dėl pakankamo max_turns skaičiaus viskas įvyksta vieno užklausos metu.
2 šablonas: Naujienos iš kelių šaltinių
Derinant žiniatinklio paiešką ir X paiešką, gaunamas išsamus temos aprėpimas:
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
)
Žiniatinklio paieška surenka spaudos straipsnius ir oficialius pareiškimus, o X paieška – realiuoju laiku vykstančias reakcijas ir nuomones.
3 šablonas: Duomenų gavyba iš kelių šaltinių naudojant funkcijas
Sudėtingesniems darbo eigoms derink serverio įrankius su savo custom funkcijomis:
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)
})
Šiame šablone Grok ieško informacijos, analizuoja ją naudodamas kodą, o tada iškviečia tavo funkciją rezultatams išsaugoti. Visa darbo eiga yra visiškai autonominė.
4 šablonas: Kryžminis patikrinimas
Naudok kelis šaltinius informacijos patikimumui patikrinti:
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
)
Esant didesniam max_turns skaičiui, Grok gali atlikti kelias nuoseklias paieškas informacijai kryžmiškai patikrinti ir naudoti kodo vykdymą skaičiams palyginti.
Geriausios praktikos
Nurodyk įrankius užuominoje (prompt)
Nepakanka įrankių deklaruoti tik tools parametre. Aiškiai nurodyk savo užuominoje, ko tikiesi:
# GERAI: užuomina nukreipia įrankių naudojimą
"""Search for the data, then use code to generate a comparison table.
Save the final result via save_to_database."""
# BLOGAI: užuominoje nepaminėti įrankiai
"Give me information on this topic."
Apribok įrankius pagal poreikį
Neįjunk visų įrankių, jei tau reikia tik vieno. Kiekvienas įrankis prideda konteksto sistemos užuominai, eikvoja tokenus ir gali nukreipti modelio dėmesį.
Svarbiausi punktai
- Paieška + kodo vykdymas leidžia rinkti ir analizuoti duomenis vienos užklausos metu
- Žiniatinklio paieška + X paieška suteikia išsamų aprėpimą (straipsniai + reakcijos)
- Custom funkcijos praplečia galimybes už serverio įrankių ribų
- Aiškiai nukreipk Grok savo užuominoje, kuriuos įrankius naudoti
- Pritaikyk
max_turnsdarbo eigos sudėtingumui (5–8 derinant kelis įrankius) - Įjunk tik būtinus įrankius, kad optimizuotum tokenų vartojimą