Žiadne volanie vlastných funkcií: pochopenie obmedzenia
Na tejto strane
Štrukturálne obmedzenie
Ak si zvyknutý definovať vlastné funkcie a nechať model rozhodnúť, kedy ich zavolať, priprav sa na zmenu prístupu: multi-agentný systém Grok nepodporuje volanie vlastných funkcií. Nie je to len detail konfigurácie; ide o architektonické obmedzenie, ktoré ovplyvňuje spôsob, akým štruktúruješ svoju aplikáciu. Lepšie je zistiť to teraz, než po napísaní tristo riadkov schém funkcií.
Presná hranica
Funguje iba päť vstavaných nástrojov z predchádzajúcej lekcie: web_search na vyhľadávanie na webe v reálnom čase, x_search pre platformu X, code_execution na spúšťanie Pythonu, collections_search pre tvoje indexované kolekcie a Remote MCP pre externé nástroje cez protokol MCP. Nič iné nefunguje. Funkcie definované v tvojom kóde, vlastné schémy a volania tvojich vlastných API prostredníctvom mechanizmu volania funkcií sú všetky zamietnuté.
Konkrétne má nasledujúce vyhlásenie, ktoré je pri štandardnom modeli úplne platné, v multi-agentnom režime nulový účinok.
# 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 tohto obmedzenia
Dôvod spočíva v koordinácii. Pri jednom modeli je slučka volania funkcií jasná: model požiada o volanie, tvoj kód ho vykoná, vrátiš výsledok a model pokračuje. Teraz si predstav štyri alebo šestnásť agentov pracujúcich paralelne a otázky sa množia. Ktorý z nich sa rozhodne zavolať funkciu? Čo ak dvaja agenti zavolajú tú istú funkciu súčasne s rôznymi argumentmi? Ako líder syntetizuje výsledky získané podriadenými agentmi, ktorých úvahám nesledoval?
Vstavané nástroje sú navrhnuté presne pre tento kontext a vedia sa správne správať, keď o ne požiadajú viacerí agenti naraz. Tvoje funkcie však boli napísané s predpokladom jediného volajúceho. Toto obmedzenie odráža tento rozdiel v dizajne, nie je to len dočasný nedostatok.
Sprístupni svoje API cez server MCP
Najčistejším riešením nie je hľadať obchádzku, ale použiť určený vstup. Ak potrebuješ volać svoje vlastné služby, sprístupni ich cez server MCP: agenti ich potom budú handledovať ako natívne nástroje s potrebným riadením súbežnosti. Je to o niečo viac práce na začiatku než jednoduché vyhlásenie funkcie, ale zostáva to jediný spôsob, ako dostať svoj informačný systém do slučky vyhľadávania.
Oddel výskum od akcie
Druhou stratégiou, ktorá je často tou správnou, keď tvoje funkcie spúšťajú vedľajšie účinky, je rozdelenie procesu na dve časti. Multi-agent robí to, čo vie najlepšie – vyhľadáva a analyzuje; štandardný model preberá časť, ktorá volá tvoje API.
# 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 oddelenie má jednu podceňovanú výhodu: umožňuje ti skontrolovať a overiť výsledok vyhľadávania predtým, než sa spustí nezvratná akcia. Agent, ktorý rezervuje stôl na základe neovereného výskumu, je zriedkavo dobrý nápad.
Obohať vopred, spracuj potom
Tretí prístup, ten najľahší: volaj svoje API mimo konverzácie, upstream na obohatenie promptu alebo downstream na využitie odpovede. Mnoho potrieb, o ktorých sa verí, že si vyžadujú volanie funkcií, sa v skutočnosti redukuje na vstreknutie správnych dát v správny č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, história objednávok alebo rozpočtové obmedzenia nemusia byť získavané modelom: ty ich už poznáš, stačí mu ich poskytnúť. Nakoniec maj na pamäti, že API je v beta verzii a toto obmedzenie sa môže v budúcnosti vyvinúť – čo je tým väčší dôvod izolovať multi-agentnú časť svojho kódu za rozhranie, ktoré môžeš vyvíjať bez potreby prepisovať všetko odznova.
Kľúčové poznatky
- Volanie vlastných funkcií nie je podporované pri multi-agentoch
- Fungujú iba vstavané nástroje (web_search, x_search, code_execution, collections_search, Remote MCP)
- Na sprístupnenie vlastných API agentom použi Remote MCP
- Ak potrebuješ volanie funkcií, adoptuj dvojstupňovú architektúru
- Toto obmedzenie sa môže v budúcich verziách zmeniť (API je v beta verzii)