Tool Search: Għodod Dinamiċi
F'din il-paġna
Lezzjoni aġġornata fit-2 ta’ Novembru 2026 abbażi tad-dokumentazzjoni ta’ OpenAI: l-għodda Code Interpreter issa teħtieġ parametru
container(miżjud mal-eżempji kollha), il-partijiet tat-test tal-input huma ttajpjati bħalainput_text, u t-tiftix fuq il-web juża l-għoddaweb_search(web_search_previewissa hija għodda antika mingħajr filtri tad-dominju). Il-fajls iġġenerati jiġu rkuprati bl-użu tal-funzjonijietfichiers_generesutelechargermil-Lezzjoni 10. Sorsi: Code Interpreter · Web search.
Tool Search: Għodod Dinamiċi
Meta jkollok għexieren jew mijiet ta’ funzjonijiet, li tiddikjarahom kollha f’kull sejħa jsir kontraproduċenti: il-mudell jitlif il-preċiżjoni u l-ispejjeż jisplodu. Tool Search isolvi din il-problema billi jħalli lill-mudell ifittex l-għodda t-tajba f’katalogu indiċjat.
Il-Problema ma’ Katalogi Kbar ta’ Għodod
L-ispiża ta’ katalogu kbir ta’ għodod hija inviżibbli f’żewġ modi. L-ewwel, finanzjarjament: kull definizzjoni ta’ funzjoni tintbagħat ma’ kull talba, inklużi d-disgħa u t-tmenin li ma jintużawx. Fuq skala kbira, dan eventwalment jaqbeż l-ispiża tar-risposti nfushom. It-tieni, u aktar serjament, kwalitattivament: wara ftit għexieren ta’ għodod b’ambiti li jikkoinċidu, il-mudell jagħmel għażliet agħar. Għażliet wisq jiddeterjoraw it-teħid tad-deċiżjonijiet, hawnhekk kif ukoll f’kullimkien ieħor.
# 5 funzjonijiet = ~500 token tal-kuntest
# 50 funzjoni = ~5000 token tal-kuntest
# 200 funzjoni = impossibbli li jiġu ġestiti b'mod effiċjenti
# Il-mudell jitlif il-preċiżjoni meta jkun hemm wisq funzjonijiet
# Xi kultant jagħżel il-funzjoni ħażina jew jalluċina parametri
Kattiva Tool Search
Tool Search taqleb il-loġika: minflok tippreżenta kollox lill-mudell, inti tindizza l-katalogu u turih biss dak li jaqbel mat-talba attwali. Il-mekkaniżmu jiddependi fuq it-tiftix semantiku fuq id-deskrizzjonijiet—għalhekk it-taqsima li jmiss mhix biss parir dwar l-istil; hija rekwiżit biex is-sistema taħdem.
from openai import OpenAI
client = OpenAI()
# Iddikjara numru kbir ta' funzjonijiet
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"]}
},
# ... għexieren ta' funzjonijiet oħra
]
# Uża Tool Search biex iħalli lill-mudell isib il-funzjoni t-tajba
response = client.responses.create(
model="gpt-5.6-terra",
input="Cancel invoice FAC-2026-0042",
tools=[{
"type": "tool_search",
"tool_search": {
"tools": all_functions
}
}]
)
Il-mudell jirċievi fil-kuntest tiegħu biss il-funzjonijiet rilevanti għat-talba, mhux il-katalogu sħiħ.
Organizzazzjoni tal-Katalogu tal-Funzjonijiet
Żewġ prinċipji huma biżżejjed biex tistruttura katalogu li jibqa’ navigabbli. Poġġi prefiss lill-ismijiet skont id-dominju (crm_, billing_, inventory_): il-qari tat-traċċa ta’ eżekuzzjoni jsir immedjat, u l-kolliżjonijiet tal-ismijiet jisparixxu. U agħti kull funzjoni ambitu ċar—żewġ funzjonijiet li d-deskrizzjonijiet tagħhom jikkoinċidu se jipproduċu għażliet instabbli, kemm jekk bniedem jew magna vettorjali qed tagħmel is-sejħa.
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
}
]
# Għaqqad il-katalogi kollha
full_catalog = crm_catalog + billing_catalog
L-Aħjar Prattiki għad-Deskrizzjonijiet
Ikteb deskrizzjonijiet għat-tiftix, mhux għad-dokumentazzjoni. “Retrieve customer data” qatt ma tinstab minn mistoqsija dwar “order history” jew “billing contact details”: il-kliem li l-utenti tiegħek attwalment jiktbu jrid jidher fit-test indiċjat. Deskrizzjoni utli tsemmi każijiet ta’ użu u vokabolarju tan-negozju, mhux dettalji ta’ implimentazzjoni.
# Ħażin: wisq ġeneriku
{"name": "get_data", "description": "Retrieve data"}
# Tajjeb: speċifiku bil-kuntest tal-użu
{
"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."
}
# Tajjeb: b'sinonimi biex itejjeb it-tiftix
{
"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."
}
Tagħqid ta’ Tool Search ma’ Għodod Fissi
It-taħlit huwa l-modalità standard ta’ operazzjoni fil-produzzjoni. Ftit għodod trasversali—ħin, utent attwali, tiftix ta’ dokumenti—jibqgħu ddikjarati b’mod permanenti għax iservu kważi kull talba, filwaqt li l-katalogu tan-negozju jibqa’ dinamiku. Dan iżomm il-kuntest ħafif mingħajr ma jġiegħel lill-mudell ifittex kull darba dak li għandu bżonn.
response = client.responses.create(
model="gpt-5.6-terra",
input="Search the web for this month's sales and create the corresponding invoice",
tools=[
# Għodod disponibbli dejjem
{"type": "web_search"},
{"type": "code_interpreter", "container": {"type": "auto"}},
# Katalogu dinamiku
{
"type": "tool_search",
"tool_search": {
"tools": full_catalog # 200+ funzjoni
}
}
]
)
Mudell: Sistema Multi-Dominju
class MultiDomainSystem:
def __init__(self):
self.client = OpenAI()
self.catalogs = {}
def register_domain(self, name: str, functions: list[dict]):
"""Irreġistra katalogu ta' funzjonijiet għal dominju."""
self.catalogs[name] = functions
def full_catalog(self) -> list[dict]:
"""Għaqqad il-katalogi kollha."""
result = []
for functions in self.catalogs.values():
result.extend(functions)
return result
def execute(self, query: str) -> str:
"""Eżegwixxi mistoqsija b'Tool Search fuq id-dominji kollha."""
response = self.client.responses.create(
model="gpt-5.6-terra",
input=query,
tools=[{
"type": "tool_search",
"tool_search": {
"tools": self.full_catalog()
}
}]
)
# Ipproċessa s-sejħiet tal-funzjonijiet
for item in response.output:
if item.type == "function_call":
result = self.dispatcher(item.name, item.arguments)
# ... ċiklu tas-sejħa tal-funzjoni
return response.output_text
def dispatcher(self, name: str, arguments: str):
"""Idderieġi s-sejħa għas-servizz korrett."""
# Il-loġika tar-routing tiegħek
pass
# Użu
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)
# Il-mudell awtomatikament isib il-funzjoni t-tajba
# fost mijiet ta' possibbiltajiet
result = system.execute("How many vacation days does Marie Dupont have left?")
Punti Ewlenin
- Tool Search isolvi l-problema ta’ katalogi kbar ta’ funzjonijiet
- Il-mudell jirċievi fil-kuntest tiegħu biss il-funzjonijiet rilevanti
- Deskrizzjonijiet rikki u speċifiċi huma essenzjali għall-preċiżjoni
- Poġġi prefiss lill-ismijiet tal-funzjonijiet skont id-dominju għal-leġibbiltà
- Għaqqad Tool Search ma’ għodod integrati disponibbli dejjem