Pretraživanje alata: Dinamički alati
Na ovoj stranici
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 kaoinput_text, a web pretraživanje koristi alatweb_search(web_search_previewje sada zastarjeli alat bez filtara domene). Generirane datoteke dohvaćaju se pomoću funkcijafichiers_generesitelechargeriz 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