Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Tool Search: Dynamické nástroje

Lekcia 15 z 20 Aktualizované 2. novembra 2026 Vývojár
Na tejto strane
  1. Tool Search: Dynamické nástroje
  2. Problém s veľkými katalógmi nástrojov
  3. Aktivácia Tool Search
  4. Organizácia katalógu funkcií
  5. Osvedčené postupy pre popisy
  6. Kombinovanie Tool Search s pevnými nástrojmi
  7. Vzorec: Systém s viacerými doménami
  8. Kľúčové poznatky

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é ako input_text a webové vyhľadávanie používa nástroj web_search (web_search_preview je teraz zastaraný nástroj bez filtrov domén). Vygenerované súbory sa získavajú pomocou funkcií fichiers_generes a telecharger z 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

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é