Vstavané nástroje pre Responses API
Na tejto strane
Rozšírenie schopností modelu
Modely Grok sa neobmedzujú len na generovanie textu. Pomocou parametra tools im môžeš poskytnúť prístup k nástrojom, ktoré výrazne rozširujú ich možnosti: vyhľadávanie na webe v reálnom čase, vyhľadávanie na platforme X (predtým Twitter), spúšťanie kódu v Pythone a tvoje vlastné custom funkcie.
Štyri typy nástrojov
web_search
Umožňuje modelu vyhľadávať informácie na webe v reálnom čase:
{
"model": "grok-4.20-0309-reasoning",
"input": "What's the latest news on AI in Europe?",
"tools": [{"type": "web_search"}]
}
Model sa automaticky rozhodne, kedy vyhľadávanie vykonať. Výsledky sú integrované do jeho odpovede vrátane citácií.
x_search
Vyhľadáva príspevky na platforme X (predtým Twitter):
{
"model": "grok-4.20-0309-reasoning",
"input": "What is the tech community saying about the latest iPhone?",
"tools": [{"type": "x_search"}]
}
Obzvlášť užitočné na zachytenie verejnej mienky, trendov a reakcií v reálnom čase.
code_interpreter
Spúšta kód v Pythone na strane servera za účelom výpočtov, analýzy dát alebo tvorby grafov:
{
"model": "grok-4.20-0309-reasoning",
"input": "Calculate the mean and standard deviation of these values: 12, 15, 18, 22, 9, 31",
"tools": [{"type": "code_interpreter"}]
}
Model napíše kód v Pythone, spustí ho na serveroch xAI a výsledky integruje do svojej odpovede.
function
Tvoje vlastné funkcie, ktoré môže model volať. Model vygeneruje argumenty, ale tvoj kód funkciu execute:
{
"model": "grok-4.20-0309-reasoning",
"input": "What's the weather in Paris?",
"tools": [{
"type": "function",
"name": "get_weather",
"description": "Retrieves the weather for a given city",
"parameters": {
"type": "object",
"properties": {
"city": {"type": "string", "description": "City name"},
"unit": {"type": "string", "enum": ["celsius", "fahrenheit"]}
},
"required": ["city"]
}
}]
}
Kombinovanie viacerých nástrojov
Do jednej požiadavky môžeš odoslať až 128 nástrojov. Model si vyberie ten (alebo tie), ktorý sa hodí:
{
"model": "grok-4.20-0309-reasoning",
"input": "Search for the latest Ligue 1 results and create a scoreboard.",
"tools": [
{"type": "web_search"},
{"type": "code_interpreter"}
]
}
V tomto príklade môže model najprv použiť web_search na získanie výsledkov a následne code_interpreter na ich naformátovanie do tabuľky.
Nástroje na strane servera vs. na strane klienta
Tento rozdiel je zásadný:
-
Nástroje na strane servera (
web_search,x_search,code_interpreter): Automaticky ich vykonávajú servery xAI. Nemusíš robiť nič – model spustí vyhľadávanie alebo kód, získa výsledok a integruje ho do svojej odpovede. -
Nástroje na strane klienta (
function): Model vygeneruje volanie funkcie s argumentmi a potom pozastaví generovanie. Tvoj kód funkciu execute a ty odošleš výsledok späť v novej požiadavke.
Tento rozdiel priamo ovplyvňuje architektúru tvojej aplikácie, ako uvidíš v nasledujúcich lekciách.
Kľúčové poznatky
- Štyri typy nástrojov:
web_search,x_search,code_interpreter,function - Prvé tri bežia na strane servera – nepotrebuješ žiadnu vlastnú infraštruktúru
- Nástroje typu
functionbežia na strane klienta – execution rieši tvoj kód - Do jednej požiadavky môžeš kombinovať až 128 nástrojov
- Model sa automaticky rozhoduje, kedy a ktoré nástroje použiť