Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Pretraživanje alata: Dinamički alati

Lekcija 15 od 20 Ažurirano 2. studenoga 2026. Programer
Na ovoj stranici
  1. Pretraživanje alata: Dinamički alati
  2. Problem s velikim katalozima alata
  3. Omogućavanje pretraživanja alata
  4. Organizacija kataloga funkcija
  5. Najbolje prakse za opise
  6. Kombiniranje pretraživanja alata s fiksnim alatima
  7. Uzorak: Sustav s više domena
  8. Ključne točke

Lekcija ažurirana 2. studenoga 2026. na temelju OpenAI dokumentacije: alat Code Interpreter sada zahtijeva parametar container (dodan svim primjerima), dijelovi ulaznog teksta tipizirani su kao input_text, a web pretraživanje koristi alat web_search (web_search_preview je sada zastarjeli alat bez filtara domene). Generirane datoteke dohvaćaju se pomoću funkcija fichiers_generes i telecharger iz Lekcije 10. Izvori: Code Interpreter · Web search.

Pretraživanje alata: Dinamički alati

Kada imaš desetke ili stotine funkcija, deklariranje svih njih u svakom pozivu postaje kontraproduktivno: model gubi preciznost, a troškovi eksplodiraju. Pretraživanje alata (Tool Search) rješava ovaj problem omogućujući modelu da pronađe pravi alat u indeksiranom katalogu.

Problem s velikim katalozima alata

Trošak velikog kataloga alata nevidljiv je na dva načina. Prvo, financijski: svaka definicija funkcije šalje se sa svakim zahtjevom, uključujući devedeset i osam koje se neće koristiti. U velikim razmjerima, to na kraju premašuje trošak samih odgovora. Drugo, i što je ozbiljnije, kvalitativno: s više od nekoliko desetaka alata s preklapajućim opsezima, model donosi lošije odluke. Previše opcija degradira donošenje odluka, ovdje kao i drugdje.

# 5 funkcija = ~500 tokena konteksta
# 50 funkcija = ~5000 tokena konteksta
# 200 funkcija = nemoguće učinkovito upravljati

# Model gubi preciznost kada ima previše funkcija
# Ponekad odabere pogrešnu funkciju ili halucinira parametre

Omogućavanje pretraživanja alata

Pretraživanje alata okreće logiku: umjesto da modelu prezentiraš sve, indeksiraš katalog i prikazuješ mu samo ono što odgovara trenutnom zahtjevu. Mehanizam se oslanja na semantičko pretraživanje opisa – zbog toga sljedeći odjeljak nije samo savjet o stilu; to je uvjet da bi sustav radio.

from openai import OpenAI

client = OpenAI()

# Deklariraj veliki broj funkcija
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"]}
    },
    # ... desetke drugih funkcija
]

# Koristi Tool Search kako bi model pronašao pravu funkciju
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 u svom kontekstu prima samo funkcije relevantne za zahtjev, a ne cijeli katalog.

Organizacija kataloga funkcija

Dva su principa dovoljna za strukturiranje kataloga koji ostaje pregledan. Prefiksiraj imena po domeni (crm_, billing_, inventory_): čitanje tragova izvršavanja postaje trenutno, a sukobi imena nestaju. I daj svakoj funkciji jasan opseg – dvije funkcije čiji se opisi preklapaju proizvest će nestabilne odabire, bez obzira na to donosi li odluku čovjek ili vektorski stroj.

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
    }
]

# Spoji sve kataloge
full_catalog = crm_catalog + billing_catalog

Najbolje prakse za opise

Piši opise za pretraživanje, a ne za dokumentaciju. „Dohvati podatke o kupcu“ nikada neće biti pronađeno upitom o „povijesti narudžbi“ ili „podacima za kontakt za naplatu“: riječi koje tvoji korisnici zapravo upisuju moraju se pojaviti u indeksiranom tekstu. Koristan opis imenuje slučajeve uporabe i poslovni rječnik, a ne detalje implementacije.

# Loše: preopćenito
{"name": "get_data", "description": "Retrieve data"}

# Dobro: specifično s kontekstom uporabe
{
    "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."
}

# Dobro: sa sinonimima za poboljšanje pretraživanja
{
    "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."
}

Kombiniranje pretraživanja alata s fiksnim alatima

Miješanje je standardni način rada u proizvodnji. Nekoliko alata koji se protežu kroz više područja – vrijeme, trenutni korisnik, pretraživanje dokumenata – ostaje trajno deklarirano jer služe gotovo svakom zahtjevu, dok poslovni katalog ostaje dinamičan. To održava kontekst laganim, a da model ne mora svaki put tražiti ono što mu treba.

response = client.responses.create(
    model="gpt-5.6-terra",
    input="Search the web for this month's sales and create the corresponding invoice",
    tools=[
        # Alati uvijek dostupni
        {"type": "web_search"},
        {"type": "code_interpreter", "container": {"type": "auto"}},
        # Dinamički katalog
        {
            "type": "tool_search",
            "tool_search": {
                "tools": full_catalog  # 200+ funkcija
            }
        }
    ]
)

Uzorak: Sustav s više domena

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()
                }
            }]
        )

        # Obrada poziva funkcija
        for item in response.output:
            if item.type == "function_call":
                result = self.dispatcher(item.name, item.arguments)
                # ... petlja pozivanja funkcija

        return response.output_text

    def dispatcher(self, name: str, arguments: str):
        """Route the call to the correct service."""
        # Tvoja logika usmjeravanja
        pass

# Uporaba
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 automatski pronalazi pravu funkciju
# među stotinama mogućnosti
result = system.execute("How many vacation days does Marie Dupont have left?")

Ključne točke

  • Pretraživanje alata rješava problem velikih kataloga funkcija
  • Model u svom kontekstu prima samo relevantne funkcije
  • Bogati, specifični opisi ključni su za preciznost
  • Prefiksiraj imena funkcija po domeni radi čitljivosti
  • Kombiniraj pretraživanje alata s ugrađenim alatima koji su uvijek dostupni