Търсене на инструменти: Динамични инструменти
На тази страница
- Търсене на инструменти: Динамични инструменти
- Проблемът с големите каталози с инструменти
- Активиране на търсенето на инструменти
- Организиране на каталога с функции
- Най-добри практики за описанията
- Комбиниране на търсенето на инструменти с фиксирани инструменти
- Шаблон: Система с множество домейни
- Ключови изводи
Урокът е актуализиран на 2 ноември 2026 г. въз основа на документацията на OpenAI: инструментът Code Interpreter вече изисква параметър
container(добавен към всички примери), текстовите части за вход са типизирани катоinput_text, а уеб търсенето използва инструментаweb_search(web_search_previewвече е остарял инструмент без филтри за домейни). Генерираните файлове се извличат чрез функциитеfichiers_generesиtelechargerот Урок 10. Източници: Code Interpreter · Уеб търсене.
Търсене на инструменти: Динамични инструменти
Когато разполагате с десетки или стотици функции, декларирането на всички тях при всяко извикване става контрапродуктивно: моделът губи прецизност, а разходите експлодират. Търсенето на инструменти (Tool Search) решава този проблем, като позволява на модела да търси правилния инструмент в индексиран каталог.
Проблемът с големите каталози с инструменти
Цената на големия каталог с инструменти е невидима по два начина. Първо, финансово: всяка дефиниция на функция се изпраща с всяка заявка, включително деветдесет и осемте, които няма да бъдат използвани. В мащаб това в крайна сметка надвишава цената на самите отговори. Второ, и по-сериозно, качествено: отвъд няколко десетки инструмента с припокриващи се обхвати, моделът прави по-лош избор. Твърде много опции влошават вземането на решения, тук както и навсякъде другаде.
# 5 функции = ~500 токена в контекста
# 50 функции = ~5000 токена в контекста
# 200 функции = невъзможно за ефективно управление
# Моделът губи прецизност, когато има твърде много функции
# Понякога избира грешната функция или халюцинира параметри
Активиране на търсенето на инструменти
Търсенето на инструменти обръща логиката: вместо да представяте всичко на модела, вие индексирате каталога и му показвате само онова, което съответства на текущата заявка. Механизмът разчита на семантично търсене в описанията – затова следващият раздел не е просто съвет за стил, а изискване системата да работи.
from openai import OpenAI
client = OpenAI()
# Декларирайте голям брой функции
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"]}
},
# ... десетки други функции
]
# Използвайте Tool Search, за да позволите на модела да намери правилната функция
response = client.responses.create(
model="gpt-5.6-terra",
input="Cancel invoice FAC-2026-0042",
tools=[{
"type": "tool_search",
"tool_search": {
"tools": all_functions
}
}]
)
Моделът получава в контекста си само функциите, които са релевантни за заявката, а не целия каталог.
Организиране на каталога с функции
Два принципа са достатъчни, за да структурирате каталог, който остава навигируем. Префиксирайте имената по домейн (crm_, billing_, inventory_): четенето на проследяването на изпълнението става незабавно, а сблъсъците на имена изчезват. Освен това дайте на всяка функция ясен обхват – две функции, чиито описания се припокриват, ще доведат до нестабилен избор, независимо дали човек или векторен двигател прави извикването.
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
}
]
# Обединете всички каталози
full_catalog = crm_catalog + billing_catalog
Най-добри практики за описанията
Пишете описания за търсене, а не за документация. „Извличане на данни за клиент“ никога няма да бъде намерено чрез заявка за „история на поръчките“ или „данни за контакт за фактуриране“: думите, които потребителите Ви действително въвеждат, трябва да присъстват в индексирания текст. Едно полезно описание назовава случаите на употреба и бизнес терминологията, а не детайлите на реализацията.
# Лошо: твърде общо
{"name": "get_data", "description": "Retrieve data"}
# Добро: конкретно с контекст на употреба
{
"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."
}
# Добро: със синоними за подобряване на търсенето
{
"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."
}
Комбиниране на търсенето на инструменти с фиксирани инструменти
Смесването е стандартният режим на работа в продукционна среда. Няколко сквозни инструмента – време, текущ потребител, търсене на документи – остават декларирани постоянно, защото служат почти на всяка заявка, докато бизнес каталогът остава динамичен. Това поддържа контекста лек, без да кара модела да търси всеки път онова, от което има нужда.
response = client.responses.create(
model="gpt-5.6-terra",
input="Search the web for this month's sales and create the corresponding invoice",
tools=[
# Винаги налични инструменти
{"type": "web_search"},
{"type": "code_interpreter", "container": {"type": "auto"}},
# Динамичен каталог
{
"type": "tool_search",
"tool_search": {
"tools": full_catalog # 200+ функции
}
}
]
)
Шаблон: Система с множество домейни
class MultiDomainSystem:
def __init__(self):
self.client = OpenAI()
self.catalogs = {}
def register_domain(self, name: str, functions: list[dict]):
"""Register a function catalog for a domain."""
self.catalogs[name] = functions
def full_catalog(self) -> list[dict]:
"""Merge all catalogs."""
result = []
for functions in self.catalogs.values():
result.extend(functions)
return result
def execute(self, query: str) -> str:
"""Execute a query with Tool Search across all domains."""
response = self.client.responses.create(
model="gpt-5.6-terra",
input=query,
tools=[{
"type": "tool_search",
"tool_search": {
"tools": self.full_catalog()
}
}]
)
# Process function calls
for item in response.output:
if item.type == "function_call":
result = self.dispatcher(item.name, item.arguments)
# ... function calling loop
return response.output_text
def dispatcher(self, name: str, arguments: str):
"""Route the call to the correct service."""
# Your routing logic
pass
# Usage
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)
# The model automatically finds the right function
# among hundreds of possibilities
result = system.execute("How many vacation days does Marie Dupont have left?")
Ключови изводи
- Търсенето на инструменти решава проблема с големите каталози с функции
- Моделът получава в контекста си само релевантните функции
- Богатите и конкретни описания са от съществено значение за прецизността
- Префиксирайте имената на функциите по домейн за по-добра четимост
- Комбинирайте търсенето на инструменти с винаги наличните вградени инструменти