Tool Search: Dynamické nástroje
Na tejto strane
Lekcia aktualizovaná 2. novembra 2026 na základe dokumentácie OpenAI: nástroj Code Interpreter teraz vyžaduje parameter
container(pridaný do všetkých príkladov), vstupné textové časti sú typované akoinput_texta webové vyhľadávanie používa nástrojweb_search(web_search_previewje teraz zastaraný nástroj bez filtrov domén). Vygenerované súbory sa získavajú pomocou funkciífichiers_generesatelechargerz Lekcie 10. Zdroje: Code Interpreter · Web search.
Tool Search: Dynamické nástroje
Keď máš desiatky alebo stovky funkcií, ich deklarovanie pri každom volaní sa stáva kontraproduktívnym: model stráca presnosť a náklady explodujú. Tool Search rieši tento problém tým, že umožňuje modelu vyhľadať správny nástroj v indexovanom katalógu.
Problém s veľkými katalógmi nástrojov
Náklady na veľký katalóg nástrojov sú neviditeľné dvoma spôsobmi. Po prvé, finančne: každá definícia funkcie sa odosiela s každou požiadavkou, vrátane deväťdesiatich ôsmich, ktoré sa nepoužijú. Vo veľkom meradle to nakoniec presiahne náklady na samotné odpovede. Po druhé, a čo je vážnejšie, kvalitatívne: pri viac než niekoľkých desiatkach nástrojov s prekrývajúcimi sa oblasťami pôsobnosti robí model horšie rozhodnutia. Príliš veľa možností zhoršuje rozhodovanie, tu aj inde.
# 5 funkcií = ~500 kontextových tokenov
# 50 funkcií = ~5000 kontextových tokenov
# 200 funkcií = nemožné efektívne spravovať
# Model stráca presnosť, keď je príliš veľa funkcií
# Niekedy vyberie nesprávnu funkciu alebo halucinuje parametre
Aktivácia Tool Search
Tool Search obracia logiku: namiesto toho, aby si modelu predložil všetko, indexuješ katalóg a zobrazíš mu len to, čo zodpovedá aktuálnej požiadavke. Mechanizmus sa spolieha na sémantické vyhľadávanie v popisoch – preto nasledujúca časť nie je len radou ohľadom štýlu; je to podmienka fungovania systému.
from openai import OpenAI
client = OpenAI()
# Deklaruj veľké množstvo funkcií
all_functions = [
{
"type": "function",
"name": "create_invoice",
"description": "Create a new invoice for a customer",
"parameters": {"type": "object", "properties": {"client_id": {"type": "string"}}, "required": ["client_id"]}
},
{
"type": "function",
"name": "cancel_invoice",
"description": "Cancel an existing invoice",
"parameters": {"type": "object", "properties": {"invoice_id": {"type": "string"}}, "required": ["invoice_id"]}
},
# ... desiatky ďalších funkcií
]
# Použi Tool Search, aby model našiel správnu funkciu
response = client.responses.create(
model="gpt-5.6-terra",
input="Cancel invoice FAC-2026-0042",
tools=[{
"type": "tool_search",
"tool_search": {
"tools": all_functions
}
}]
)
Model dostane do svojho kontextu len funkcie relevantné pre požiadavku, nie celý katalóg.
Organizácia katalógu funkcií
Na štruktúrovanie katalógu, ktorý zostane prehľadný, stačia dva princípy. Prefixuj názvy podľa domény (crm_, billing_, inventory_): čítanie stopy vykonávania sa stane okamžitým a kolízie názvov zmiznú. A každej funkcii priraď jasný rozsah pôsobnosti – dve funkcie, ktorých popisy sa prekrývajú, budú produkovať nestabilné voľby, či už rozhoduje človek, alebo vektorový engine.
crm_catalog = [
{
"type": "function",
"name": "crm_search_customer",
"description": "Search for a customer in the CRM by name, email, or ID. "
"Use to find information about an existing customer.",
"parameters": {
"type": "object",
"properties": {
"term": {"type": "string", "description": "Search term"},
"field": {"type": "string", "enum": ["name", "email", "id"]}
},
"required": ["term"],
"additionalProperties": False
},
"strict": True
},
{
"type": "function",
"name": "crm_create_customer",
"description": "Create a new customer in the CRM. "
"Use when a customer does not yet exist.",
"parameters": {
"type": "object",
"properties": {
"name": {"type": "string"},
"email": {"type": "string"},
"company": {"type": "string"}
},
"required": ["name", "email", "company"],
"additionalProperties": False
},
"strict": True
}
]
billing_catalog = [
{
"type": "function",
"name": "bill_create_invoice",
"description": "Create an invoice. Requires an existing customer.",
"parameters": {
"type": "object",
"properties": {
"client_id": {"type": "string"},
"lines": {"type": "array", "items": {"type": "object", "properties": {
"description": {"type": "string"},
"amount": {"type": "number"}
}}}
},
"required": ["client_id", "lines"],
"additionalProperties": False
},
"strict": True
}
]
# Zlúč všetky katalógy
full_catalog = crm_catalog + billing_catalog
Osvedčené postupy pre popisy
Píš popisy pre vyhľadávanie, nie pre dokumentáciu. „Získať údaje o zákazníkovi“ sa nikdy nenájde pri dopyte týkajúcom sa „histórie objednávok“ alebo „kontaktných údajov na fakturáciu“: slová, ktoré tvoji používatelia skutočne zadávajú, sa musia objaviť v indexovanom texte. Užitočný popis vymenúva prípady použitia a obchodnú slovnú zásobu, nie implementačné detaily.
# Zlé: príliš všeobecné
{"name": "get_data", "description": "Retrieve data"}
# Dobré: špecifické s kontextom použitia
{
"name": "hr_check_leave_balance",
"description": "Check an employee's leave balance (vacation, personal time, sick leave). "
"Returns remaining days by leave type. "
"Use when an employee asks how many days they have left."
}
# Dobré: so synonymami na zlepšenie vyhľadávania
{
"name": "acct_reconcile_bank",
"description": "Bank reconciliation: compare accounting entries "
"with bank transactions. Account reconciliation. "
"Use to verify consistency between accounting records "
"and bank statements."
}
Kombinovanie Tool Search s pevnými nástrojmi
Mixovanie je štandardným režimom prevádzky v produkčnom prostredí. Niekoľko prierezových nástrojov – čas, aktuálny používateľ, vyhľadávanie dokumentov – zostáva deklarovaných natrvalo, pretože slúžia takmer každej požiadavke, zatiaľ čo obchodný katalóg zostáva dynamický. To udržuje kontext ľahký bez toho, aby model musel zakaždým hľadať to, čo potrebuje.
response = client.responses.create(
model="gpt-5.6-terra",
input="Search the web for this month's sales and create the corresponding invoice",
tools=[
# Nástroje vždy dostupné
{"type": "web_search"},
{"type": "code_interpreter", "container": {"type": "auto"}},
# Dynamický katalóg
{
"type": "tool_search",
"tool_search": {
"tools": full_catalog # 200+ funkcií
}
}
]
)
Vzorec: Systém s viacerými doménami
class MultiDomainSystem:
def __init__(self):
self.client = OpenAI()
self.catalogs = {}
def register_domain(self, name: str, functions: list[dict]):
"""Register a function catalog for a domain."""
self.catalogs[name] = functions
def full_catalog(self) -> list[dict]:
"""Merge all catalogs."""
result = []
for functions in self.catalogs.values():
result.extend(functions)
return result
def execute(self, query: str) -> str:
"""Execute a query with Tool Search across all domains."""
response = self.client.responses.create(
model="gpt-5.6-terra",
input=query,
tools=[{
"type": "tool_search",
"tool_search": {
"tools": self.full_catalog()
}
}]
)
# Spracuj volania funkcií
for item in response.output:
if item.type == "function_call":
result = self.dispatcher(item.name, item.arguments)
# ... slučka volania funkcií
return response.output_text
def dispatcher(self, name: str, arguments: str):
"""Route the call to the correct service."""
# Tvoja logika smerovania
pass
# Použitie
system = MultiDomainSystem()
system.register_domain("crm", crm_catalog)
system.register_domain("billing", billing_catalog)
system.register_domain("hr", hr_catalog)
system.register_domain("support", support_catalog)
# Model automaticky nájde správnu funkciu
# medzi stovkami možností
result = system.execute("How many vacation days does Marie Dupont have left?")
Kľúčové poznatky
- Tool Search rieši problém veľkých katalógov funkcií
- Model dostáva do kontextu len relevantné funkcie
- Bohaté a špecifické popisy sú nevyhnutné pre presnosť
- Prefixuj názvy funkcií podľa domény pre čitateľnosť
- Kombinuj Tool Search so vstavanými nástrojmi, ktoré sú vždy dostupné