Vyhľadávanie nástrojov: Dynamické nástroje
Na tejto strane
Vyhľadávanie nástrojov: Dynamické nástroje
Demonstračný agent si bez problémov vystačí s tromi či štyrmi nástrojmi. Podnikový agent však nevyhnutne nahromadí desiatky, niekedy aj stovky nástrojov: fakturácia, ľudské zdroje, CRM, dokumenty, plánovanie. Pri takomto rozsahu sa odosielanie celého katalógu modelu s každou požiadavkou stáva neefektívnym a drahým z hľadiska tokenov. Vyhľadávanie nástrojov (Tool Search) rieši tento problém dynamickým výberom relevantných nástrojov pre každú požiadavku.
Problém s príliš veľkým množstvom nástrojov
Predstav si agenta s 50 nástrojmi. Pri každom volaní API sa do promptu odosielajú schémy všetkých 50 nástrojov. To spotrebuje tisíce tokenov a môže model zmiasť: čím dlhší je zoznam, tým viac sa popisy podobajú a tým viac model váha medzi susednými nástrojmi. Náklady rastú, zatiaľ čo presnosť klesá – čo je najhoršia možná kombinácia.
# Problém: príliš veľa nástrojov
agent = Agent(
name="Super Agent",
instructions="Môžeš robiť čokoľvek.",
tools=[tool_1, tool_2, tool_3, ... , tool_50], # 50 nástrojov = veľa tokenov
)
Aktivácia vyhľadávania nástrojov
Vyhľadávanie nástrojov využíva sémantický index na výber relevantných nástrojov na základe požiadavky. Nástroje definuješ ako obvykle, ale parameter tool_use_behavior="auto" umožní modelu vybrať si z katalógu namiesto toho, aby sa všetko načítalo vopred. V nižšie uvedenom príklade požiadavka na odoslanie pripomienky k platbe nespustí nástroje pre ľudské zdroje a naopak.
from agents import Agent, Runner, function_tool
# Definícia mnohých nástrojov
@function_tool
def create_invoice(client: str, amount: float) -> str:
"""Vytvorí faktúru pre klienta."""
return f"Faktúra vytvorená pre {client}: €{amount}"
@function_tool
def send_reminder(invoice_id: str) -> str:
"""Odošle pripomienku k platbe za neuhradenú faktúru."""
return f"Pripomienka odoslaná pre faktúru {invoice_id}"
@function_tool
def generate_hr_report(month: str) -> str:
"""Vygeneruje report ľudských zdrojov pre daný mesiac."""
return f"HR report vygenerovaný pre {month}"
@function_tool
def schedule_interview(candidate: str, date: str) -> str:
"""Naplánuje pracovný pohovor s kandidátom."""
return f"Pohovor naplánovaný s {candidate} dňa {date}"
# Mnoho ďalších nástrojov...
agent = Agent(
name="Podnikový agent",
instructions="Spravuješ chod spoločnosti.",
tools=[
create_invoice,
send_reminder,
generate_hr_report,
schedule_interview,
# ... 50 ďalších nástrojov
],
tool_use_behavior="auto", # Model vyberá dynamicky
)
Vzorec: Ručný výber nástrojov
Ak chceš mať nad výberom nástrojov úplnú kontrolu, implementuj vlastnú logiku. Princíp je jednoduchý: malý smerovací agent (router) prečíta požiadavku a jednoducho nazve relevantnú doménu. Následne zostavíš špecializovaného agenta za behu iba s nástrojmi pre túto doménu. Veta ako „odošli pripomienku pre faktúru F-2026-114“ vyjde zo smerovača s odpoveďou accounting a vykonávací agent nikdy neuvidí nástroje pre ľudské zdroje.
from agents import Agent, Runner, function_tool
# Zoskupenie nástrojov podľa domény
accounting_tools = [create_invoice, send_reminder]
hr_tools = [generate_hr_report, schedule_interview]
# Smerovací agent, ktorý vyberá doménu
router = Agent(
name="Smerovač",
instructions="""Urči doménu požiadavky.
Odpovedz iba 'accounting' alebo 'hr'.""",
model="gpt-5.6-terra", # Rýchly a lacný na smerovanie
output_type=str,
)
async def handle_request(message: str):
# Krok 1: Určenie domény
route = await Runner.run(router, message)
domain = route.final_output.strip().lower()
# Krok 2: Vytvorenie špecializovaného agenta so správnymi nástrojmi
if domain == "accounting":
tools = accounting_tools
instructions = "Spravuješ účtovníctvo spoločnosti."
elif domain == "hr":
tools = hr_tools
instructions = "Spravuješ ľudské zdroje."
else:
tools = accounting_tools + hr_tools
instructions = "Spravuješ chod spoločnosti."
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
Použitie modelu gpt-5.6-terra tak na smerovanie, ako aj na vykonávanie patrí do predchádzajúcej generácie modelov; logika tohto vzorca zostáva identická aj pri rodine GPT-5.6, kde nastavenia úsilia odlišujú rýchly smerovač od vykonávateľa.
Vzorec: Dynamické nástroje citlivé na kontext
Výber nezávisí len od položenej otázky, ale aj od toho, kto sa pýta. Dostupné nástroje môžeš prispôsobiť podľa prihláseného používateľa, čím zabiješ dve muchy jednou ranou: odošle sa menej tokenov a čo je dôležitejšie, kontroly prístupu sa vynútia ešte predtým, než model začne uvažovať. Zamestnanec v predaji dostane nástroje na tvorbu ponúk, ale delete_account v jeho agentovi jednoducho neexistuje.
from dataclasses import dataclass
@dataclass
class UserContext:
role: str # "admin", "manager", "employee"
department: str
def get_tools_for_role(ctx: UserContext) -> list:
"""Vráti autorizované nástroje na základe role."""
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="Vlastný agent",
instructions=f"Pomáhaš {ctx.role} na oddelení {ctx.department}.",
tools=tools,
model="gpt-5.6-terra",
)
Optimalizácia popisov nástrojov
Bez ohľadu na to, aký mechanizmus výberu zvolíš, spolieha sa na jediný materiál: text tvojich popisov. Kvalita týchto popisov priamo ovplyvňuje relevantnosť výberu. Porovnaj dve nižšie uvedené deklarácie: prvá nehovorí nič o scenári použitia, zatiaľ čo druhá menuje vstupy, výstup a kedy ju použiť.
# Zlé: vágny popis
@function_tool
def process_data(data: str) -> str:
"""Spracúva dáta."""
return "OK"
# Dobré: presný a kontextualizovaný popis
@function_tool
def calculate_gross_margin(revenue: float, production_cost: float) -> str:
"""Vypočíta hrubú maržu v percentách z tržieb
a výrobných nákladov. Užitočné pre štvrťročnú finančnú analýzu."""
margin = ((revenue - production_cost) / revenue) * 100
return f"Hrubá marža: {margin:.1f}% (Tržby: €{revenue}, Náklady: €{production_cost})"
Dobrý popis nástroja je ako dobrý docstring: vysvetľuje, kedy nástroj použiť, nielen čo robí. Venuj desať minút revízii popisov svojho agenta a pri každom sa opýtaj, či by kolega dokázal vybrať správny nástroj len na základe prečítania tejto vety. Presne túto úlohu vykonáva model.
Kľúčové poznatky
- Vyhľadávanie nástrojov dynamicky vyberá relevantné nástroje pre každú požiadavku
- Pri veľkom množstve nástrojov môže smerovací agent vopred určiť doménu
- Prispôsob dostupné nástroje na základe role a kontextu používateľa
- Kvalita popisu nástroja ovplyvňuje presnosť výberu
- Na rýchle smerovanie používaj ľahký model a na vykonávanie výkonný model