Nástroje zabudované v rozhraní Responses API
Na této stránce
Rozšíření schopností modelu
Modely Grok se neomezují jen na generování textu. Pomocí parametru tools jim můžeš poskytnout přístup k nástrojům, které výrazně rozšiřují jejich možnosti: vyhledávání na webu v reálném čase, hledání na platformě X (dříve Twitter), spouštění kódu v Pythonu a tvé vlastní custom funkce.
Čtyři typy nástrojů
web_search
Umožňuje modelu vyhledávat informace na webu v reálném čase:
{
"model": "grok-4.20-0309-reasoning",
"input": "What's the latest news on AI in Europe?",
"tools": [{"type": "web_search"}]
}
Model se automaticky rozhodne, kdy vyhledávání provést. Výsledky jsou integrovány do jeho odpovědi včetně citací.
x_search
Vyhledává příspěvky na platformě X (dříve Twitter):
{
"model": "grok-4.20-0309-reasoning",
"input": "What is the tech community saying about the latest iPhone?",
"tools": [{"type": "x_search"}]
}
Obzvláště užitečné pro zachycení veřejného mínění, trendů a reakcí v reálném čase.
code_interpreter
Spouští kód v Pythonu na straně serveru za účelem výpočtů, analýzy dat nebo tvorby grafů:
{
"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 Pythonu, spustí jej na serverech xAI a integruje výsledky do své odpovědi.
function
Tvé vlastní funkce, které může model volat. Model generuje argumenty, ale tvůj kód funkci skutečně provede:
{
"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"]
}
}]
}
Kombinace více nástrojů
Do jednoho požadavku můžeš předat až 128 nástrojů. Model si sám vybere ten (nebo ty), který se 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 příkladu může model nejprve použít web_search k nalezení výsledků a následně code_interpreter k jejich naformátování do tabulky.
Nástroje na straně serveru vs. na straně klienta
Rozdíl je zásadní:
-
Nástroje na straně serveru (
web_search,x_search,code_interpreter): Automaticky je spouštějí servery xAI. Nemusíš dělat nic – model zahájí vyhledávání nebo spuštění kódu, získá výsledek a integruje jej do své odpovědi. -
Nástroje na straně klienta (
function): Model vygeneruje volání funkce s argumenty a poté pozastaví generování. Tvůj kód funkci provede a výsledek odešleš zpět v novém požadavku.
Tento rozdíl přímo ovlivňuje architekturu tvé aplikace, jak uvidíš v následujících lekcích.
Klíčové poznatky
- Čtyři typy nástrojů:
web_search,x_search,code_interpreter,function - První tři běží na straně serveru – nepotřebuješ žádnou vlastní infrastrukturu
- Nástroje typu
functionběží na straně klienta – provedení řeší tvůj kód - Do jednoho požadavku můžeš kombinovat až 128 nástrojů
- Model se automaticky rozhoduje, kdy a které nástroje použít