Apraksts un atļautie rīki
Šajā lapā
Divi opcionāli sviras, divi ļoti atšķirīgi efekti
URL un etiķete ir pietiekami, lai izveidotu savienojumu, taču tie nepaskaidro Grok, kā lietot serveri. Divi opcionāli parametri aizpilda šo robu un viens otru papildina: server_description paskaidro, kam serveris paredzēts, savukārt allowed_tools (vai allowed_tool_names atkarībā no SDK) nosaka, kam tam ir atļauts pieskarties. Pirmais vada, otrais ierobežo.
server_description: piešķir modelim kontekstu
Šis parametrs nodrošina Grok servera iespēju aprakstu dabiskā valodā. Modelis to izmanto lēmumu pieņemšanai: vai tam jāvēršas pie šī servera, pie cita vai vispār neviena?
mcp(
server_url="https://api.example.com/mcp",
server_label="docs",
server_description="Tehniskās dokumentācijas serveris. Ļauj meklēt rakstus, konsultēt rokasgrāmatas un iegūt koda piemērus iekšējai API."
)
Bez šī apraksta Grok rīcībā ir tikai atsevišķu eksponēto rīku nosaukumi un apraksti. Tas strādā, taču modelis spriež bez kopainas: tas redz rīku kopumu, nezinot, ko tie veido kopumā. Labs apraksts dod tam trīs lietas, ko neviens rīka nosaukums nevar nodot: kad šis serveris ir aktuāls, nevis cits, kāda veida pieprasījumus uz to novirzīt un — bieži aizmirsts, bet bieži izšķirošs — ko serveris nedara, tādējādi izvairoties no lemtiem neveiksmei izsaukumiem.
Raksti šo aprakstu tā, it kā skaidrotu servisu kolēģim, kurš tikko pievienojies projektam. Esi konkrēts: „Produktu tehniskās dokumentācijas datubāze” ir noderīgi, turpretī „Dokumentācija” nav. Nosauc faktiski iespējamās darbības, piemēram, „ļauj meklēt, lasīt un atjaunināt biļetes”. Un, ja darbības joma ir ierobežota, norādi to skaidri: „tikai lasīšanas piekļuve, bez izmaiņām” pasargās modeli no neveiksmīga mēģinājuma.
allowed_tools: sašaurini darbības jomu
Pēc noklusējuma, savienojot Grok ar MCP serveri, modeļa kontekstā tiek ievadīti visi šī servera eksponētie rīki bez izņēmuma. CRM sistēmā tas nozīmē, ka kontaktu izveide, modificēšana un dzēšana ir tikpat pieejama kā meklēšana.
mcp(server_url="https://api.example.com/mcp",
server_label="crm")
# Grok redz VISUS rīkus: create_contact, update_contact,
# delete_contact, search_contacts, export_data utt.
Parametrs allowed_tool_names maina šo uzvedību, izveidojot skaidru balto sarakstu (whitelist). Viss, kas tajā nav iekļauts, modelim kļūst neredzams.
mcp(server_url="https://api.example.com/mcp",
server_label="crm",
allowed_tool_names=["search_contacts", "get_contact_details"])
# Grok redz tikai search_contacts un get_contact_details
Kāpēc ierobežot, pat ja viss strādā
Pirmais iemesls ir drošība, un tas seko minimālo privilēģiju principam. Ja tavai lietojumprogrammai nepieciešama tikai lasīšana, neatstāj modificēšanas vai dzēšanas rīkus modeļa sasniedzamībā. Veiksmīga uzvednes injicēšana (prompt injection) — ļaunprātīga instrukcija, ieslīdējusi dokumentā, ko Grok analizē — nevarēs izraisīt delete_contact, kas nekad netika eksponēts. Baltais saraksts pārvērš potenciālu incidentu par nenotikušu notikumu.
# Tikai lasīšanai publiskam čatbotam
allowed_tool_names=["search_database", "get_record", "format_data"]
Otrais iemesls ir veiktspēja. Katrs eksponētais rīks aizņem vietu konteksta logā, jo tajā jāievieto tā nosaukums, apraksts un parametru shēma. MCP serveris, kas publicē piecdesmit rīkus, patērē ievērojamu apjomu vēl pirms lietotājs ir uzdevis savu jautājumu. Samazinot skaitu līdz patiesi noderīgiem pieciem rīkiem, tu atgūsti šo vietu tam, kas ir svarīgi: pašai sarunai.
Trešais iemesls ir precizitāte. Jo plašāks ir katalogs, jo vairāk modelis šaubās starp līdzīgiem rīkiem — un divi rīki ar līdzīgiem aprakstiem rada nestabilu izvēli no vienas izpildes reizes uz nākamo. Katalogs, kas pielāgots tieši tavam lietojuma gadījumam, padara atlasi ievērojami uzticamāku.
Liec abiem strādāt kopā
Rezultāts kļūst patiešām tīrs, kad apvieno abus parametrus, ar nosacījumu, ka tie stāsta vienu un to pašu stāstu.
mcp(
server_url="https://api.example.com/mcp",
server_label="crm",
server_description="Tikai lasāms CRM. Meklē un apskati kontaktus un uzņēmumus.",
allowed_tool_names=["search_contacts", "get_contact", "search_companies", "get_company"]
)
Šeit apraksts paziņo par tikai lasīšanas piekļuvi, un baltais saraksts to tehniski garantē. Uzmanies no pretējās situācijas, kas notiek biežāk, nekā domā: apraksts, mantots no iepriekšējās versijas, kas sola rakstīšanas iespējas, kuras tagad ir izņemtas no baltā saraksta. Modelis mēģinās veikt izsaukumu, tas neizdosies, un tu tērēsi laiku, meklējot kļūdu, kuras nav. Vienmēr pārskati šos divus parametrus kopā, nekad atsevišķi.
Galvenās atziņas
server_descriptionpalīdz Grok saprast, kad izmantot šo MCP serveri- Bez
allowed_toolsvisi servera rīki tiek ievadīti kontekstā - Rīku ierobežošana stiprina drošību, veiktspēju un precizitāti
- Apvieno aprakstu un ierobežojumu optimālai kontrolei
- Raksti aprakstu kā servera iespēju skaidrojumu dabiskā valodā