Otsingutööriist: dünaamilised tööriistad
Sellel lehel
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 kuiinput_textja veebiotsing kasutab tööriistaweb_search(web_search_previewon nüüd aegunud tööriist ilma domeenifiltriteta). Genereeritud failid laaditakse alla, kasutades 10. tunnist pärit funktsioonefichiers_generesjatelecharger. 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