Премини към основното съдържание
Български— Изберете език
Меню

Описание и разрешени инструменти

Урок 5 от 12 Обновен 29 юли 2026 г. Програмист
На тази страница
  1. Два незадължителни лоста, два много различни ефекта
  2. server_description: предоставете контекст на модела
  3. allowed_tools: стеснете обхвата
  4. Защо да ограничавате, дори когато всичко работи
  5. накарайте двете да работят заедно
  6. Ключови изводи

Два незадължителни лоста, два много различни ефекта

URL адресът и етикетът са достатъчни, за да установите връзката, но те не казват на Grok как да използва сървъра. Два незадължителни параметъра запълват тази празнота и се допълват взаимно: server_description обяснява за какво служи сървърът, докато allowed_tools – или allowed_tool_names в зависимост от SDK – решава до какво му е позволено да се докосва. Първият насочва, вторият ограничава.

server_description: предоставете контекст на модела

Този параметър предоставя на Grok описание на естествен език за възможностите на сървъра. Моделът го използва, за да прецени: дали да заявки този сървър, друг или изобщо никой?

mcp(
    server_url="https://api.example.com/mcp",
    server_label="docs",
    server_description="Technical documentation server. Lets you search articles, consult guides, and get code examples for the internal API."
)

Без това описание Grok разполага само с индивидуалните имена и описания на изложените инструменти. Работи, но моделът разсъждава без цялостна картина: вижда колекция от инструменти, без да знае какво формират те колективно. Едно добро описание му дава три неща, които никое име на инструмент не може да предаде: кога този сървър е уместен, а не друг; какъв тип заявки да се насочват натам; и – често пренебрегвано, но често решаващо – какво сървърът не прави, което избягва обречени на провал повиквания.

Напишете това описание така, сякаш обяснявате услугата на колега, който се присъединява към проекта. Бъдете конкретни: „База данни с техническа документация за продукта“ е полезно, докато просто „Документация“ не е. Посочете действително възможните действия, като „позволява търсене, четене и актуализиране на тикети“. И ако обхватът е ограничен, го заявете ясно: „достъп само за четене, без модификации“ ще спести на модела опит, обречен на неуспех.

allowed_tools: стеснете обхвата

По подразбиране свързването на Grok към MCP сървър инжектира всички инструменти, които този сървър излага, в контекста на модела, без изключение. При CRM това означава, че създаването, модифицирането и изтриването на контакти са достъпни точно както търсенето.

mcp(server_url="https://api.example.com/mcp",
    server_label="crm")
# Grok вижда ВСИЧКИ инструменти: create_contact, update_contact,
# delete_contact, search_contacts, export_data и т.н.

Параметърът allowed_tool_names обръща това поведение, като установява изричен бял списък. Всичко, което не е в него, става невидимо за модела.

mcp(server_url="https://api.example.com/mcp",
    server_label="crm",
    allowed_tool_names=["search_contacts", "get_contact_details"])
# Grok вижда само search_contacts и get_contact_details

Защо да ограничавате, дори когато всичко работи

Първата причина е сигурността и тя следва принципа на най-малките привилегии. Ако вашето приложение има нужда само от четене, не оставяйте инструменти за модифициране или изтриване в обсега на модела. Успешна инжекция на подкана – злонамерена инструкция, промъкната в документ, анализиран от Grok – не може да задейства delete_contact, който никога не е бил изложен. Белият списък превръща потенциален инцидент в несъбитие.

# Само за четене за публичен чатбот
allowed_tool_names=["search_database", "get_record", "format_data"]

Втората причина е производителността. Всеки изложен инструмент заема място в прозореца на контекста, тъй като неговото име, описание и схема на параметрите трябва да се побират там. MCP сървър, публикуващ петдесет инструмента, консумира значителен обем, преди потребителят дори да е задал въпроса си. Като намалите броя до пет наистина полезни инструмента, си връщате това пространство за онова, което има значение: самия разговор.

Третата причина е прецизността. Колкото по-обширен е каталогът, толкова повече моделът се колебае между сходни инструменти – а два инструмента с подобни описания водят до нестабилни избори от едно изпълнение до друго. Каталог, стегнат около вашия случай на употреба, прави селекцията значително по-надеждна.

накарайте двете да работят заедно

Резултатът става наистина чист, когато комбинирате двата параметъра, при условие че разказват една и съща история.

mcp(
    server_url="https://api.example.com/mcp",
    server_label="crm",
    server_description="Read-only CRM. Search and view contacts and companies.",
    allowed_tool_names=["search_contacts", "get_contact", "search_companies", "get_company"]
)

Тук описанието обявява достъп само за четене, а белият списък го гарантира технически. Пазете се от обратната ситуация, която се случва по-често, отколкото си мислите: описание, наследено от предишна версия, което обещава възможности за запис, вече премахнати от белия списък. Моделът ще се опита да направи повикването, ще се провали и вие ще загубите време в търсене на бъг, който не съществува. Винаги преглеждайте тези два параметъра заедно, никога поотделно.

Ключови изводи

  • server_description помага на Grok да разбере кога да използва този MCP сървър
  • Без allowed_tools, всички инструменти на сървъра се инжектират в контекста
  • Ограничаването на инструментите засилва сигурността, производителността и прецизността
  • Комбинирайте описанието и ограничението за оптимален контрол
  • Напишете описанието като обяснение на естествен език за възможностите на сървъра