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

Tfittxija tal-Għodod: Għodod Dinamiċi

Lezzjoni 10 / 25 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Tfittxija tal-Għodod: Għodod Dinamiċi
  2. Il-Problema ta’ Għodod Wisq
  3. Kif Tattiva t-Tfittxija tal-Għodod
  4. Mudell: Għażla Manwali tal-Għodod
  5. Mudell: Għodod Dinamiċi Sensittivi għall-Kuntest
  6. Ottimizzazzjoni tad-Deskrizzjonijiet tal-Għodod
  7. Punti Ewlenin

Tfittxija tal-Għodod: Għodod Dinamiċi

Aġent demo jgħix tajjeb bi tlieta jew erba’ għodod biss. Madankollu, aġent intrapriżali jakkumula inevitabbilment għexieren, u xi kultant mijiet ta’ għodod: fatturazzjoni, riżorsi umani, CRM, dokumenti, skedar. F’dik l-iskala, li tibgħat il-katalgu sħiħ lill-mudell ma’ kull talba jsir ineffiċjenti u għali f’termini ta’ tokens. It-Tfittxija tal-Għodod (Tool Search) issolvi din il-problema billi tagħżel dinamikament l-għodod rilevanti għal kull talba.

Il-Problema ta’ Għodod Wisq

Immaġina aġent b’50 għodda. Fuq kull sejħa API, l-iskemi tal-50 għodda kollha jintbagħtu fil-prompt. Dan jikkonsma eluf ta’ tokens u jista’ jħawwad il-mudell: itwal tkun il-lista, aktar isiru simili d-deskrizzjonijiet, u aktar jibża’ l-mudell bejn għodod viċini. L-ispejjeż jogħlew filwaqt li l-preċiżjoni tonqos—l-agħar kombinazzjoni possibbli.

# Problema: wisq għodod
agent = Agent(
    name="Super Agent",
    instructions="Tista' tagħmel kollox.",
    tools=[tool_1, tool_2, tool_3, ... , tool_50],  # 50 għodda = ħafna tokens
)

Kif Tattiva t-Tfittxija tal-Għodod

It-Tfittxija tal-Għodod tuża indiċi semantiku biex tagħżel għodod rilevanti bbażati fuq it-talba. Tiddikjara l-għodod tiegħek bħas-soltu, iżda l-parametru tool_use_behavior="auto" jħalli lill-mudell jagħżel mill-katalgu minflok ma jitgħabba kollox minn qabel. Fl-eżempju hawn taħt, talba biex tibgħat tfakkira ta’ ħlas ma tattivax għodod tar-riżorsi umani, u viċi versa.

from agents import Agent, Runner, function_tool

# Iddefinixxi ħafna għodod
@function_tool
def create_invoice(client: str, amount: float) -> str:
    """Toħloq fattura għal klijent."""
    return f"Fattura maħluqa għal {client}: €{amount}"

@function_tool
def send_reminder(invoice_id: str) -> str:
    """Tibgħat tfakkira ta' ħlas għal fattura mhux imħallsa."""
    return f" Tfakkira mibgħuta għall-fattura {invoice_id}"

@function_tool
def generate_hr_report(month: str) -> str:
    """Tiġġenera rapport tar-riżorsi umani għal xahar partikolari."""
    return f"Rapport HR iġġenerat għal {month}"

@function_tool
def schedule_interview(candidate: str, date: str) -> str:
    """Tiskeda intervista tax-xogħol ma' kandidat."""
    return f"Intervista skedata ma' {candidate} fi {date}"

# Ħafna għodod oħra...

agent = Agent(
    name="Enterprise Agent",
    instructions="Timmaniġġja l-operazzjonijiet tal-kumpanija.",
    tools=[
        create_invoice,
        send_reminder,
        generate_hr_report,
        schedule_interview,
        # ... 50 għodda oħra
    ],
    tool_use_behavior="auto",  # Il-mudell jagħżel dinamikament
)

Mudell: Għażla Manwali tal-Għodod

Jekk trid kontroll totali fuq l-għażla tal-għodod, implimenta l-loġika tiegħek stess. Il-prinċipju huwa sempliċi: aġent router żgħir jaqra t-talba u sempliċiment isemmi d-dominju rilevanti. Imbagħad tibni l-aġent speċjalizzat fuq it-titjira bl-għodod biss għal dak id-dominju. Frażi bħal “ibgħat tfakkira għall-fattura F-2026-114” toħroġ mir-router bir-risposta accounting, u l-aġent ta’ eżekuzzjoni qatt ma jara l-għodod tal-HR.

from agents import Agent, Runner, function_tool

# Iggroupja l-għodod skont id-dominju
accounting_tools = [create_invoice, send_reminder]
hr_tools = [generate_hr_report, schedule_interview]

# Aġent router li jagħżel id-dominju
router = Agent(
    name="Router",
    instructions="""Iddetermina d-dominju tat-talba.
    Wieġeb biss b' 'accounting' jew 'hr'.""",
    model="gpt-5.6-terra",  # Mgħaġġel u rħis għar-routing
    output_type=str,
)

