Aprašymas ir leidžiami įrankiai
Šiame puslapyje
Du pasirenkami svertai, du labai skirtingi poveikiai
URL ir etiketės pakanka ryšiui užmegzti, tačiau jos Grok nepaaiškina, kaip naudoti serverį. Šią spragą užpildo du pasirenkami parametrai, kurie vienas kitą papildo: server_description paaiškina, kam serveris skirtas, o allowed_tools (arba allowed_tool_names, priklausomai nuo SDK) nusprendžia, ko serveriui leidžiama liesti. Pirmasis nukreipia, antrasis – riboja.
server_description: suteik modeliui kontekstą
Šis parametras pateikia Grok natūralios kalbos serverio galimybių aprašymą. Modelis jį naudoja sprendimams priimti: ar kreiptis į šį serverį, į kitą, ar visai niekur?
mcp(
server_url="https://api.example.com/mcp",
server_label="docs",
server_description="Techninės dokumentacijos serveris. Leidžia ieškoti straipsnių, konsultuotis su gidais ir gauti kodų pavyzdžių vidinei API."
)
Be šio aprašymo Grok turi tik atskirų atvirų įrankių pavadinimus ir aprašymus. Tai veikia, tačiau modelis samprotauja nematydamas bendro vaizdo: jis mato įrankių rinkinį, bet nežino, ką jie kartu sudaro. Geras aprašymas suteikia tris dalykus, kurių joks įrankio pavadinimas perduoti negali: kada šis serveris yra aktualus, o ne kitas; kokio tipo užklausas į jį nukreipti; ir – dažnai pamirštama, bet lemiamai svarbu – ko serveris nedaro, taip išvengiant beviltiškų kvietimų.
Rašyk šį aprašymą taip, lyg aiškintum servisą kolegai, kuris tik prisijungia prie projekto. Būk konkretus: „Produkto techninės dokumentacijos duomenų bazė“ yra naudinga, tuo tarpu „Dokumentacija“ – ne. Įvardyk realiai įmanomus veiksmus, pavyzdžiui: „leidžia ieškoti, skaityti ir atnaujinti bilietus“. Jei taikymo sritis ribota, tai aiškiai nurodyk: „tik skaitymo prieiga, jokių pakeitimų“ – tai išgelbės modelį nuo nesėkmingo bandymo.
allowed_tools: susiaurink taikymo sritį
Pagal nutylėjimą, prijungus Grok prie MCP serverio, į modelio kontekstą įtraukiami visi to serverio atveriami įrankiai, be išimčių. CRM atveju tai reiškia, kad kontaktų kūrimas, keitimas ir trynimas yra tokie pat prieinami kaip ir paieška.
mcp(server_url="https://api.example.com/mcp",
server_label="crm")
# Grok mato VISUS įrankius: create_contact, update_contact,
# delete_contact, search_contacts, export_data ir kt.
Parametras allowed_tool_names šią elgseną apverčia, nustatydamas aiškų baltąjį sąrašą. Viskas, ko jame nėra, modeliui tampa nematoma.
mcp(server_url="https://api.example.com/mcp",
server_label="crm",
allowed_tool_names=["search_contacts", "get_contact_details"])
# Grok mato tik search_contacts ir get_contact_details
Kodėl verta riboti, net kai viskas veikia
Pirmoji priežastis – saugumas, grindžiamas mažiausių privilegijų principu. Jei tavo programai reikia tik skaityti, nepalik modifikavimo ar trynimo įrankių modelio pasiekiamume. Sėkmingas prompt injekcijos išpuolis – kenkėjiška instrukcija, įterpta į dokumentą, kurį analizuoja Grok – negalės suaktyvinti delete_contact, kuris niekada nebuvo atvertas. Baltasis sąrašas potencialų incidentą paverčia niekiu.
# Tik skaitymas viešam pokalbių botui
allowed_tool_names=["search_database", "get_record", "format_data"]
Antroji priežastis – našumas. Kiekvienas atvertas įrankis užima vietos konteksto lange, nes ten turi tilpti jo pavadinimas, aprašymas ir parametrų schema. MCP serveris, publikuojantis penkiasdešimt įrankių, suvartoja didelį kiekį vietos dar prieš tai, kai vartotojas užduoda klausimą. Sumažinus skaičių iki penkių tikrai naudingų įrankių, tą vietą grąžini tam, kas svarbiausia – pačiam pokalbiui.
Trečioji priežastis – tikslumas. Kuo platesnis katalogas, tuo labiau modelis dvejoja tarp panašių įrankių – o du įrankiai su panašiais aprašymais lemia nestabilų pasirinkimą nuo vieno vykdymo iki kito. Katalogas, sutelktas ties tavo naudojimo atveju, daro pasirinkimą žymiai patikimesnį.
Suderink abu parametrus
Rezultatas tampa tikrai švarus, kai derini abu parametrus, su sąlyga, kad jie pasakoja tą pačią istoriją.
mcp(
server_url="https://api.example.com/mcp",
server_label="crm",
server_description="Tik skaitymo CRM. Kontaktų ir įmonių paieška ir peržiūra.",
allowed_tool_names=["search_contacts", "get_contact", "search_companies", "get_company"]
)
Čia aprašymas skelbia tik skaitymo prieigą, o baltasis sąrašas tai techniškai užtikrina. Saugokis priešingos situacijos, kuri pasitaiko dažniau, nei manai: aprašymas, paveldėtas iš ankstesnės versijos, žada rašymo galimybes, kurios dabar pašalintos iš baltojo sąrašo. Modelis bandys įvykdyti kvietimą, nepavyks, o tu gaiši laiką ieškodamas klaidos, kurios iš tikrųjų nėra. Visada peržiūrėk šiuos du parametrus kartu, niekada atskirai.
Svarbiausi punktai
server_descriptionpadeda Grok suprasti, kada naudoti šį MCP serverį- Be
allowed_tools, visi serverio įrankiai įtraukiami į kontekstą - Įrankių ribojimas sustiprina saugumą, našumą ir tikslumą
- Derink aprašymą ir apribojimą optimaliai kontrolei
- Rašyk aprašymą kaip natūralios kalbos serverio galimybių paaiškinimą