Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Tool Search: Għodod Dinamiċi

Lezzjoni 15 / 20 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Tool Search: Għodod Dinamiċi
  2. Il-Problema ma’ Katalogi Kbar ta’ Għodod
  3. Kattiva Tool Search
  4. Organizzazzjoni tal-Katalogu tal-Funzjonijiet
  5. L-Aħjar Prattiki għad-Deskrizzjonijiet
  6. Tagħqid ta’ Tool Search ma’ Għodod Fissi
  7. Mudell: Sistema Multi-Dominju
  8. Punti Ewlenin

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ħala input_text, u t-tiftix fuq il-web juża l-għodda web_search (web_search_preview issa hija għodda antika mingħajr filtri tad-dominju). Il-fajls iġġenerati jiġu rkuprati bl-użu tal-funzjonijiet fichiers_generes u telecharger mil-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

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