async def handle_request(message: str):
    # Pass 1: Iddetermina d-dominju
    route = await Runner.run(router, message)
    domain = route.final_output.strip().lower()

    # Pass 2: Oħloq l-aġent speċjalizzat bl-għodod it-tajba
    if domain == "accounting":
        tools = accounting_tools
        instructions = "Timmaniġġja l-kontabbiltà tal-kumpanija."
    elif domain == "hr":
        tools = hr_tools
        instructions = "Timmaniġġja r-riżorsi umani."
    else:
        tools = accounting_tools + hr_tools
        instructions = "Timmaniġġja l-operazzjonijiet tal-kumpanija."

    specialized_agent = Agent(
        name=f"{domain.capitalize()} Agent",
        instructions=instructions,
        tools=tools,
        model="gpt-5.6-terra",
    )

    result = await Runner.run(specialized_agent, message)
    return result.final_output

L-użu ta’ gpt-5.6-terra kemm għar-routing kif ukoll għall-eżekuzzjoni jappartjeni għall-ġenerazzjoni preċedenti ta’ mudelli; ir-raġunament wara dan il-mudell jibqa’ identiku mal-familja GPT-5.6, fejn is-settings tal-isforz jiddistingwu r-router mgħaġġel mill-eżekutur.

Mudell: Għodod Dinamiċi Sensittivi għall-Kuntest

L-għażla ma tiddependix biss fuq il-mistoqsija magħmula; tiddependi wkoll fuq min qed jistaqsi. Tista’ tadatta l-għodod disponibbli bbażat fuq l-utent li daħal, u hekk taqta’ żewġ għasafar b’ġebla waħda: inqas tokens mibgħuta, u, l-aktar importanti, kontrolli tal-aċċess infurzati qabel ma l-mudell saħansitra jirraġuna. Impjegat tal-bejgħ jikseb għodod ta’ kwotazzjoni, iżda delete_account sempliċiment ma teżistix fl-aġent tiegħu.

from dataclasses import dataclass

@dataclass
class UserContext:
    role: str  # "admin", "manager", "employee"
    department: str

def get_tools_for_role(ctx: UserContext) -> list:
    """Tirritorna għodod awtorizzati bbażati fuq ir-rwol."""
    base_tools = [search_document, view_schedule]

    if ctx.role in ("admin", "manager"):
        base_tools.extend([create_invoice, generate_hr_report])

    if ctx.role == "admin":
        base_tools.extend([modify_permissions, delete_account])

    if ctx.department == "sales":
        base_tools.extend([search_client, create_quote])

    return base_tools

async def create_agent_for_user(ctx: UserContext):
    tools = get_tools_for_role(ctx)
    return Agent(
        name="Custom Agent",
        instructions=f"Inti tgħin lil {ctx.role} fid-dipartiment tal-{ctx.department}.",
        tools=tools,
        model="gpt-5.6-terra",
    )

Ottimizzazzjoni tad-Deskrizzjonijiet tal-Għodod

Ikun xi jkun il-mekkaniżmu tal-għażla li tagħżel, dan jiddependi fuq materjal wieħed: it-test tad-deskrizzjonijiet tiegħek. Il-kwalità ta’ dawn id-deskrizzjonijiet taffettwa direttament ir-rilevanza tal-għażla. Qabbel iż-żewġ dikjarazzjonijiet hawn taħt: l-ewwel waħda ma tgħid xejn dwar ix-xenarju tal-użu, filwaqt li t-tieni waħda tsemmi l-inputs, l-output, u meta għandha tintuża.

# Ħażin: deskrizzjoni vaga
@function_tool
def process_data(data: str) -> str:
    """Tipproċessa d-data."""
    return "OK"

# Tajjeb: deskrizzjoni preċiża u kuntestwalizzata
@function_tool
def calculate_gross_margin(revenue: float, production_cost: float) -> str:
    """Tikkalkula l-marġni gross bħala perċentwal mid-dħul
    u l-ispiża tal-produzzjoni. Utli għall-analiżi finanzjarja trimestrali."""
    margin = ((revenue - production_cost) / revenue) * 100
    return f"Marġni gross: {margin:.1f}% (Dħul: €{revenue}, Spejjeż: €{production_cost})"

Deskrizzjoni tajba ta’ għodda hija bħal docstring tajba: tispjega meta għandha tintuża l-għodda, mhux biss x’tagħmel. Ħu għaxar minuti biex tirrevedi d-deskrizzjonijiet tal-aġent tiegħek, u staqsi lilek innifsek għal kull waħda jekk kollega setax jagħżel l-għodda t-tajba billi jaqra dik is-sentenza biss. Dak huwa eżattament l-eżerċizzju li l-mudell iwettaq.

Punti Ewlenin

  • It-Tfittxija tal-Għodod tagħżel dinamikament l-għodod rilevanti għal kull talba
  • B’ħafna għodod, aġent router jista’ jiddetermina d-dominju minn qabel
  • Adatta l-għodod disponibbli bbażat fuq ir-rwol u l-kuntest tal-utent
  • Il-kwalità tad-deskrizzjoni tal-għodda taffettwa l-preċiżjoni tal-għażla
  • Uża mudell ħafif għar-routing mgħaġġel u mudell kapaċi għall-eżekuzzjoni