Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Otsingutööriist: dünaamilised tööriistad

Õppetund 15 / 20 Värskendatud 2. november 2026 Arendajatele
Sellel lehel
  1. Otsingutööriist: dünaamilised tööriistad
  2. Suurte tööriistakataloogide probleem
  3. Otsingutööriista lubamine
  4. Funktsioonikataloogi organiseerimine
  5. Parimad tavad kirjelduste koostamisel
  6. Otsingutööriista ja fikseeritud tööriistade kombineerimine
  7. Muster: mitme domeeniga süsteem
  8. Peamised punktid

Tund uuendatud 2. novembril 2026 vastavalt OpenAI dokumentatsioonile: Code Interpreteri tööriist nõuab nüüd parameetrit container (lisatud kõigile näidetele), sisendteksti osad on tüübitud kui input_text ja veebiotsing kasutab tööriista web_search (web_search_preview on nüüd aegunud tööriist ilma domeenifiltriteta). Genereeritud failid laaditakse alla, kasutades 10. tunnist pärit funktsioone fichiers_generes ja telecharger. Allikad: Code Interpreter · Veebiotsing.

Otsingutööriist: dünaamilised tööriistad

Kui sul on kümneid või sadu funktsioone, muutub nende kõigi iga väljakutse korral deklareerimine ebaotstarbekaks: mudel kaotab täpsuse ja kulud kasvavad plahvatuslikult. Otsingutööriist (Tool Search) lahendab selle probleemi, võimaldades mudelil otsida õiget tööriista indekseeritud kataloogist.

Suurte tööriistakataloogide probleem

Suure tööriistakataloogi kulud on kahel viisil nähtamatud. Esiteks rahaliselt: iga funktsiooni definitsioon saadetakse iga päringuga, kaasa arvatud need üheksakümmend kaheksa, mida ei kasutata. Suures mastaabis ületab see lõpuks vastuste endi maksumuse. Teiseks ja veel tõsisemalt, kvalitatiivselt: kui tööriistu on paarikümnest rohkem ja nende ulatus kattub, teeb mudel halvemaid valikuid. Liiga palju valikuid halvendab otsustusvõimet nii siin kui mujal.

# 5 funktsiooni = ~500 kontekstitokenit
# 50 funktsiooni = ~5000 kontekstitokenit
# 200 funktsiooni = võimatu tõhusalt hallata

# Mudel kaotab täpsuse, kui funktsioone on liiga palju
# See valib mõnikord vale funktsiooni või hallutsineerib parameetreid

Otsingutööriista lubamine

Otsingutööriist pöörab loogika ümber: selle asemel, et esitada mudelile kõike, indekseerid kataloogi ja näitad sellele ainult seda, mis vastab praegusele päringule. Mehhanism tugineb kirjelduste semantilisele otsingule – mistõttu järgmine jaotis pole lihtalt stiilinõuanne, vaid süsteemi toimimise eeldus.

from openai import OpenAI

client = OpenAI()

# Deklareeri suur hulk funktsioone
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"]}
    },
    # ... tosinad teisi funktsioone
]

# Kasuta otsingutööriista, et lasta mudelil leida õige funktsioon
response = client.responses.create(
    model="gpt-5.6-terra",
    input="Cancel invoice FAC-2026-0042",
    tools=[{
        "type": "tool_search",
        "tool_search": {
            "tools": all_functions
        }
    }]
)

Mudel saab oma konteksti ainult päringuga seotud funktsioonid, mitte kogu kataloogi.

Funktsioonikataloogi organiseerimine

Kataloogi struktureerimiseks, et see jääks navigeeritavaks, piisab kahest põhimõttest. Eesliida nimed domeeni järgi (crm_, billing_, inventory_): täitmise jälje lugemine muutub koheseks ja nimekonfliktid kaovad. Anna igale funktsioonile selge ulatus – kaks funktsiooni, mille kirjeldused kattuvad, tekitavad ebastabiilseid valikuid, olgu siis tegemist inimese või vektormootoriga.

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

# Ühenda kõik kataloogid
full_catalog = crm_catalog + billing_catalog

Parimad tavad kirjelduste koostamisel

Kirjuta kirjeldusi otsingu, mitte dokumentatsiooni jaoks. „Hangi kliendiandmed“ ei leia kunagi päringut „tellimuste ajalugu“ või „arvelduskontakti andmed“: sõnad, mida kasutajad tegelikult sisestavad, peavad ilmuma indekseeritud teksti. Kasulik kirjeldus toob välja kasutusjuhtumid ja ärisõnavara, mitte rakenduse üksikasjad.

# Halb: liiga üldine
{"name": "get_data", "description": "Retrieve data"}

# Hea: spetsiifiline koos kasutuskontekstiga
{
    "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."
}

# Hea: sünonüümidega otsingu parandamiseks
{
    "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."
}

Otsingutööriista ja fikseeritud tööriistade kombineerimine

Segakasutus on tootmises standardne töörežiim. Mõned üldised tööriistad – aeg, praegune kasutaja, dokumendiotsing – jäävad alati deklareerituks, kuna need teenindavad peaaegu iga päringut, samas kui ärikataloog jääb dünaamiliseks. See hoiab konteksti kergekaalulisena, sundimata mudelit iga kord otsima seda, mida ta vajab.

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 saadaval olevad tööriistad
        {"type": "web_search"},
        {"type": "code_interpreter", "container": {"type": "auto"}},
        # Dünaamiline kataloog
        {
            "type": "tool_search",
            "tool_search": {
                "tools": full_catalog  # 200+ funktsiooni
            }
        }
    ]
)

Muster: mitme domeeniga süsteem

class MultiDomainSystem:
    def __init__(self):
        self.client = OpenAI()
        self.catalogs = {}

    def register_domain(self, name: str, functions: list[dict]):
        """Registreeri funktsioonikataloog domeeni jaoks."""
        self.catalogs[name] = functions

    def full_catalog(self) -> list[dict]:
        """Ühenda kõik kataloogid."""
        result = []
        for functions in self.catalogs.values():
            result.extend(functions)
        return result

    def execute(self, query: str) -> str:
        """Teosta päring, kasutades otsingutööriista kõigis domeenides."""
        response = self.client.responses.create(
            model="gpt-5.6-terra",
            input=query,
            tools=[{
                "type": "tool_search",
                "tool_search": {
                    "tools": self.full_catalog()
                }
            }]
        )

        # Töötle funktsioonikutsed
        for item in response.output:
            if item.type == "function_call":
                result = self.dispatcher(item.name, item.arguments)
                # ... funktsioonikutsete tsükkel

        return response.output_text

    def dispatcher(self, name: str, arguments: str):
        """Suuna kutse õigele teenusele."""
        # Sinu marsruutimisloogika
        pass

# Kasutamine
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)

# Mudel leiab automaatselt õige funktsiooni
# sadade võimaluste hulgast
result = system.execute("How many vacation days does Marie Dupont have left?")

Peamised punktid

  • Otsingutööriist lahendab suurte funktsioonikataloogide probleemi
  • Mudel saab oma konteksti ainult asjakohased funktsioonid
  • Täpsuse jaoks on hädavajalikud rikkalikud ja spetsiifilised kirjeldused
  • Eesliida funktsiooninimed domeeniga loetavuse huvides
  • Kombineeri otsingutööriist alati saadaval olevate sisseehitatud tööriistadega