Žádné volání vlastních funkcí: pochopení omezení
Na této stránce
Strukturální omezení
Pokud jsi zvyklý definovat vlastní funkce a nechávat model, aby se sám rozhodl, kdy je zavolat, připrav se na změnu přístupu: multi-agentní systém Grok nepodporuje volání vlastních funkcí. Nejde o detail konfigurace, ale o architektonické omezení, které ovlivňuje způsob, jakým strukturuješ svou aplikaci. Je lepší se to dozvědět teď, než až napíšeš tři sta řádků schémat funkcí.
Přesná hranice
Funguje pouze pět vestavěných nástrojů z předchozí lekce: web_search pro vyhledávání na webu v reálném čase, x_search pro platformu X, code_execution pro spouštění Pythonu, collections_search pro tvé indexované kolekce a Remote MCP pro externí nástroje prostřednictvím protokolu MCP. Nic jiného nefunguje. Funkce definované ve tvém kódu, vlastní schémata ani volání tvých vlastních API prostřednictvím mechanismu volání funkcí jsou zamítnuta.
Konkrétně následující deklarace, která je u standardního modelu zcela platná, nemá v multi-agentním režimu žádný efekt.
# DOES NOT WORK with multi-agent
tools = [
{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get the weather",
"parameters": {"type": "object", "properties": {"city": {"type": "string"}}}
}
}
]
Původ tohoto omezení
Důvodem je koordinace. U jediného modelu je smyčka volání funkcí jasná: model požádá o volání, tvůj kód jej provede, vrátíš výsledek a model pokračuje. Nyní přidej čtyři nebo šestnáct agentů pracujících paralelně a otázky se začnou hromadit. Který z nich se rozhodne funkci zavolat? Co když dva agenti zavolají stejnou funkci současně s různými argumenty? Jak lídr syntetizuje výsledky získané podřízenými agenty, jejichž úvahy nesledoval?
Vestavěné nástroje jsou navrženy pro tento kontext a vědí, jak se správně chovat, když o ně žádá více agentů najednou. Tvé funkce však byly napsány s předpokladem jediného volajícího. Toto omezení odráží právě tento rozdíl v návrhu, nikoliv dočasný nedostatek.
Exponuj svá API prostřednictvím serveru MCP
Nejčistším řešením není hledat obeličku, ale využít určený vstup. Pokud potřebuješ volat své vlastní služby, exponuj je prostřednictvím serveru MCP: agenti je pak budou zpracovávat jako nativní nástroje s nezbytnou správou souběžnosti. Je to sice zpočátku trochu více práce než pouhá deklarace funkce, ale zůstává to jediný způsob, jak zapojit tvůj informační systém do smyčky vyhledávání.
Odděl výzkum od akce
Druhou strategií, která je často tou správnou volbou, když tvé funkce spouštějí vedlejší efekty, je rozdělit proces na dvě části. Multi-agent dělá to, co umí nejlépe – vyhledává a analyzuje; část, která volá tvá API, přebere standardní model.
# Step 1: multi-agent research
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4,
tools=[web_search()],
)
chat.append(user("Find the best Italian restaurants in Paris"))
research_result = ""
for response, chunk in chat.stream():
if chunk.content:
research_result += chunk.content
# Step 2: action with standard model + function calling
# Use grok-4.5 or another model that supports function calling
Toto oddělení má podceňovanou výhodu: umožňuje ti zkontrolovat a ověřit výsledek vyhledávání předtím, než dojde k nevratné akci. Agent, který rezervuje stůl na základě neověřeného výzkumu, je zřídka dobrý nápad.
Obohať předem, zpracuj poté
Třetím přístupem, tím nejlehčím, je volat svá API mimo konverzaci – upstream pro obohacení promptu nebo downstream pro využití odpovědi. Mnoho potřeb, o kterých se věří, že vyžadují volání funkcí, se ve skutečnosti redukuje na vstříknutí správných dat ve správný čas.
# Pre-processing: enrich context
user_data = my_api.get_user_profile(user_id)
context = f"User profile: {user_data}"
# Multi-agent with enriched context
chat.append(user(f"{context}\n\nAnalyze options matching this profile"))
Profil zákazníka, historie objednávek nebo rozpočtová omezení nemusí model získávat sám: ty je již znáš, stačí mu je předat. Nakonec měj na paměti, že API je v beta verzi a toto omezení se může v budoucnu změnit – což je tím větší důvod izolovat multi-agentní část tvého kódu za rozhraní, které můžeš vyvíjet bez nutnosti přepisovat vše ostatní.
Klíčové poznatky
- Volání vlastních funkcí není podporováno u multi-agentních systémů
- Fungují pouze vestavěné nástroje (web_search, x_search, code_execution, collections_search, Remote MCP)
- Použij Remote MCP k exponování vlastních API pro agenty
- Přijmi dvoukrokovou architekturu, pokud potřebuješ volání funkcí
- Toto omezení se může v budoucích verzích změnit (API je v beta verzi)